Menu
▾
▴
[gst-cvs] tpm gst-plugins-bad: gst-plugins-bad/ gst-plugins-bad/docs/plugins/ gst-plugins-bad/docs/plugins/inspect/ gst-plugins-bad/ext/musicbrainz/
|
From: <tp...@ke...> - 2006-05-03 13:21:05
|
CVS Root: /cvs/gstreamer
Module: gst-plugins-bad
Changes by: tpm
Date: Wed May 03 2006 13:20:53 UTC
Log message:
* docs/plugins/Makefile.am:
* docs/plugins/gst-plugins-bad-plugins-docs.sgml:
* docs/plugins/gst-plugins-bad-plugins-sections.txt:
* docs/plugins/gst-plugins-bad-plugins.hierarchy:
* docs/plugins/inspect/plugin-musicbrainz.xml:
* ext/musicbrainz/gsttrm.c:
* ext/musicbrainz/gsttrm.h:
Everybody loves docs - add docs for musicbrainz plugin.
Modified files:
. : ChangeLog
docs/plugins : Makefile.am gst-plugins-bad-plugins-docs.sgml
gst-plugins-bad-plugins-sections.txt
gst-plugins-bad-plugins.hierarchy
ext/musicbrainz : gsttrm.c gsttrm.h
Added files:
docs/plugins/inspect: plugin-musicbrainz.xml
Links:
http://freedesktop.org/cgi-bin/viewcvs.cgi/gstreamer/gst-plugins-bad/ChangeLog.diff?r1=1.2096&r2=1.2097
http://freedesktop.org/cgi-bin/viewcvs.cgi/gstreamer/gst-plugins-bad/docs/plugins/Makefile.am.diff?r1=1.4&r2=1.5
http://freedesktop.org/cgi-bin/viewcvs.cgi/gstreamer/gst-plugins-bad/docs/plugins/gst-plugins-bad-plugins-docs.sgml.diff?r1=1.8&r2=1.9
http://freedesktop.org/cgi-bin/viewcvs.cgi/gstreamer/gst-plugins-bad/docs/plugins/gst-plugins-bad-plugins-sections.txt.diff?r1=1.4&r2=1.5
http://freedesktop.org/cgi-bin/viewcvs.cgi/gstreamer/gst-plugins-bad/docs/plugins/gst-plugins-bad-plugins.hierarchy.diff?r1=1.1&r2=1.2
http://freedesktop.org/cgi-bin/viewcvs.cgi/gstreamer/gst-plugins-bad/docs/plugins/inspect/plugin-musicbrainz.xml?rev=1.1&content-type=text/vnd.viewcvs-markup
http://freedesktop.org/cgi-bin/viewcvs.cgi/gstreamer/gst-plugins-bad/ext/musicbrainz/gsttrm.c.diff?r1=1.17&r2=1.18
http://freedesktop.org/cgi-bin/viewcvs.cgi/gstreamer/gst-plugins-bad/ext/musicbrainz/gsttrm.h.diff?r1=1.5&r2=1.6
====Begin Diffs====
Index: ChangeLog
===================================================================
RCS file: /cvs/gstreamer/gst-plugins-bad/ChangeLog,v
retrieving revision 1.2096
retrieving revision 1.2097
diff -u -d -r1.2096 -r1.2097
--- ChangeLog 3 May 2006 12:01:43 -0000 1.2096
+++ ChangeLog 3 May 2006 13:20:41 -0000 1.2097
@@ -1,5 +1,16 @@
2006-05-03 Tim-Philipp Müller <tim at centricular dot net>
+ * docs/plugins/Makefile.am:
+ * docs/plugins/gst-plugins-bad-plugins-docs.sgml:
+ * docs/plugins/gst-plugins-bad-plugins-sections.txt:
+ * docs/plugins/gst-plugins-bad-plugins.hierarchy:
+ * docs/plugins/inspect/plugin-musicbrainz.xml:
+ * ext/musicbrainz/gsttrm.c:
+ * ext/musicbrainz/gsttrm.h:
+ Everybody loves docs - add docs for musicbrainz plugin.
+
+2006-05-03 Tim-Philipp Müller <tim at centricular dot net>
* ext/Makefile.am:
Add musicbrainz dir to DIST_SUBDIRS as well (fixes distcheck).
Index: Makefile.am
RCS file: /cvs/gstreamer/gst-plugins-bad/docs/plugins/Makefile.am,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- Makefile.am 1 May 2006 17:58:37 -0000 1.4
+++ Makefile.am 3 May 2006 13:20:41 -0000 1.5
@@ -86,7 +86,8 @@
$(top_srcdir)/ext/directfb/dfb-example.c
EXTRA_HFILES = \
- $(top_srcdir)/ext/directfb/dfbvideosink.h
+ $(top_srcdir)/ext/directfb/dfbvideosink.h \
+ $(top_srcdir)/ext/musicbrainz/gsttrm.h
# Images to copy into HTML directory.
HTML_IMAGES =
Index: gst-plugins-bad-plugins-docs.sgml
RCS file: /cvs/gstreamer/gst-plugins-bad/docs/plugins/gst-plugins-bad-plugins-docs.sgml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -d -r1.8 -r1.9
--- gst-plugins-bad-plugins-docs.sgml 1 May 2006 17:58:37 -0000 1.8
+++ gst-plugins-bad-plugins-docs.sgml 3 May 2006 13:20:41 -0000 1.9
@@ -14,6 +14,7 @@
<title>gst-plugins-bad Elements</title>
<xi:include href="xml/element-dfbvideosink.xml" />
+ <xi:include href="xml/element-trm.xml" />
</chapter>
<chapter>
@@ -27,6 +28,7 @@
<xi:include href="xml/plugin-glimagesink.xml" />
<xi:include href="xml/plugin-gsm.xml" />
<xi:include href="xml/plugin-modplug.xml" />
+ <xi:include href="xml/plugin-musicbrainz.xml" />
<xi:include href="xml/plugin-neon.xml" />
<xi:include href="xml/plugin-qtdemux.xml" />
<xi:include href="xml/plugin-sdlvideosink.xml" />
Index: gst-plugins-bad-plugins-sections.txt
RCS file: /cvs/gstreamer/gst-plugins-bad/docs/plugins/gst-plugins-bad-plugins-sections.txt,v
--- gst-plugins-bad-plugins-sections.txt 1 May 2006 17:58:37 -0000 1.4
+++ gst-plugins-bad-plugins-sections.txt 3 May 2006 13:20:41 -0000 1.5
@@ -5,3 +5,11 @@
<SUBSECTION Standard>
GstDfbVideoSinkClass
</SECTION>
+<SECTION>
+<FILE>element-trm</FILE>
+GstTRM
+<TITLE>trm</TITLE>
+<SUBSECTION Standard>
+GstTRMClass
+</SECTION>
Index: gst-plugins-bad-plugins.hierarchy
RCS file: /cvs/gstreamer/gst-plugins-bad/docs/plugins/gst-plugins-bad-plugins.hierarchy,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- gst-plugins-bad-plugins.hierarchy 6 Nov 2005 21:55:01 -0000 1.1
+++ gst-plugins-bad-plugins.hierarchy 3 May 2006 13:20:41 -0000 1.2
@@ -12,6 +12,7 @@
GstBaseSink
GstVideoSink
GstDfbVideoSink
+ GstTRM
GstPlugin
GstRegistry
GstPadTemplate
--- NEW FILE: plugin-musicbrainz.xml ---
<plugin>
<name>musicbrainz</name>
<description>A TRM signature producer based on libmusicbrainz</description>
<filename>../../ext/musicbrainz/.libs/libgsttrm.so</filename>
<basename>libgsttrm.so</basename>
<version>0.10.2.1</version>
<license>LGPL</license>
<source>gst-plugins-bad</source>
<package>GStreamer Bad Plug-ins CVS/prerelease</package>
<origin>Unknown package origin</origin>
<elements>
<element>
<name>trm</name>
<longname>MusicBrainz TRM generator</longname>
<class>Filter/Analyzer/Audio</class>
<description>Compute MusicBrainz TRM Id using libmusicbrainz</description>
<author>Jeremy Simon <jsi...@ya...></author>
</element>
</elements>
</plugin>Index: gsttrm.c
RCS file: /cvs/gstreamer/gst-plugins-bad/ext/musicbrainz/gsttrm.c,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -d -r1.17 -r1.18
--- gsttrm.c 3 May 2006 11:27:42 -0000 1.17
+++ gsttrm.c 3 May 2006 13:20:41 -0000 1.18
@@ -18,6 +18,42 @@
* Boston, MA 02111-1307, USA.
*/
+/**
+ * SECTION:element-trm
+ *
+ * <refsect2>
+ * <para>
+ * GstTRM computes <ulink url="http://www.musicbrainz.org/">MusicBrainz</ulink>
+ * TRM identifiers for audio streams using libmusicbrainz.
+ * </para>
+ * A TRM identifier is something like an 'acoustic fingerprint', the aim is
+ * to uniquely identify the same song regardless of which source it comes from
+ * or which audio format the stream is in.
+ * The TRM element will collect about 30 seconds of audio and let
+ * libmusicbrainz calculate a preliminary audio signature from that. That audio
+ * signature will then be sent over the internet to a musicbrainz.org server
+ * which will calculate the TRM for that signature.
+ * The TRM element will post a tag message with a #GST_TAG_MUSICBRAINZ_TRMID
+ * tag on the bus once the TRM has been calculated (and also send a tag event
+ * with that information downstream).
+ * <title>Example pipeline</title>
+ * Here is a test pipeline to test the TRM element:
+ * <programlisting>
+ * gst-launch -m filesrc location=somefile.ogg ! decodebin ! audioconvert ! trm ! fakesink
+ * </programlisting>
+ * this should (among many other things) print the tag message with the TRM ID.
+ * </refsect2>
+ */
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
Index: gsttrm.h
RCS file: /cvs/gstreamer/gst-plugins-bad/ext/musicbrainz/gsttrm.h,v
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- gsttrm.h 3 May 2006 11:27:42 -0000 1.5
+++ gsttrm.h 3 May 2006 13:20:41 -0000 1.6
@@ -38,9 +38,17 @@
typedef struct _GstTRM GstTRM;
typedef struct _GstTRMClass GstTRMClass;
+ * GstTRM
+ * GStreamer TRM element. This structure is opaque (private).
+ **/
struct _GstTRM {
GstElement element;
+ /*< private >*/
GstPad *sinkpad;
GstPad *srcpad;
|