From b88deddeca5ed94c19baa5321d04447897a4840d Mon Sep 17 00:00:00 2001
From: Tim-Philipp Müller <tim@centricular.net>
Date: Thu, 27 Apr 2006 16:05:54 +0000
Subject: Add docs for both avidemux and avimux.

Original commit message from CVS:
* docs/plugins/Makefile.am:
* docs/plugins/gst-plugins-good-plugins-docs.sgml:
* docs/plugins/gst-plugins-good-plugins-sections.txt:
* docs/plugins/gst-plugins-good-plugins.hierarchy:
* docs/plugins/inspect/plugin-avi.xml:
* gst/avi/gstavidemux.c:
* gst/avi/gstavimux.c:
Add docs for both avidemux and avimux.
---
 gst/avi/gstavidemux.c | 24 ++++++++++++++++++++++++
 gst/avi/gstavimux.c   | 40 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 64 insertions(+)

(limited to 'gst')

diff --git a/gst/avi/gstavidemux.c b/gst/avi/gstavidemux.c
index cfbb4d2c..aa800145 100644
--- a/gst/avi/gstavidemux.c
+++ b/gst/avi/gstavidemux.c
@@ -18,6 +18,30 @@
  */
 /* Element-Checklist-Version: 5 */
 
+/**
+ * SECTION:element-avidemux
+ *
+ * <refsect2>
+ * <para>
+ * Demuxes an .avi file into raw or compressed audio and/or video streams.
+ * </para>
+ * <para>
+ * This element currently only supports pull-based scheduling. 
+ * </para>
+ * <title>Example launch line</title>
+ * <para>
+ * <programlisting>
+ * gst-launch filesrc test.avi ! avidemux name=demux  demux.audio_00 ! decodebin ! audioconvert ! audioresample ! autoaudiosink   demux.video_00 ! queue ! decodebin ! ffmpegcolorspace ! videoscale ! autovideosink
+ * </programlisting>
+ * Play (parse and decode) an .avi file and try to output it to
+ * an automatically detected soundcard and videosink. If the AVI file contains
+ * compressed audio or video data, this will only work if you have the
+ * right decoder elements/plugins installed.
+ * </para>
+ * </refsect2>
+ *
+ */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/gst/avi/gstavimux.c b/gst/avi/gstavimux.c
index ce8c4ab0..de070772 100644
--- a/gst/avi/gstavimux.c
+++ b/gst/avi/gstavimux.c
@@ -25,6 +25,46 @@
  * - openDML large-AVI docs
  */
 
+/**
+ * SECTION:element-avimux
+ *
+ * <refsect2>
+ * <para>
+ * Muxes raw or compressed audio and/or video streams into an AVI file.
+ * </para>
+ * <title>Example launch line</title>
+ * <para>
+ * (write everything in one line, without the backslash characters)
+ * <programlisting>
+ * gst-launch-0.10 videotestsrc num-buffers=250 \
+ * ! 'video/x-raw-yuv,format=(fourcc)I420,width=320,height=240,framerate=(fraction)25/1' \
+ * ! queue ! mux. \
+ * audiotestsrc num-buffers=440 ! audioconvert \
+ * ! 'audio/x-raw-int,rate=44100,channels=2' ! queue ! mux. \
+ * avimux name=mux ! filesink location=test.avi
+ * </programlisting>
+ * This will create an .AVI file containing an uncompressed video stream
+ * with a test picture and an uncompressed audio stream containing a 
+ * test sound.
+ * </para>
+ * <title>Another example launch line</title>
+ * <para>
+ * (write everything in one line, without the backslash characters)
+ * <programlisting>
+ * gst-launch-0.10 videotestsrc num-buffers=250 \
+ * ! 'video/x-raw-yuv,format=(fourcc)I420,width=320,height=240,framerate=(fraction)25/1' \
+ * ! xvidenc ! queue ! mux. \
+ * audiotestsrc num-buffers=440 ! audioconvert ! 'audio/x-raw-int,rate=44100,channels=2' \
+ * ! lame ! queue ! mux. \
+ * avimux name=mux ! filesink location=test.avi
+ * </programlisting>
+ * This will create an .AVI file containing the same test video and sound
+ * as above, only that both streams will be compressed this time. This will
+ * only work if you have the necessary encoder elements installed of course.
+ * </para>
+ * </refsect2>
+ *
+ */
 
 #ifdef HAVE_CONFIG_H
 #include "config.h"
-- 
cgit