com.otaliastudios.transcoder.source

Class DataSourceWrapper

java.lang.Object

com.otaliastudios.transcoder.source.DataSourceWrapper

All Implemented Interfaces:

DataSource

Direct Known Subclasses:

ClipDataSource, TrimDataSource

public class DataSourceWrapper
extends java.lang.Object
implements DataSource

A DataSource wrapper that simply delegates all methods to the wrapped source.

Nested Class Summary

Nested classes/interfaces inherited from interface com.otaliastudios.transcoder.source.DataSource

DataSource.Chunk

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DataSourceWrapper(DataSource source)

Method Summary

Modifier and Type	Method and Description
boolean	canReadTrack(TrackType type) Returns true if we can read the given track at this point.
long	getDurationUs() Returns the video total duration in microseconds.
double[]	getLocation() Metadata information.
int	getOrientation() Metadata information.
long	getReadUs() Returns the total number of microseconds that have been read until now.
protected DataSource	getSource()
android.media.MediaFormat	getTrackFormat(TrackType type) Called before starting to inspect the input format for this track.
boolean	isDrained() When this source has been totally read, it can return true here to notify an end of input stream.
void	readTrack(DataSource.Chunk chunk) Called to read contents for the current track type.
void	releaseTrack(TrackType type) Called to release resources for a given track.
void	rewind() Rewinds this source, moving it to its default state.
long	seekTo(long desiredTimestampUs) Moves all selected tracks to the specified presentation time.
void	selectTrack(TrackType type) Called before starting, but after DataSource.getTrackFormat(TrackType), to select the given track.

Methods inherited from class java.lang.Object

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

Constructor Detail

DataSourceWrapper

protected DataSourceWrapper(@NonNull
                            DataSource source)

Method Detail

getSource

@NonNull
protected DataSource getSource()

getOrientation

public int getOrientation()

Description copied from interface: DataSource

Metadata information. Returns the video orientation, or 0.

Specified by:

getOrientation in interface DataSource

Returns:

video metadata orientation

getLocation

@Nullable
public double[] getLocation()

Description copied from interface: DataSource

Metadata information. Returns the video location, or null.

Specified by:

getLocation in interface DataSource

Returns:

video location or null

getDurationUs

public long getDurationUs()

Description copied from interface: DataSource

Returns the video total duration in microseconds.

Specified by:

getDurationUs in interface DataSource

Returns:

duration in us

getTrackFormat

@Nullable
public android.media.MediaFormat getTrackFormat(@NonNull
                                                          TrackType type)

Description copied from interface: DataSource

Called before starting to inspect the input format for this track. Can return null if this media does not include this track type.

Specified by:

getTrackFormat in interface DataSource

Parameters:

type - track type

Returns:

format or null

selectTrack

public void selectTrack(@NonNull
                        TrackType type)

Description copied from interface: DataSource

Called before starting, but after DataSource.getTrackFormat(TrackType), to select the given track.

Specified by:

selectTrack in interface DataSource

Parameters:

type - track type

seekTo

public long seekTo(long desiredTimestampUs)

Description copied from interface: DataSource

Moves all selected tracks to the specified presentation time. The timestamp should be between 0 and DataSource.getDurationUs(). The actual timestamp might differ from the desired one because of seeking constraints (e.g. seek to sync frames).

Specified by:

seekTo in interface DataSource

Parameters:

desiredTimestampUs - requested timestamp

Returns:

actual timestamp

canReadTrack

public boolean canReadTrack(@NonNull
                            TrackType type)

Description copied from interface: DataSource

Returns true if we can read the given track at this point. If true if returned, source should expect a DataSource.readTrack(Chunk) call.

Specified by:

canReadTrack in interface DataSource

Parameters:

type - track type

Returns:

true if we can read this track now

readTrack

public void readTrack(@NonNull
                      DataSource.Chunk chunk)

Description copied from interface: DataSource

Called to read contents for the current track type. Contents should be put inside DataSource.Chunk.buffer, and the other chunk flags should be filled.

Specified by:

readTrack in interface DataSource

Parameters:

chunk - output chunk

getReadUs

public long getReadUs()

Description copied from interface: DataSource

Returns the total number of microseconds that have been read until now.

Specified by:

getReadUs in interface DataSource

Returns:

total read us

isDrained

public boolean isDrained()

Description copied from interface: DataSource

When this source has been totally read, it can return true here to notify an end of input stream.

Specified by:

isDrained in interface DataSource

Returns:

true if drained

releaseTrack

public void releaseTrack(@NonNull
                         TrackType type)

Description copied from interface: DataSource

Called to release resources for a given track.

Specified by:

releaseTrack in interface DataSource

Parameters:

type - track type

rewind

public void rewind()

Description copied from interface: DataSource

Rewinds this source, moving it to its default state. To be used again, tracks will be selected again. After this call, for instance, - DataSource.getReadUs() should be 0 - DataSource.isDrained() should be false - DataSource.readTrack(Chunk) should return the very first bytes

Specified by:

rewind in interface DataSource