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 timestamp in microseconds.
long	adjustTsTimestamp(long pts90Khz) Scales and offsets an MPEG-2 TS presentation timestamp considering wraparound.
long	getFirstSampleTimestampUs() Returns the last value passed to setFirstSampleTimestampUs(long).
long	getLastAdjustedTimestampUs() Returns the last value obtained from adjustSampleTimestamp(long).
long	getTimestampOffsetUs() Returns the offset between the input of adjustSampleTimestamp(long) and its output.
static long	ptsToUs(long pts) Converts a 90 kHz clock timestamp to a timestamp 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 timestamp in microseconds to a 90 kHz clock timestamp.
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 last value passed to setFirstSampleTimestampUs(long).

getLastAdjustedTimestampUs

public long getLastAdjustedTimestampUs()

Returns the last value obtained from adjustSampleTimestamp(long). If adjustSampleTimestamp(long) has not been called, returns the result of calling getFirstSampleTimestampUs(). If this value is DO_NOT_OFFSET, returns C.TIME_UNSET.

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 pts90Khz)

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

Parameters:

pts90Khz - A 90 kHz clock MPEG-2 TS presentation timestamp.

Returns:

The adjusted timestamp in microseconds.

adjustSampleTimestamp

public long adjustSampleTimestamp(long timeUs)

Offsets a timestamp in microseconds.

Parameters:

timeUs - The timestamp to adjust in microseconds.

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 90 kHz clock timestamp to a timestamp in microseconds.

Parameters:

pts - A 90 kHz clock timestamp.

Returns:

The corresponding value in microseconds.

usToPts

public static long usToPts(long us)

Converts a timestamp in microseconds to a 90 kHz clock timestamp.

Parameters:

us - A value in microseconds.

Returns:

The corresponding value as a 90 kHz clock timestamp.