Package org.mp4parser.boxes.iso14496.part12

Class SampleDescriptionBox

  • All Implemented Interfaces:
    Box, Container, FullBox, ParsableBox
    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

    • 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​(ReadableByteChannel dataSource,
                  ByteBuffer header,
                  long contentSize,
                  BoxParser boxParser)
           throws IOException
        Description copied from interface: ParsableBox
        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 ParsableBox
        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