javax.media.protocol
Interface SourceCloneable

public interface SourceCloneable

An interface that a DataSource should implement if it needs to be cloneable. To create a cloneable DataSource, use Manager.createCloneableDataSource.

Since:

JMF 2.0

See Also:

DataSource, PushDataSource, PullDataSource, PushBufferDataSource, PullBufferDataSource, Manager.createCloneableDataSource(javax.media.protocol.DataSource)

Method Summary

DataSource

createClone() Create a clone of the original DataSource that provides a copy of the same data streams.

Method Detail

createClone

public DataSource createClone()

Create a clone of the original DataSource that provides a copy of the same data streams. The clones generated may or may not have the same properties of the original DataSource depending on the implementation. Therefore, they should be checked against the properties required for the application.
For example, the original DataSource may be a "pull" DataSource (PullDataSource or PullBufferDataSource). But the resulted clone may be the equivalent "push" DataSource. In that case, the resulting "push" DataSource will push data at the same rate at which the original DataSource is being pulled.

Returns:

a clone of the DataSource, or null if a clone could not be created.