Times

Functions
void	mpr_time_add (mpr_time *augend, mpr_time addend)
void	mpr_time_add_dbl (mpr_time *augend, double addend)
void	mpr_time_sub (mpr_time *minuend, mpr_time subtrahend)
void	mpr_time_mul (mpr_time *time, double multiplicand)
double	mpr_time_as_dbl (mpr_time time)
void	mpr_time_set_dbl (mpr_time *time, double value)
void	mpr_time_set (mpr_time *timel, mpr_time timer)
int	mpr_time_cmp (mpr_time time1, mpr_time time2)
void	mpr_time_print (mpr_time time)

Detailed Description

libmapper primarily uses NTP timetags for communication and synchronization.

Function Documentation

mpr_time_add()

void mpr_time_add	(	mpr_time *	augend,
		mpr_time	addend )

Add a time to another given time.

Parameters

augend	A previously allocated time to augment.
addend	A time to add.

mpr_time_add_dbl()

void mpr_time_add_dbl	(	mpr_time *	augend,
		double	addend )

Add a double-precision floating point value to another given time.

Parameters

augend	A previously allocated time to augment.
addend	A value in seconds to add.

mpr_time_as_dbl()

double mpr_time_as_dbl

(

mpr_time

time

)

Return value of a mpr_time as a double-precision floating point value.

Parameters

time	The time to read.

Returns

Value of the time as a double-precision float.

mpr_time_cmp()

int mpr_time_cmp	(	mpr_time	time1,
		mpr_time	time2 )

Compare two timetags, returning zero if they all match or a value different from zero representing which is greater if they do not.

Parameters

time1	A previously allocated time to augment.
time2	A time to add.

Returns

<0 if time1 < time2; 0 if time1 == time2; >0 if time1 > time2.

mpr_time_mul()

void mpr_time_mul	(	mpr_time *	time,
		double	multiplicand )

Add a double-precision floating point value to another given time.

Parameters

time	A previously allocated time to multiply.
multiplicand	A value in seconds.

mpr_time_print()

void mpr_time_print

(

mpr_time

time

)

Helper to print a libmapper timetag

Parameters

time	The timetag to print.

mpr_time_set()

void mpr_time_set	(	mpr_time *	timel,
		mpr_time	timer )

Copy value of a mpr_time.

Parameters

timel	The target time for copying.
timer	The source time.

mpr_time_set_dbl()

void mpr_time_set_dbl	(	mpr_time *	time,
		double	value )

Set value of a mpr_time from a double-precision floating point value.

Parameters

time	A previously-allocated time to set.
value	The value in seconds to set.

mpr_time_sub()

void mpr_time_sub	(	mpr_time *	minuend,
		mpr_time	subtrahend )

Subtract a time from another given time.

Parameters

minuend	A previously allocated time to augment.
subtrahend	A time to add to subtract.