org.mp4parser.boxes.iso14496.part12

Class TimeToSampleBox

java.lang.Object

org.mp4parser.support.AbstractBox

org.mp4parser.support.AbstractFullBox

org.mp4parser.boxes.iso14496.part12.TimeToSampleBox

All Implemented Interfaces:

Box, FullBox, ParsableBox

public class TimeToSampleBox
extends AbstractFullBox

4cc = ""stts""

This box contains a compact version of a table that allows indexing from decoding time to sample number. Other tables give sample sizes and pointers, from the sample number. Each entry in the table gives the number of consecutive samples with the same time delta, and the delta of those samples. By adding the deltas a complete time-to-sample map may be built.
The Decoding Time to Sample Box contains decode time delta's: DT(n+1) = DT(n) + STTS(n) where STTS(n) is the (uncompressed) table entry for sample n.
The sample entries are ordered by decoding time stamps; therefore the deltas are all non-negative.
The DT axis has a zero origin; DT(i) = SUM(for j=0 to i-1 of delta(j)), and the sum of all deltas gives the length of the media in the track (not mapped to the overall timescale, and not considering any edit list).
The Edit List Box provides the initial CT value if it is non-empty (non-zero).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TimeToSampleBox.Entry

Field Summary

Fields

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

Fields inherited from class org.mp4parser.support.AbstractBox

content, type

Constructor Summary

Constructors

Constructor and Description
TimeToSampleBox()

Method Summary

Modifier and Type	Method and Description
void	_parseDetails(java.nio.ByteBuffer content) Parse the box's fields and child boxes if any.
static long[]	blowupTimeToSamples(java.util.List<TimeToSampleBox.Entry> entries) Decompresses the list of entries and returns the list of decoding times.
protected void	getContent(java.nio.ByteBuffer byteBuffer) Write the box's content into the given ByteBuffer.
protected long	getContentSize() Get the box's content size without its header.
java.util.List<TimeToSampleBox.Entry>	getEntries()
void	setEntries(java.util.List<TimeToSampleBox.Entry> entries)
java.lang.String	toString()

Methods inherited from class org.mp4parser.support.AbstractFullBox

getFlags, getVersion, parseVersionAndFlags, setFlags, setVersion, writeVersionAndFlags

Methods inherited from class org.mp4parser.support.AbstractBox

getBox, getSize, getType, getUserType, isParsed, parse, parseDetails

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.mp4parser.ParsableBox

parse

Methods inherited from interface org.mp4parser.Box

getBox, getSize, getType

Field Detail

TYPE

public static final java.lang.String TYPE

See Also:

Constant Field Values

Constructor Detail

TimeToSampleBox

public TimeToSampleBox()

Method Detail

blowupTimeToSamples

public static long[] blowupTimeToSamples(java.util.List<TimeToSampleBox.Entry> entries)

Decompresses the list of entries and returns the list of decoding times.

Parameters:

entries - compressed entries

Returns:

decoding time per sample

getContentSize

protected long getContentSize()

Description copied from class: AbstractBox

Get the box's content size without its header. This must be the exact number of bytes that getContent(ByteBuffer) writes.

Specified by:

getContentSize in class AbstractBox

Returns:

Gets the box's content size in bytes

See Also:

AbstractBox.getContent(java.nio.ByteBuffer)

_parseDetails

public void _parseDetails(java.nio.ByteBuffer content)

Description copied from class: AbstractBox

Parse the box's fields and child boxes if any.

Specified by:

_parseDetails in class AbstractBox

Parameters:

content - the box's raw content beginning after the 4-cc field.

getContent

protected void getContent(java.nio.ByteBuffer byteBuffer)

Description copied from class: AbstractBox

Write the box's content into the given ByteBuffer. This must include flags and version in case of a full box. byteBuffer has been initialized with getSize() bytes.

Specified by:

getContent in class AbstractBox

Parameters:

byteBuffer - the sink for the box's content

getEntries

public java.util.List<TimeToSampleBox.Entry> getEntries()

setEntries

public void setEntries(java.util.List<TimeToSampleBox.Entry> entries)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object