Timestamps, error-free

These functions support generating timestamps without long term rounding errors due to sample rate conversions. More...

Collaboration diagram for Timestamps, error-free:

Data Structures
struct	date_t
	Timestamps without long-term rounding errors. More...

Functions
void	date_Init (date_t *restrict date, uint32_t num, uint32_t den)
	Initializes a date_t.
void	date_Change (date_t *restrict date, uint32_t num, uint32_t den)
	Changes the rate of a date_t.
static void	date_Set (date_t *restrict date, vlc_tick_t value)
	Sets the exact timestamp of a date_t.
static vlc_tick_t	date_Get (const date_t *restrict date)
	Gets the current timestamp from a date_t.
vlc_tick_t	date_Increment (date_t *restrict date, uint32_t count)
	Increments a date.
vlc_tick_t	date_Decrement (date_t *restrict date, uint32_t count)
	Decrements a date.

Detailed Description

These functions support generating timestamps without long term rounding errors due to sample rate conversions.

Function Documentation

date_Change()

void date_Change	(	date_t *restrict	date,
		uint32_t	num,
		uint32_t	den )

Changes the rate of a date_t.

Parameters

date	date to change
num	divider (sample rate) numerator
den	divider (sample rate) denominator

References VLC_API.

date_Decrement()

vlc_tick_t date_Decrement	(	date_t *restrict	date,
		uint32_t	count )

Decrements a date.

Moves the date_t timestamp backward by a given number of samples.

Parameters

date	date to move backward
count	number of samples

Returns

date value

References count, and VLC_API.

date_Get()

vlc_tick_t date_Get ( const date_t *restrict date )

inlinestatic

Gets the current timestamp from a date_t.

Parameters

date	date to fetch the timestamp from

Returns

date value

References VLC_USED.

date_Increment()

vlc_tick_t date_Increment	(	date_t *restrict	date,
		uint32_t	count )

Increments a date.

Moves the date_t timestamp forward by a given number of samples.

Parameters

date	date to move forward
count	number of samples

Returns

timestamp value after incrementing

References count, and VLC_API.

date_Init()

void date_Init	(	date_t *restrict	date,
		uint32_t	num,
		uint32_t	den )

Initializes a date_t.

Parameters

date	date to initialize [OUT]
num	divider (sample rate) numerator
den	divider (sample rate) denominator

References VLC_API.

date_Set()

void date_Set ( date_t *restrict date, vlc_tick_t value )

inlinestatic

Sets the exact timestamp of a date_t.

Parameters

date	date to set the timestamp into
value	date value