mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2025-09-03 02:33:53 +00:00
Code Issues 1 Projects Releases Wiki Activity

clock: improve the GST_TIME_FORMAT/ARGS docs

Browse source
This commit is contained in:
Kipp Cannon 2011-05-24 00:26:40 +03:00 committed by Stefan Kost
parent 1718abcbbb
commit 696a9a694f
1 changed files with 13 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
gst/gstclock.h
View file

@ -205,15 +205,22 @@ G_STMT_START { \
/** /**
* GST_TIME_FORMAT: * GST_TIME_FORMAT:
* *
* A format that can be used in printf like format strings to format * A string that can be used in printf-like format strings to display a
* a #GstClockTime value. * #GstClockTime value in h:m:s format. Use GST_TIME_ARGS() to construct
* the matching arguments.
*
* Example:
* |[
* printf("%" GST_TIME_FORMAT "\n", GST_TIME_ARGS(ts));
* ]|
*/ */
#define GST_TIME_FORMAT "u:%02u:%02u.%09u" #define GST_TIME_FORMAT "u:%02u:%02u.%09u"
/** /**
* GST_TIME_ARGS: * GST_TIME_ARGS:
* @t: a #GstClockTime * @t: a #GstClockTime
* *
* Format @t for the GST_TIME_FORMAT format string. * Format @t for the #GST_TIME_FORMAT format string. Note: @t will be
* evaluated more than once.
*/ */
#define GST_TIME_ARGS(t) \ #define GST_TIME_ARGS(t) \
GST_CLOCK_TIME_IS_VALID (t) ? \ GST_CLOCK_TIME_IS_VALID (t) ? \
@ -407,7 +414,7 @@ typedef enum {
* @tv: a #GTimeVal to wait. * @tv: a #GTimeVal to wait.
* *
* Wait on the clock until the entries changed or the specified timeout * Wait on the clock until the entries changed or the specified timeout
* occurred. * occurred.
*/ */
#define GST_CLOCK_TIMED_WAIT(clock,tv) g_cond_timed_wait(GST_CLOCK_COND(clock),GST_OBJECT_GET_LOCK(clock),tv) #define GST_CLOCK_TIMED_WAIT(clock,tv) g_cond_timed_wait(GST_CLOCK_COND(clock),GST_OBJECT_GET_LOCK(clock),tv)
/** /**
@ -430,7 +437,7 @@ struct _GstClock {
GMutex *slave_lock; /* order: SLAVE_LOCK, OBJECT_LOCK */ GMutex *slave_lock; /* order: SLAVE_LOCK, OBJECT_LOCK */
/*< protected >*/ /* with LOCK */ /*< protected >*/ /* with LOCK */
GstClockTime internal_calibration; GstClockTime internal_calibration;
GstClockTime external_calibration; GstClockTime external_calibration;
GstClockTime rate_numerator; GstClockTime rate_numerator;
GstClockTime rate_denominator; GstClockTime rate_denominator;
@ -521,7 +528,7 @@ void gst_clock_get_calibration (GstClock *clock, GstClockTime *internal,
/* master/slave clocks */ /* master/slave clocks */
gboolean gst_clock_set_master (GstClock *clock, GstClock *master); gboolean gst_clock_set_master (GstClock *clock, GstClock *master);
GstClock* gst_clock_get_master (GstClock *clock); GstClock* gst_clock_get_master (GstClock *clock);
gboolean gst_clock_add_observation (GstClock *clock, GstClockTime slave, gboolean gst_clock_add_observation (GstClock *clock, GstClockTime slave,
GstClockTime master, gdouble *r_squared); GstClockTime master, gdouble *r_squared);