GStreamer Base Plugins 1.0 Library Reference Manual | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
#include <gst/audio/gstaudiobasesink.h> struct GstAudioBaseSink; struct GstAudioBaseSinkClass; enum GstAudioBaseSinkSlaveMethod; #define GST_AUDIO_BASE_SINK_CLOCK (obj) #define GST_AUDIO_BASE_SINK_PAD (obj) GstAudioRingBuffer * gst_audio_base_sink_create_ringbuffer (GstAudioBaseSink *sink
); void gst_audio_base_sink_set_provide_clock (GstAudioBaseSink *sink
,gboolean provide
); gboolean gst_audio_base_sink_get_provide_clock (GstAudioBaseSink *sink
); void gst_audio_base_sink_set_slave_method (GstAudioBaseSink *sink
,GstAudioBaseSinkSlaveMethod method
); GstAudioBaseSinkSlaveMethod gst_audio_base_sink_get_slave_method (GstAudioBaseSink *sink
); void gst_audio_base_sink_set_drift_tolerance (GstAudioBaseSink *sink
,gint64 drift_tolerance
); gint64 gst_audio_base_sink_get_drift_tolerance (GstAudioBaseSink *sink
); void gst_audio_base_sink_set_alignment_threshold (GstAudioBaseSink *sink
,GstClockTime alignment_threshold
); GstClockTime gst_audio_base_sink_get_alignment_threshold (GstAudioBaseSink *sink
); void gst_audio_base_sink_set_discont_wait (GstAudioBaseSink *sink
,GstClockTime discont_wait
); GstClockTime gst_audio_base_sink_get_discont_wait (GstAudioBaseSink *sink
);
GObject +----GInitiallyUnowned +----GstObject +----GstElement +----GstBaseSink +----GstAudioBaseSink +----GstAudioSink
"alignment-threshold" guint64 : Read / Write "buffer-time" gint64 : Read / Write "can-activate-pull" gboolean : Read / Write "discont-wait" guint64 : Read / Write "drift-tolerance" gint64 : Read / Write "latency-time" gint64 : Read / Write "provide-clock" gboolean : Read / Write "slave-method" GstAudioBaseSinkSlaveMethod : Read / Write
This is the base class for audio sinks. Subclasses need to implement the ::create_ringbuffer vmethod. This base class will then take care of writing samples to the ringbuffer, synchronisation, clipping and flushing.
Last reviewed on 2006-09-27 (0.10.12)
struct GstAudioBaseSinkClass { GstBaseSinkClass parent_class; /* subclass ringbuffer allocation */ GstAudioRingBuffer* (*create_ringbuffer) (GstAudioBaseSink *sink); /* subclass payloader */ GstBuffer* (*payload) (GstAudioBaseSink *sink, GstBuffer *buffer); };
GstAudioBaseSink class. Override the vmethod to implement functionality.
GstBaseSinkClass |
the parent class. |
create and return a GstAudioRingBuffer to write to. | |
payload data in a format suitable to write to the sink. If no payloading is required, returns a reffed copy of the original buffer, else returns the payloaded buffer with all other metadata copied. |
typedef enum { GST_AUDIO_BASE_SINK_SLAVE_RESAMPLE, GST_AUDIO_BASE_SINK_SLAVE_SKEW, GST_AUDIO_BASE_SINK_SLAVE_NONE } GstAudioBaseSinkSlaveMethod;
Different possible clock slaving algorithms used when the internal audio clock is not selected as the pipeline master clock.
#define GST_AUDIO_BASE_SINK_CLOCK(obj) (GST_AUDIO_BASE_SINK (obj)->clock)
Get the GstClock of obj
.
|
a GstAudioBaseSink |
#define GST_AUDIO_BASE_SINK_PAD(obj) (GST_BASE_SINK (obj)->sinkpad)
Get the sink GstPad of obj
.
|
a GstAudioBaseSink |
GstAudioRingBuffer * gst_audio_base_sink_create_ringbuffer
(GstAudioBaseSink *sink
);
Create and return the GstAudioRingBuffer for sink
. This function will call the
::create_ringbuffer vmethod and will set sink
as the parent of the returned
buffer (see gst_object_set_parent()
).
|
a GstAudioBaseSink. |
Returns : |
The new ringbuffer of sink . [transfer none]
|
void gst_audio_base_sink_set_provide_clock (GstAudioBaseSink *sink
,gboolean provide
);
Controls whether sink
will provide a clock or not. If provide
is TRUE
,
gst_element_provide_clock()
will return a clock that reflects the datarate
of sink
. If provide
is FALSE
, gst_element_provide_clock()
will return NULL.
|
a GstAudioBaseSink |
|
new state |
gboolean gst_audio_base_sink_get_provide_clock
(GstAudioBaseSink *sink
);
Queries whether sink
will provide a clock or not. See also
gst_audio_base_sink_set_provide_clock.
|
a GstAudioBaseSink |
Returns : |
TRUE if sink will provide a clock. |
void gst_audio_base_sink_set_slave_method (GstAudioBaseSink *sink
,GstAudioBaseSinkSlaveMethod method
);
Controls how clock slaving will be performed in sink
.
|
a GstAudioBaseSink |
|
the new slave method |
GstAudioBaseSinkSlaveMethod gst_audio_base_sink_get_slave_method
(GstAudioBaseSink *sink
);
Get the current slave method used by sink
.
|
a GstAudioBaseSink |
Returns : |
The current slave method used by sink . |
void gst_audio_base_sink_set_drift_tolerance (GstAudioBaseSink *sink
,gint64 drift_tolerance
);
Controls the sink's drift tolerance.
|
a GstAudioBaseSink |
|
the new drift tolerance in microseconds |
gint64 gst_audio_base_sink_get_drift_tolerance
(GstAudioBaseSink *sink
);
Get the current drift tolerance, in microseconds, used by sink
.
|
a GstAudioBaseSink |
Returns : |
The current drift tolerance used by sink . |
void gst_audio_base_sink_set_alignment_threshold (GstAudioBaseSink *sink
,GstClockTime alignment_threshold
);
Controls the sink's alignment threshold.
|
a GstAudioBaseSink |
|
the new alignment threshold in nanoseconds |
GstClockTime gst_audio_base_sink_get_alignment_threshold
(GstAudioBaseSink *sink
);
Get the current alignment threshold, in nanoseconds, used by sink
.
|
a GstAudioBaseSink |
Returns : |
The current alignment threshold used by sink . |
void gst_audio_base_sink_set_discont_wait (GstAudioBaseSink *sink
,GstClockTime discont_wait
);
Controls how long the sink will wait before creating a discontinuity.
|
a GstAudioBaseSink |
|
the new discont wait in nanoseconds |
GstClockTime gst_audio_base_sink_get_discont_wait
(GstAudioBaseSink *sink
);
Get the current discont wait, in nanoseconds, used by sink
.
|
a GstAudioBaseSink |
Returns : |
The current discont wait used by sink . |
"alignment-threshold"
property "alignment-threshold" guint64 : Read / Write
Timestamp alignment threshold in nanoseconds.
Allowed values: [1,18446744073709551614]
Default value: 40000000
"buffer-time"
property "buffer-time" gint64 : Read / Write
Size of audio buffer in microseconds, this is the minimum latency that the sink reports.
Allowed values: >= 1
Default value: 200000
"can-activate-pull"
property"can-activate-pull" gboolean : Read / Write
Allow pull-based scheduling.
Default value: FALSE
"discont-wait"
property "discont-wait" guint64 : Read / Write
A window of time in nanoseconds to wait before creating a discontinuity as a result of breaching the drift-tolerance.
Allowed values: <= 18446744073709551614
Default value: 1000000000
"drift-tolerance"
property "drift-tolerance" gint64 : Read / Write
Controls the amount of time in microseconds that clocks are allowed to drift before resynchronisation happens.
Allowed values: >= 1
Default value: 40000
"latency-time"
property "latency-time" gint64 : Read / Write
The minimum amount of data to write in each iteration in microseconds.
Allowed values: >= 1
Default value: 10000
"provide-clock"
property"provide-clock" gboolean : Read / Write
Provide a clock to be used as the global pipeline clock.
Default value: TRUE
"slave-method"
property"slave-method" GstAudioBaseSinkSlaveMethod : Read / Write
Algorithm to use to match the rate of the masterclock.
Default value: GST_AUDIO_BASE_SINK_SLAVE_SKEW