2006-02-06 Tim-Philipp Müller <tim at centricular dot net>
+ * docs/plugins/Makefile.am:
+ * docs/plugins/gst-plugins-good-plugins-docs.sgml:
+ * docs/plugins/gst-plugins-good-plugins-sections.txt:
+ * docs/plugins/inspect/plugin-cdio.xml:
+ Add cdio plugin to docs.
+
+ * ext/cdio/gstcdiocddasrc.c:
+ Add gtk-doc blurb.
+
+ * ext/cdio/gstcdio.c:
+ The plugin is called 'cdio' not 'cddio'.
+
+2006-02-06 Tim-Philipp Müller <tim at centricular dot net>
+
* configure.ac:
* docs/plugins/Makefile.am:
* docs/plugins/gst-plugins-good-plugins-docs.sgml:
$(top_srcdir)/gst/goom/gstgoom.h \
$(top_srcdir)/gst/id3demux/gstid3demux.h \
$(top_srcdir)/ext/cairo/gsttimeoverlay.h \
+ $(top_srcdir)/ext/cdio/gstcdiocddasrc.h \
$(top_srcdir)/ext/flac/gstflacdec.h \
$(top_srcdir)/gst/multipart/multipartmux.c \
$(top_srcdir)/gst/multipart/multipartdemux.c \
<xi:include href="xml/element-autoaudiosink.xml" />
<xi:include href="xml/element-autovideosink.xml" />
<xi:include href="xml/element-cairotimeoverlay.xml" />
+ <xi:include href="xml/element-cdiocddasrc.xml" />
<xi:include href="xml/element-flacdec.xml" />
<xi:include href="xml/element-goom.xml" />
<xi:include href="xml/element-id3demux.xml" />
<xi:include href="xml/plugin-avi.xml" />
<xi:include href="xml/plugin-cacasink.xml" />
<xi:include href="xml/plugin-cairo.xml" />
+ <xi:include href="xml/plugin-cdio.xml" />
<xi:include href="xml/plugin-cutter.xml" />
<xi:include href="xml/plugin-debug.xml" />
<xi:include href="xml/plugin-dv.xml" />
</SECTION>
<SECTION>
+<FILE>element-cdiocddasrc</FILE>
+GstCdioCddaSrc
+<TITLE>cdiocddasrc</TITLE>
+<SUBSECTION Standard>
+GstCdioCddaSrcClass
+</SECTION>
+
+<SECTION>
<FILE>element-flacdec</FILE>
GstFlacDec
<TITLE>flacdec</TITLE>
--- /dev/null
+<plugin>
+ <name>cdio</name>
+ <description>Read audio from audio CDs</description>
+ <filename>../../ext/cdio/.libs/libgstcdio.so</filename>
+ <basename>libgstcdio.so</basename>
+ <version>0.10.1.1</version>
+ <license>GPL</license>
+ <source>gst-plugins-good</source>
+ <package>GStreamer Good Plug-ins CVS/prerelease</package>
+ <origin>Unknown package origin</origin>
+ <elements>
+ <element>
+ <name>cdiocddasrc</name>
+ <longname>CD Audio (cdda) Source</longname>
+ <class>Source/File</class>
+ <description>Read audio from CD using libcdio</description>
+ <author>Tim-Philipp Müller <tim centricular net></author>
+ </element>
+ </elements>
+</plugin>
\ No newline at end of file
GST_PLUGIN_DEFINE (GST_VERSION_MAJOR,
GST_VERSION_MINOR,
- "cddio",
+ "cdio",
"Read audio from audio CDs",
plugin_init, VERSION, "GPL", GST_PACKAGE_NAME, GST_PACKAGE_ORIGIN)
* Boston, MA 02111-1307, USA.
*/
+/**
+ * SECTION:element-cdiocddasrc
+ * @short_description: Reads raw audio from an Audio CD
+ * @see_also: GstCdParanoiaSrc, GstCddaBaseSrc
+ *
+ * <refsect2>
+ * <para>
+ * cdiocddasrc reads and extracts raw audio from Audio CDs. It can operate
+ * in one of two modes:
+ * <itemizedlist>
+ * <listitem><para>
+ * treat each track as a separate stream, counting time from the start
+ * of the track to the end of the track and posting EOS at the end of
+ * a track, or
+ * </para></listitem>
+ * <listitem><para>
+ * treat the entire disc as one stream, counting time from the start of
+ * the first track to the end of the last track, posting EOS only at
+ * the end of the last track.
+ * </para></listitem>
+ * </itemizedlist>
+ * </para>
+ * <para>
+ * With a recent-enough version of libcdio, the element will extract
+ * CD-TEXT if this is supported by the CD-drive and CD-TEXT information
+ * is available on the CD. The information will be posted on the bus in
+ * form of a tag message.
+ * </para>
+ * <para>
+ * When opened, the element will also calculate a CDDB disc ID and a
+ * MusicBrainz disc ID, which applications can use to query online
+ * databases for artist/title information. These disc IDs will also be
+ * posted on the bus as part of the tag messages.
+ * </para>
+ * <para>
+ * cdiocddasrc supports the GstUriHandler interface, so applications can use
+ * playbin with cdda://<track-number> URIs for playback (they will have
+ * to connect to playbin's notify::source signal and set the device on the
+ * cd source in the notify callback if they want to set the device property).
+ * Applications should use seeks in "track" format to switch between different
+ * tracks of the same CD (passing a new cdda:// URI to playbin involves opening
+ * and closing the CD device, which is much slower).
+ * </para>
+ * <title>Example launch line</title>
+ * <para>
+ * <programlisting>
+ * gst-launch cdiocddasrc track=5 device=/dev/cdrom ! audioconvert ! vorbisenc ! oggmux ! filesink location=track5.ogg
+ * </programlisting>
+ * This pipeline extracts track 5 of the audio CD and encodes it into an
+ * Ogg/Vorbis file.
+ * </para>
+ * </refsect2>
+ */
+
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif