From aab9a093104fe3f6b9755ca41090f4b887e9d9c2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tim-Philipp=20M=C3=BCller?= Date: Mon, 13 Mar 2006 17:22:19 +0000 Subject: ext/taglib/gsttaglib.cc: Add gtk-doc blurb (unused for the time being); match registered plugin name to the filename ... Original commit message from CVS: * ext/taglib/gsttaglib.cc: Add gtk-doc blurb (unused for the time being); match registered plugin name to the filename of the plugin (taglibmux => taglib) --- ext/taglib/gsttaglib.cc | 28 +++++++++++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) (limited to 'ext/taglib/gsttaglib.cc') diff --git a/ext/taglib/gsttaglib.cc b/ext/taglib/gsttaglib.cc index 79cea006..99af3eeb 100644 --- a/ext/taglib/gsttaglib.cc +++ b/ext/taglib/gsttaglib.cc @@ -17,6 +17,32 @@ * Boston, MA 02111-1307, USA. */ +/** + * SECTION:element-tagid3v2mux + * @see_also: #GstID3Demux, #GstTagSetter + * + * + * + * This element adds ID3v2 tags to the beginning of a stream using the taglib + * library. More precisely, the tags written are ID3 version 2.4.0 tags (which + * means in practice that some hardware players or outdated programs might not + * be able to read them properly). + * + * + * Applications can set the tags to write using the #GstTagSetter interface. + * Tags sent by upstream elements will be picked up automatically (and merged + * according to the merge mode set via the tag setter interface). + * + * + * Here is a simple pipeline that transcodes a file from Ogg/Vorbis to mp3 + * format with an ID3v2 that contains the same as the the Ogg/Vorbis file: + * + * gst-launch -v filesrc location=foo.ogg ! decodebin ! audioconvert ! lame ! tagid3v2mux ! filesink location=foo.mp3 + * + * + * + */ + #ifdef HAVE_CONFIG_H #include @@ -531,6 +557,6 @@ plugin_init (GstPlugin * plugin) GST_PLUGIN_DEFINE (GST_VERSION_MAJOR, GST_VERSION_MINOR, - "taglibmux", + "taglib", "Tag-writing plug-in based on taglib", plugin_init, VERSION, "LGPL", GST_PACKAGE, GST_ORIGIN) -- cgit v1.2.1