org.jitsi.impl.neomedia.protocol

Class TranscodingDataSource

java.lang.Object

javax.media.protocol.DataSource

org.jitsi.impl.neomedia.protocol.TranscodingDataSource

All Implemented Interfaces:

javax.media.Controls, javax.media.Duration

public class TranscodingDataSource
extends javax.media.protocol.DataSource

Represents a DataSource which transcodes the tracks of a specific input DataSource into a specific output Format. The transcoding is attempted only for tracks which actually support it for the specified output Format.

Author:

Lubomir Marinov

Field Summary

Fields inherited from interface javax.media.Duration

DURATION_UNBOUNDED, DURATION_UNKNOWN

Constructor Summary

Constructors

Constructor and Description
TranscodingDataSource(javax.media.protocol.DataSource inputDataSource, javax.media.Format outputFormat) Initializes a new TranscodingDataSource instance to transcode the tracks of a specific DataSource into a specific output Format.

Method Summary

Modifier and Type	Method and Description
void	connect() Implements DataSource.connect().
void	disconnect() Implements DataSource.disconnect().
String	getContentType() Implements DataSource.getContentType().
Object	getControl(String controlType) Implements Controls.getControl(String).
Object[]	getControls() Implements Controls.getControls().
javax.media.Time	getDuration() Implements Duration.getDuration().
javax.media.protocol.SourceStream[]	getStreams() Gets the output streams that this instance provides.
javax.media.Processor	getTranscodingProcessor() Returns this instance's Processor object
void	start() Implements DataSource.start().
void	stop() Implements DataSource.stop().

Methods inherited from class javax.media.protocol.DataSource

getLocator, initCheck, setLocator

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TranscodingDataSource

public TranscodingDataSource(javax.media.protocol.DataSource inputDataSource,
                             javax.media.Format outputFormat)

Initializes a new TranscodingDataSource instance to transcode the tracks of a specific DataSource into a specific output Format.

Parameters:

inputDataSource - the DataSource which is to have its tracks transcoded in a specific output Format

outputFormat - the Format in which the new instance is to transcode the tracks of inputDataSource

Method Detail

connect

public void connect()
             throws IOException

Implements DataSource.connect(). Sets up the very transcoding process and just does not start it i.e. creates a Processor on the inputDataSource, sets outputFormat on its tracks (which support a Format compatible with outputFormat) and connects to its output DataSource.

Specified by:

connect in class javax.media.protocol.DataSource

Throws:

IOException - if creating the transcoding Processor, setting its Format or connecting to it fails

disconnect

public void disconnect()

Implements DataSource.disconnect(). Stops and undoes the whole setup of the very transcoding process i.e. disconnects from the output DataSource of the transcodingProcessor and disposes of the transcodingProcessor.

Specified by:

disconnect in class javax.media.protocol.DataSource

getContentType

public String getContentType()

Implements DataSource.getContentType(). Delegates to the actual output of the transcoding.

Specified by:

getContentType in class javax.media.protocol.DataSource

Returns:

a String value which describes the type of the content made available by this DataSource

getControl

public Object getControl(String controlType)

Implements Controls.getControl(String). Delegates to the actual output of the transcoding.

Parameters:

controlType - a String value which names the type of the control to be retrieved

Returns:

an Object which represents the control of this instance with the specified type if such a control is available; otherwise, null

getControls

public Object[] getControls()

Implements Controls.getControls(). Delegates to the actual output of the transcoding.

Returns:

an array of Objects which represent the controls available for this instance

getDuration

public javax.media.Time getDuration()

Implements Duration.getDuration(). Delegates to the actual output of the transcoding.

Returns:

a Time value which describes the duration of the content made available by this instance

getStreams

public javax.media.protocol.SourceStream[] getStreams()

Gets the output streams that this instance provides. Some of them may be the result of transcoding the tracks of the input DataSource of this instance in the output Format of this instance.

Returns:

an array of SourceStreams which represents the collection of output streams that this instance provides

start

public void start()
           throws IOException

Implements DataSource.start(). Starts the actual transcoding process already set up with connect().

Specified by:

start in class javax.media.protocol.DataSource

Throws:

IOException - if starting the transcoding fails

stop

public void stop()
          throws IOException

Implements DataSource.stop(). Stops the actual transcoding process if it has already been set up with connect().

Specified by:

stop in class javax.media.protocol.DataSource

Throws:

IOException - if stopping the transcoding fails

getTranscodingProcessor

public javax.media.Processor getTranscodingProcessor()

Returns this instance's Processor object

Returns:

this instance's Processor object