Gst.ReferenceTimestampMeta

Fields

Name

Type

Access

Description

duration

int

r/w

duration, or Gst.CLOCK_TIME_NONE

info

Gst.Structure

r/w

Additional information about the timestamp.

parent

Gst.Meta

r/w

the parent Gst.Meta structure

reference

Gst.Caps

r/w

identifier for the timestamp reference.

timestamp

int

r/w

timestamp

Methods

class

get_info ()

Details

class Gst.ReferenceTimestampMeta

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.

New in version 1.14.

classmethod get_info()[source]
Returns:

The Gst.MetaInfo

Return type:

Gst.MetaInfo

Gets the global Gst.MetaInfo describing the Gst.ReferenceTimestampMeta meta.

New in version 1.14.