org.mp4parser.boxes.iso14496.part12

Class MediaDataBox

java.lang.Object

org.mp4parser.boxes.iso14496.part12.MediaDataBox

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, Box, ParsableBox

public final class MediaDataBox
extends java.lang.Object
implements ParsableBox, java.io.Closeable

4cc = ""mdat""

This box contains the media data. In video tracks, this box would contain video frames. A presentation may contain zero or more Media Data Boxes. The actual media data follows the type field; its structure is described by the metadata (see SampleTableBox).
In large presentations, it may be desirable to have more data in this box than a 32-bit size would permit. In this case, the large variant of the size field is used.
There may be any number of these boxes in the file (including zero, if all the media data is in other files). The metadata refers to media data by its absolute offset within the file (see StaticChunkOffsetBox); so Media Data Box headers and free space may easily be skipped, and files without any box structure may also be referenced and used.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	TYPE

Constructor Summary

Constructors

Constructor and Description
MediaDataBox()

Method Summary

Modifier and Type	Method and Description
void	close()
void	getBox(java.nio.channels.WritableByteChannel writableByteChannel) Writes the complete box - size | 4-cc | content - to the given writableByteChannel.
long	getSize()
java.lang.String	getType() The box's 4-cc type.
void	parse(java.nio.channels.ReadableByteChannel dataSource, java.nio.ByteBuffer header, long contentSize, BoxParser boxParser) Parses the box excluding the already parsed header (size, 4cc, [long-size], [user-type]).

Methods inherited from class java.lang.Object

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

Field Detail

TYPE

public static final java.lang.String TYPE

See Also:

Constant Field Values

Constructor Detail

MediaDataBox

public MediaDataBox()

Method Detail

getType

public java.lang.String getType()

Description copied from interface: Box

The box's 4-cc type.

Specified by:

getType in interface Box

Returns:

the 4 character type of the box

getBox

public void getBox(java.nio.channels.WritableByteChannel writableByteChannel)
            throws java.io.IOException

Description copied from interface: Box

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

Specified by:

getBox in interface Box

Parameters:

writableByteChannel - the box's sink

Throws:

java.io.IOException - in case of problems with the Channel

getSize

public long getSize()

Specified by:

getSize in interface Box

parse

@DoNotParseDetail
public void parse(java.nio.channels.ReadableByteChannel dataSource,
                                    java.nio.ByteBuffer header,
                                    long contentSize,
                                    BoxParser boxParser)
                             throws java.io.IOException

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

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:

java.io.IOException - in case of an error during a read operation

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException