docs: add GstAudioDecoder and GstAudioEncoder to documentation

This commit is contained in:
Tim-Philipp Müller 2011-09-05 20:45:22 +01:00
parent 86e6343759
commit 7563e0c9cf
6 changed files with 105 additions and 17 deletions

View file

@ -44,6 +44,8 @@
</para> </para>
<xi:include href="xml/gstaudio.xml" /> <xi:include href="xml/gstaudio.xml" />
<xi:include href="xml/gstaudioclock.xml" /> <xi:include href="xml/gstaudioclock.xml" />
<xi:include href="xml/gstaudiodecoder.xml" />
<xi:include href="xml/gstaudioencoder.xml" />
<xi:include href="xml/gstaudiofilter.xml" /> <xi:include href="xml/gstaudiofilter.xml" />
<xi:include href="xml/gstaudiomixerutils.xml" /> <xi:include href="xml/gstaudiomixerutils.xml" />
<xi:include href="xml/gstaudiosink.xml" /> <xi:include href="xml/gstaudiosink.xml" />

View file

@ -124,6 +124,86 @@ GST_IS_AUDIO_CLOCK_CLASS
GST_AUDIO_CLOCK_CAST GST_AUDIO_CLOCK_CAST
</SECTION> </SECTION>
<SECTION>
<FILE>gstaudiodecoder</FILE>
<INCLUDE>gst/audio/gstaudiodecoder.h</INCLUDE>
GstAudioDecoder
GstAudioDecoderClass
GST_AUDIO_DECODER_ERROR
GST_AUDIO_DECODER_SINK_NAME
GST_AUDIO_DECODER_SINK_PAD
GST_AUDIO_DECODER_SRC_NAME
GST_AUDIO_DECODER_SRC_PAD
gst_audio_decoder_finish_frame
gst_audio_decoder_get_audio_info
gst_audio_decoder_get_byte_time
gst_audio_decoder_get_delay
gst_audio_decoder_get_latency
gst_audio_decoder_get_max_errors
gst_audio_decoder_get_min_latency
gst_audio_decoder_get_parse_state
gst_audio_decoder_get_plc
gst_audio_decoder_get_plc_aware
gst_audio_decoder_get_tolerance
gst_audio_decoder_set_byte_time
gst_audio_decoder_set_latency
gst_audio_decoder_set_max_errors
gst_audio_decoder_set_min_latency
gst_audio_decoder_set_plc
gst_audio_decoder_set_plc_aware
gst_audio_decoder_set_tolerance
<SUBSECTION Standard>
GST_AUDIO_DECODER
GST_IS_AUDI_DECODER
GST_TYPE_AUDIO_DECODER
gst_audio_decoder_get_type
GST_AUDIO_DECODER_CLASS
GST_IS_AUDIO_DECODER_CLASS
GST_AUDIO_DECODER_GET_CLASS
GstAudioDecoderPrivate
</SECTION>
<SECTION>
<FILE>gstaudioencoder</FILE>
<INCLUDE>gst/audio/gstaudioencoder.h</INCLUDE>
GstAudioEncoder
GstAudioEncoderClass
GST_AUDIO_ENCODER_SEGMENT
GST_AUDIO_ENCODER_SINK_NAME
GST_AUDIO_ENCODER_SINK_PAD
GST_AUDIO_ENCODER_SRC_NAME
GST_AUDIO_ENCODER_SRC_PAD
gst_audio_encoder_finish_frame
gst_audio_encoder_get_audio_info
gst_audio_encoder_get_frame_max
gst_audio_encoder_get_frame_samples
gst_audio_encoder_get_hard_resync
gst_audio_encoder_get_latency
gst_audio_encoder_get_lookahead
gst_audio_encoder_get_mark_granule
gst_audio_encoder_get_perfect_timestamp
gst_audio_encoder_get_tolerance
gst_audio_encoder_proxy_getcaps
gst_audio_encoder_set_frame_max
gst_audio_encoder_set_frame_samples
gst_audio_encoder_set_hard_resync
gst_audio_encoder_set_latency
gst_audio_encoder_set_lookahead
gst_audio_encoder_set_mark_granule
gst_audio_encoder_set_perfect_timestamp
gst_audio_encoder_set_tolerance
<SUBSECTION Standard>
GST_AUDIO_ENCODER
GST_AUDIO_ENCODER_CAST
GST_IS_AUDIO_ENCODER
GST_TYPE_AUDIO_ENCODER
gst_audio_encoder_get_type
GST_AUDIO_ENCODER_CLASS
GST_IS_AUDIO_ENCODER_CLASS
GST_AUDIO_ENCODER_GET_CLASS
GstAudioEncoderPrivate
</SECTION>
<SECTION> <SECTION>
<FILE>gstaudiofilter</FILE> <FILE>gstaudiofilter</FILE>
<INCLUDE>gst/audio/gstaudiofilter.h</INCLUDE> <INCLUDE>gst/audio/gstaudiofilter.h</INCLUDE>

View file

@ -3,6 +3,10 @@
#include <gst/audio/gstaudioclock.h> #include <gst/audio/gstaudioclock.h>
gst_audio_clock_get_type gst_audio_clock_get_type
#include <gst/audio/gstaudiodecoder.h>
gst_audio_decoder_get_type
#include <gst/audio/gstaudioencoder.h>
gst_audio_encoder_get_type
#include <gst/audio/gstaudiofilter.h> #include <gst/audio/gstaudiofilter.h>
gst_audio_filter_get_type gst_audio_filter_get_type
#include <gst/audio/gstaudiosink.h> #include <gst/audio/gstaudiosink.h>

View file

@ -2116,10 +2116,11 @@ gst_audio_decoder_set_latency (GstAudioDecoder * dec,
/** /**
* gst_audio_decoder_get_latency: * gst_audio_decoder_get_latency:
* @dec: a #GstAudioDecoder * @dec: a #GstAudioDecoder
* @min: a pointer to storage to hold minimum latency * @min: (out) (allow-none): a pointer to storage to hold minimum latency
* @max: a pointer to storage to hold maximum latency * @max: (out) (allow-none): a pointer to storage to hold maximum latency
* *
* Returns currently configured latency. * Sets the variables pointed to by @min and @max to the currently configured
* latency.
* *
* Since: 0.10.36 * Since: 0.10.36
*/ */

View file

@ -101,18 +101,18 @@
* *
* In particular, base class will either favor tracking upstream timestamps * In particular, base class will either favor tracking upstream timestamps
* (at the possible expense of jitter) or aim to arrange for a perfect stream of * (at the possible expense of jitter) or aim to arrange for a perfect stream of
* output timestamps, depending on #GstAudioEncoder:perfect-ts. * output timestamps, depending on #GstAudioEncoder:perfect-timestamp.
* However, in the latter case, the input may not be so perfect or ideal, which * However, in the latter case, the input may not be so perfect or ideal, which
* is handled as follows. An input timestamp is compared with the expected * is handled as follows. An input timestamp is compared with the expected
* timestamp as dictated by input sample stream and if the deviation is less * timestamp as dictated by input sample stream and if the deviation is less
* than #GstAudioEncoder:tolerance, the deviation is discarded. * than #GstAudioEncoder:tolerance, the deviation is discarded.
* Otherwise, it is considered a discontuinity and subsequent output timestamp * Otherwise, it is considered a discontuinity and subsequent output timestamp
* is resynced to the new position after performing configured discontinuity * is resynced to the new position after performing configured discontinuity
* processing. In the non-perfect-ts case, an upstream variation exceeding * processing. In the non-perfect-timestamp case, an upstream variation
* tolerance only leads to marking DISCONT on subsequent outgoing * exceeding tolerance only leads to marking DISCONT on subsequent outgoing
* (while timestamps are adjusted to upstream regardless of variation). * (while timestamps are adjusted to upstream regardless of variation).
* While DISCONT is also marked in the perfect-ts case, this one optionally * While DISCONT is also marked in the perfect-timestamp case, this one
* (see #GstAudioEncoder:hard-resync) * optionally (see #GstAudioEncoder:hard-resync)
* performs some additional steps, such as clipping of (early) input samples * performs some additional steps, such as clipping of (early) input samples
* or draining all currently remaining input data, depending on the direction * or draining all currently remaining input data, depending on the direction
* of the discontuinity. * of the discontuinity.
@ -325,7 +325,7 @@ gst_audio_encoder_class_init (GstAudioEncoderClass * klass)
DEFAULT_PERFECT_TS, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS)); DEFAULT_PERFECT_TS, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
g_object_class_install_property (gobject_class, PROP_GRANULE, g_object_class_install_property (gobject_class, PROP_GRANULE,
g_param_spec_boolean ("mark-granule", "Granule Marking", g_param_spec_boolean ("mark-granule", "Granule Marking",
"Apply granule semantics to buffer metadata (implies perfect-ts)", "Apply granule semantics to buffer metadata (implies perfect-timestamp)",
DEFAULT_GRANULE, G_PARAM_READABLE | G_PARAM_STATIC_STRINGS)); DEFAULT_GRANULE, G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
g_object_class_install_property (gobject_class, PROP_HARD_RESYNC, g_object_class_install_property (gobject_class, PROP_HARD_RESYNC,
g_param_spec_boolean ("hard-resync", "Hard Resync", g_param_spec_boolean ("hard-resync", "Hard Resync",
@ -1470,7 +1470,8 @@ gst_audio_encoder_set_property (GObject * object, guint prop_id,
switch (prop_id) { switch (prop_id) {
case PROP_PERFECT_TS: case PROP_PERFECT_TS:
if (enc->priv->granule && !g_value_get_boolean (value)) if (enc->priv->granule && !g_value_get_boolean (value))
GST_WARNING_OBJECT (enc, "perfect-ts can not be set FALSE"); GST_WARNING_OBJECT (enc, "perfect-timestamp can not be set FALSE "
"while granule handling is enabled");
else else
enc->priv->perfect_ts = g_value_get_boolean (value); enc->priv->perfect_ts = g_value_get_boolean (value);
break; break;
@ -1705,10 +1706,11 @@ gst_audio_encoder_set_latency (GstAudioEncoder * enc,
/** /**
* gst_audio_encoder_get_latency: * gst_audio_encoder_get_latency:
* @enc: a #GstAudioEncoder * @enc: a #GstAudioEncoder
* @min: a pointer to storage to hold minimum latency * @min: (out) (allow-none): a pointer to storage to hold minimum latency
* @max: a pointer to storage to hold maximum latency * @max: (out) (allow-none): a pointer to storage to hold maximum latency
* *
* Returns currently configured latency. * Sets the variables pointed to by @min and @max to the currently configured
* latency.
* *
* Since: 0.10.36 * Since: 0.10.36
*/ */

View file

@ -128,10 +128,9 @@ struct _GstAudioEncoder {
* @set_format: Notifies subclass of incoming data format. * @set_format: Notifies subclass of incoming data format.
* GstAudioInfo contains the format according to provided caps. * GstAudioInfo contains the format according to provided caps.
* @handle_frame: Provides input samples (or NULL to clear any remaining data) * @handle_frame: Provides input samples (or NULL to clear any remaining data)
* according to directions as provided by subclass in the * according to directions as configured by the subclass
* #GstAudioEncoderContext. Input data ref management * using the API. Input data ref management is performed
* is performed by base class, subclass should not care or * by base class, subclass should not care or intervene.
* intervene.
* @flush: Optional. * @flush: Optional.
* Instructs subclass to clear any codec caches and discard * Instructs subclass to clear any codec caches and discard
* any pending samples and not yet returned encoded data. * any pending samples and not yet returned encoded data.