diff options
author | Tim-Philipp Müller <tim@centricular.net> | 2006-05-03 13:20:41 +0000 |
---|---|---|
committer | Tim-Philipp Müller <tim@centricular.net> | 2006-05-03 13:20:41 +0000 |
commit | 721644986bb9a5f26bc29f40933ad05ae0d712a0 (patch) | |
tree | 2b648c8ca8abdbba5146ffad7fabc11ba2973f04 /ext/musicbrainz | |
parent | 617c0c0e0576850816b2f595196278c477cd42ad (diff) | |
download | gst-plugins-bad-721644986bb9a5f26bc29f40933ad05ae0d712a0.tar.gz gst-plugins-bad-721644986bb9a5f26bc29f40933ad05ae0d712a0.tar.bz2 gst-plugins-bad-721644986bb9a5f26bc29f40933ad05ae0d712a0.zip |
Everybody loves docs - add docs for musicbrainz plugin.
Original commit message from CVS:
* 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.
Diffstat (limited to 'ext/musicbrainz')
-rw-r--r-- | ext/musicbrainz/gsttrm.c | 36 | ||||
-rw-r--r-- | ext/musicbrainz/gsttrm.h | 8 |
2 files changed, 44 insertions, 0 deletions
diff --git a/ext/musicbrainz/gsttrm.c b/ext/musicbrainz/gsttrm.c index 90e93962..4732d73f 100644 --- a/ext/musicbrainz/gsttrm.c +++ b/ext/musicbrainz/gsttrm.c @@ -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> + * <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. + * </para> + * <para> + * 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. + * </para> + * <para> + * 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). + * </para> + * <title>Example pipeline</title> + * <para> + * 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. + * </para> + * </refsect2> + */ + + #ifdef HAVE_CONFIG_H #include "config.h" #endif diff --git a/ext/musicbrainz/gsttrm.h b/ext/musicbrainz/gsttrm.h index 9194180c..d66e3567 100644 --- a/ext/musicbrainz/gsttrm.h +++ b/ext/musicbrainz/gsttrm.h @@ -38,9 +38,17 @@ G_BEGIN_DECLS 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; |