com.google.android.exoplayer2.util

Class TimestampAdjuster

java.lang.Object

com.google.android.exoplayer2.util.TimestampAdjuster

public final class TimestampAdjuster
extends java.lang.Object

Offsets timestamps according to an initial sample timestamp offset. MPEG-2 TS timestamps scaling and adjustment is supported, taking into account timestamp rollover.

Field Summary

Fields

Modifier and Type	Field and Description
static long	DO_NOT_OFFSET A special firstSampleTimestampUs value indicating that presentation timestamps should not be offset.

Constructor Summary

Constructors

Constructor and Description
TimestampAdjuster(long firstSampleTimestampUs)

Method Summary

Modifier and Type	Method and Description
long	adjustSampleTimestamp(long timeUs) Offsets a sample timestamp in microseconds.
long	adjustTsTimestamp(long pts) Scales and offsets an MPEG-2 TS presentation timestamp considering wraparound.
long	getFirstSampleTimestampUs() Returns the first adjusted sample timestamp in microseconds.
long	getLastAdjustedTimestampUs() Returns the last adjusted timestamp.
long	getTimestampOffsetUs() Returns the offset between the input of adjustSampleTimestamp(long) and its output.
static long	ptsToUs(long pts) Converts a value in MPEG-2 timestamp units to the corresponding value in microseconds.
void	reset() Resets the instance to its initial state.
void	setFirstSampleTimestampUs(long firstSampleTimestampUs) Sets the desired result of the first call to adjustSampleTimestamp(long).
static long	usToPts(long us) Converts a value in microseconds to the corresponding values in MPEG-2 timestamp units.
void	waitUntilInitialized() Blocks the calling thread until this adjuster is initialized.

Methods inherited from class java.lang.Object

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

Field Detail

DO_NOT_OFFSET

public static final long DO_NOT_OFFSET

A special firstSampleTimestampUs value indicating that presentation timestamps should not be offset.

See Also:

Constant Field Values

Constructor Detail

TimestampAdjuster

public TimestampAdjuster(long firstSampleTimestampUs)

Parameters:

firstSampleTimestampUs - See setFirstSampleTimestampUs(long).

Method Detail

setFirstSampleTimestampUs

public void setFirstSampleTimestampUs(long firstSampleTimestampUs)

Sets the desired result of the first call to adjustSampleTimestamp(long). Can only be called before any timestamps have been adjusted.

Parameters:

firstSampleTimestampUs - The first adjusted sample timestamp in microseconds, or DO_NOT_OFFSET if presentation timestamps should not be offset.

getFirstSampleTimestampUs

public long getFirstSampleTimestampUs()

Returns the first adjusted sample timestamp in microseconds.

Returns:

The first adjusted sample timestamp in microseconds.

getLastAdjustedTimestampUs

public long getLastAdjustedTimestampUs()

Returns the last adjusted timestamp. If no timestamp has been adjusted, returns firstSampleTimestampUs as provided to the constructor. If this value is DO_NOT_OFFSET, returns C.TIME_UNSET.

Returns:

The last adjusted timestamp. If not present, firstSampleTimestampUs is returned unless equal to DO_NOT_OFFSET, in which case C.TIME_UNSET is returned.

getTimestampOffsetUs

public long getTimestampOffsetUs()

Returns the offset between the input of adjustSampleTimestamp(long) and its output. If DO_NOT_OFFSET was provided to the constructor, 0 is returned. If the timestamp adjuster is yet not initialized, C.TIME_UNSET is returned.

Returns:

The offset between adjustSampleTimestamp(long)'s input and output. C.TIME_UNSET if the adjuster is not yet initialized and 0 if timestamps should not be offset.

reset

public void reset()

Resets the instance to its initial state.

adjustTsTimestamp

public long adjustTsTimestamp(long pts)

Scales and offsets an MPEG-2 TS presentation timestamp considering wraparound.

Parameters:

pts - The MPEG-2 TS presentation timestamp.

Returns:

The adjusted timestamp in microseconds.

adjustSampleTimestamp

public long adjustSampleTimestamp(long timeUs)

Offsets a sample timestamp in microseconds.

Parameters:

timeUs - The timestamp of a sample to adjust.

Returns:

The adjusted timestamp in microseconds.

waitUntilInitialized

public void waitUntilInitialized()
                          throws java.lang.InterruptedException

Blocks the calling thread until this adjuster is initialized.

Throws:

java.lang.InterruptedException - If the thread was interrupted.

ptsToUs

public static long ptsToUs(long pts)

Converts a value in MPEG-2 timestamp units to the corresponding value in microseconds.

Parameters:

pts - A value in MPEG-2 timestamp units.

Returns:

The corresponding value in microseconds.

usToPts

public static long usToPts(long us)

Converts a value in microseconds to the corresponding values in MPEG-2 timestamp units.

Parameters:

us - A value in microseconds.

Returns:

The corresponding value in MPEG-2 timestamp units.