com.coremedia.iso.boxes

Class SampleDescriptionBox

java.lang.Object

com.googlecode.mp4parser.BasicContainer

com.googlecode.mp4parser.AbstractContainerBox

com.coremedia.iso.boxes.SampleDescriptionBox

All Implemented Interfaces:

Box, Container, FullBox, Closeable, AutoCloseable, Iterator<Box>

public class SampleDescriptionBox
extends AbstractContainerBox
implements FullBox

4cc = ""stsd""

The sample description table gives detailed information about the coding type used, and any initialization information needed for that coding.
The information stored in the sample description box after the entry-count is both track-type specific as documented here, and can also have variants within a track type (e.g. different codings may use different specific information after some common fields, even within a video track).
For video tracks, a VisualSampleEntry is used; for audio tracks, an AudioSampleEntry. Hint tracks use an entry format specific to their protocol, with an appropriate name. Timed Text tracks use a TextSampleEntry For hint tracks, the sample description contains appropriate declarative data for the streaming protocol being used, and the format of the hint track. The definition of the sample description is specific to the protocol. Multiple descriptions may be used within a track.
The 'protocol' and 'codingname' fields are registered identifiers that uniquely identify the streaming protocol or compression format decoder to be used. A given protocol or codingname may have optional or required extensions to the sample description (e.g. codec initialization parameters). All such extensions shall be within boxes; these boxes occur after the required fields. Unrecognized boxes shall be ignored.
Defined in ISO/IEC 14496-12

See Also:

VisualSampleEntry, TextSampleEntry, AudioSampleEntry

Field Summary

Fields

Modifier and Type	Field and Description
static String	TYPE

Fields inherited from class com.googlecode.mp4parser.AbstractContainerBox

largeBox, type

Fields inherited from class com.googlecode.mp4parser.BasicContainer

boxParser, dataSource

Constructor Summary

Constructors

Constructor and Description
SampleDescriptionBox()

Method Summary

Methods

Modifier and Type	Method and Description
void	getBox(WritableByteChannel writableByteChannel) Writes the complete box - size | 4-cc | content - to the given writableByteChannel.
int	getFlags()
AbstractSampleEntry	getSampleEntry()
long	getSize()
int	getVersion()
void	parse(DataSource dataSource, ByteBuffer header, long contentSize, BoxParser boxParser) Parses the box excluding the already parsed header (size, 4cc, [long-size], [user-type]).
void	setFlags(int flags)
void	setVersion(int version)

Methods inherited from class com.googlecode.mp4parser.AbstractContainerBox

getHeader, getOffset, getParent, getType, initContainer, setParent

Methods inherited from class com.googlecode.mp4parser.BasicContainer

addBox, close, getBoxes, getBoxes, getBoxes, getByteBuffer, getContainerSize, hasNext, next, remove, setBoxes, toString, writeContainer

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.coremedia.iso.boxes.Box

getOffset, getParent, getType, setParent

Field Detail

TYPE

public static final String TYPE

See Also:

Constant Field Values

Constructor Detail

SampleDescriptionBox

public SampleDescriptionBox()

Method Detail

getVersion

public int getVersion()

Specified by:

getVersion in interface FullBox

setVersion

public void setVersion(int version)

Specified by:

setVersion in interface FullBox

getFlags

public int getFlags()

Specified by:

getFlags in interface FullBox

setFlags

public void setFlags(int flags)

Specified by:

setFlags in interface FullBox

parse

public void parse(DataSource dataSource,
         ByteBuffer header,
         long contentSize,
         BoxParser boxParser)
           throws IOException

Description copied from interface: Box

Parses the box excluding the already parsed header (size, 4cc, [long-size], [user-type]). The remaining size of the box is the contentSize, contentSize number of bytes should be read from the box source (readableByteChannel). If you need the header buffer at a later stage you have to create a copy.

Specified by:

parse in interface Box

Overrides:

parse in class AbstractContainerBox

Parameters:

dataSource - the source for this box

header - the box' already parsed header (create copy if you need it later as it will be overwritten)

contentSize - remaining bytes of this box

boxParser - use it to parse sub-boxes.

Throws:

IOException - in case of an error during a read operation

getBox

public void getBox(WritableByteChannel writableByteChannel)
            throws IOException

Description copied from interface: Box

Writes the complete box - size | 4-cc | content - to the given writableByteChannel.

Specified by:

getBox in interface Box

Overrides:

getBox in class AbstractContainerBox

Parameters:

writableByteChannel - the box's sink

Throws:

IOException - in case of problems with the Channel

getSampleEntry

public AbstractSampleEntry getSampleEntry()

getSize

public long getSize()

Specified by:

getSize in interface Box

Overrides:

getSize in class AbstractContainerBox