net.sourceforge.jaad.mp4.api

Class Track

java.lang.Object

net.sourceforge.jaad.mp4.api.Track

Direct Known Subclasses:

AudioTrack, VideoTrack

public abstract class Track
extends java.lang.Object

This class represents a track in a movie. Each track contains either a decoder specific info as a byte array or a DecoderInfo object that contains necessary information for the decoder.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Track.Codec

Field Summary

Fields

Modifier and Type	Field and Description
protected DecoderInfo	decoderInfo
protected DecoderSpecificInfo	decoderSpecificInfo
protected Protection	protection
protected TrackHeaderBox	tkhd

Method Summary

Methods

Modifier and Type	Method and Description
protected void	findDecoderSpecificInfo(ESDBox esds)
abstract Track.Codec	getCodec()
java.util.Date	getCreationTime() Returns the time this track was created.
DecoderInfo	getDecoderInfo() Returns the DecoderInfo, if present.
byte[]	getDecoderSpecificInfo() Returns the decoder specific info, if present.
java.util.Locale	getLanguage() Returns the language for this media.
java.net.URL	getLocation() If the data for this track is not present in this file (if isInFile returns false), this method returns the data's location.
java.util.Date	getModificationTime() Returns the last time this track was modified.
Protection	getProtection() Returns the ProtectionInformation object that contains details about the DRM system used.
abstract Type	getType()
boolean	hasMoreFrames() Indicates if there are more frames to be read in this track.
boolean	isEnabled() Returns true if the track is enabled.
boolean	isInFile() Returns true if the data for this track is present in this file (stream).
boolean	isUsed() Returns true if the track is used in the presentation.
boolean	isUsedForPreview() Returns true if the track is used in previews.
protected <T> void	parseSampleEntry(Box sampleEntry, java.lang.Class<T> clazz)
Frame	readNextFrame() Reads the next frame from this track.
double	seek(double timestamp) This method tries to seek to the frame that is nearest to the given timestamp.

Methods inherited from class java.lang.Object

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

Field Detail

tkhd

protected final TrackHeaderBox tkhd

decoderSpecificInfo

protected DecoderSpecificInfo decoderSpecificInfo

decoderInfo

protected DecoderInfo decoderInfo

protection

protected Protection protection

Method Detail

findDecoderSpecificInfo

protected void findDecoderSpecificInfo(ESDBox esds)

parseSampleEntry

protected <T> void parseSampleEntry(Box sampleEntry,
                        java.lang.Class<T> clazz)

getType

public abstract Type getType()

getCodec

public abstract Track.Codec getCodec()

isEnabled

public boolean isEnabled()

Returns true if the track is enabled. A disabled track is treated as if it were not present.

Returns:

true if the track is enabled

isUsed

public boolean isUsed()

Returns true if the track is used in the presentation.

Returns:

true if the track is used

isUsedForPreview

public boolean isUsedForPreview()

Returns true if the track is used in previews.

Returns:

true if the track is used in previews

getCreationTime

public java.util.Date getCreationTime()

Returns the time this track was created.

Returns:

the creation time

getModificationTime

public java.util.Date getModificationTime()

Returns the last time this track was modified.

Returns:

the modification time

getLanguage

public java.util.Locale getLanguage()

Returns the language for this media.

Returns:

the language

isInFile

public boolean isInFile()

Returns true if the data for this track is present in this file (stream). If not, getLocation() returns the URL where the data can be found.

Returns:

true if the data is in this file (stream), false otherwise

getLocation

public java.net.URL getLocation()

If the data for this track is not present in this file (if isInFile returns false), this method returns the data's location. Else null is returned.

Returns:

the data's location or null if the data is in this file

getDecoderSpecificInfo

public byte[] getDecoderSpecificInfo()

Returns the decoder specific info, if present. It contains configuration data for the decoder. If the decoder specific info is not present, the track contains a DecoderInfo.

Returns:

the decoder specific info

See Also:

getDecoderInfo()

getDecoderInfo

public DecoderInfo getDecoderInfo()

Returns the DecoderInfo, if present. It contains configuration information for the decoder. If the structure is not present, the track contains a decoder specific info.

Returns:

the codec specific structure

See Also:

getDecoderSpecificInfo()

getProtection

public Protection getProtection()

Returns the ProtectionInformation object that contains details about the DRM system used. If no protection is present this method returns null.

Returns:

a ProtectionInformation object or null if no protection is used

hasMoreFrames

public boolean hasMoreFrames()

Indicates if there are more frames to be read in this track.

Returns:

true if there is at least one more frame to read.

readNextFrame

public Frame readNextFrame()
                    throws java.io.IOException

Reads the next frame from this track. If it contains no more frames to read, null is returned.

Returns:

the next frame or null if there are no more frames to read

Throws:

java.io.IOException - if reading fails

seek

public double seek(double timestamp)

This method tries to seek to the frame that is nearest to the given timestamp. It returns the timestamp of the frame it seeked to or -1 if none was found.

Parameters:

timestamp - a timestamp to seek to

Returns:

the frame's timestamp that the method seeked to