diff options
| -rw-r--r-- | ChangeLog | 6 | ||||
| -rw-r--r-- | ext/taglib/gsttaglib.cc | 28 |
2 files changed, 33 insertions, 1 deletions
@@ -1,5 +1,11 @@ 2006-03-13 Tim-Philipp Müller <tim at centricular dot net> + * 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) + +2006-03-13 Tim-Philipp Müller <tim at centricular dot net> + Patch by: Mikhail Zabaluev <mhz altlinux org> * autogen.sh: diff --git a/ext/taglib/gsttaglib.cc b/ext/taglib/gsttaglib.cc index 79cea0062..99af3eeb6 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 + * + * <refsect2> + * <para> + * 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). + * </para> + * <para> + * 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). + * </para> + * <para> + * 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: + * <programlisting> + * gst-launch -v filesrc location=foo.ogg ! decodebin ! audioconvert ! lame ! tagid3v2mux ! filesink location=foo.mp3 + * </programlisting> + * </para> + * </refsect2> + */ + #ifdef HAVE_CONFIG_H #include <config.h> @@ -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) |