Gst-1.0 ▶ Gst ▶ ReferenceTimestampMetaSince 1.14

Gst.ReferenceTimestampMeta can be used to attach alternative timestamps and possibly durations to a Gst.Buffer. These are generally not according to the pipeline clock and could be e.g. the NTP timestamp when the media was captured.

The reference is stored as a Gst.Caps in reference. Examples of valid references would be

• timestamp/x-drivername-stream: for timestamps that are locally generated by some driver named drivername when generating the stream, e.g. based on a frame counter
• timestamp/x-ntp, host=pool.ntp.org, port=123: for timestamps based on a specific NTP server. Note that the host/port parameters might not always be given.
• timestamp/x-ptp, version=IEEE1588-2008, domain=1: for timestamps based on a given PTP clock.
• timestamp/x-unix: for timestamps based on the UNIX epoch according to the local clock.

Since 1.24 it can be serialized using gst_meta_serialize() and gst_meta_deserialize().

Since 1.28 additional information about the timestamp can be provided via the optional info structure. This should only be used for information about the timestamp and not for information about the clock source. The latter should be stored in the reference instead.

Interpretation of the fields of info depends on the reference.