docs: doc fixes for audio library

Add sections docs for audiometa. Fix sections docs for audiochannels. Remove old
mixerutil section.
This commit is contained in:
Stefan Sauer 2014-01-31 23:27:03 +01:00
parent c9b493b853
commit 76ec6d3760
4 changed files with 13 additions and 12 deletions

View file

@ -59,7 +59,6 @@
<xi:include href="xml/gstaudiodecoder.xml" />
<xi:include href="xml/gstaudioencoder.xml" />
<xi:include href="xml/gstaudiofilter.xml" />
<xi:include href="xml/gstaudiomixerutils.xml" />
<xi:include href="xml/gstaudiosink.xml" />
<xi:include href="xml/gstaudiosrc.xml" />
<xi:include href="xml/gstaudiobasesink.xml" />

View file

@ -372,13 +372,6 @@ GST_AUDIO_FILTER_INFO
GST_AUDIO_FILTER_RATE
</SECTION>
<SECTION>
<FILE>gstaudiomixerutils</FILE>
<INCLUDE>gst/audio/mixerutils.h</INCLUDE>
GstAudioMixerFilterFunc
gst_audio_default_registry_mixer_filter
</SECTION>
<SECTION>
<FILE>gstaudiosink</FILE>
<INCLUDE>gst/audio/gstaudiosink.h</INCLUDE>

View file

@ -17,10 +17,10 @@
* Boston, MA 02110-1301, USA.
*/
/**
* SECTION:gstaudio
* @short_description: Support library for audio elements
* SECTION:gstaudiochannels
* @short_description: Support library for audio channel handling
*
* This library contains some helper functions for audio elements.
* This library contains some helper functions for multichannel audio.
*/
#ifdef HAVE_CONFIG_H

View file

@ -17,6 +17,15 @@
* Boston, MA 02110-1301, USA.
*/
/**
* SECTION:gstaudiometa
* @short_description: Buffer metadata for audio downmix matrix handling
*
* #GstAudioDownmixMeta defines an audio downmix matrix to be send along with
* audio buffers. These functions in this module help to create and attach the
* meta as well as extracting it.
*/
#include <string.h>
#include "gstaudiometa.h"
@ -103,7 +112,7 @@ gst_buffer_get_audio_downmix_meta_for_channels (GstBuffer * buffer,
* @to_channels: The number of channels of the destination
* @matrix: The matrix coefficients.
*
* Attaches GstAudioDownmixMeta metadata to @buffer with the given parameters.
* Attaches #GstAudioDownmixMeta metadata to @buffer with the given parameters.
*
* @matrix is an two-dimensional array of @to_channels times @from_channels
* coefficients, i.e. the i-th output channels is constructed by multiplicating