<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>metadatademux</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
<link rel="home" href="index.html" title="GStreamer Bad Plugins 0.10 Plugins Reference Manual">
<link rel="up" href="ch01.html" title="gst-plugins-bad Elements">
<link rel="prev" href="gst-plugins-bad-plugins-liveadder.html" title="liveadder">
<link rel="next" href="gst-plugins-bad-plugins-metadatamux.html" title="metadatamux">
<meta name="generator" content="GTK-Doc V1.13 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="ch01.html" title="gst-plugins-bad Elements">
<link rel="chapter" href="ch02.html" title="gst-plugins-bad Plugins">
<link rel="chapter" href="ch03.html" title="gst-plugins-bad Classes">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="gst-plugins-bad-plugins-liveadder.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GStreamer Bad Plugins 0.10 Plugins Reference Manual</th>
<td><a accesskey="n" href="gst-plugins-bad-plugins-metadatamux.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#gst-plugins-bad-plugins-metadatademux.synopsis" class="shortcut">Top</a>
|
<a href="#gst-plugins-bad-plugins-metadatademux.description" class="shortcut">Description</a>
|
<a href="#gst-plugins-bad-plugins-metadatademux.object-hierarchy" class="shortcut">Object Hierarchy</a>
|
<a href="#gst-plugins-bad-plugins-metadatademux.properties" class="shortcut">Properties</a>
</td></tr>
</table>
<div class="refentry" title="metadatademux">
<a name="gst-plugins-bad-plugins-metadatademux"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="gst-plugins-bad-plugins-metadatademux.top_of_page"></a>metadatademux</span></h2>
<p>metadatademux — Send metadata tags (EXIF, IPTC and XMP) and remove metadata chunks from stream</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv" title="Synopsis">
<a name="gst-plugins-bad-plugins-metadatademux.synopsis"></a><h2>Synopsis</h2>
<a name="GstMetadataDemux"></a><pre class="synopsis"> <a class="link" href="gst-plugins-bad-plugins-metadatademux.html#GstMetadataDemux-struct" title="GstMetadataDemux">GstMetadataDemux</a>;
</pre>
</div>
<div class="refsect1" title="Object Hierarchy">
<a name="gst-plugins-bad-plugins-metadatademux.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
+----<a href="/usr/share/gtk-doc/html/gstreamer-0.10/GstObject.html">GstObject</a>
+----<a href="/usr/share/gtk-doc/html/gstreamer-0.10/GstElement.html">GstElement</a>
+----<a class="link" href="GstBaseMetadata.html" title="GstBaseMetadata">GstBaseMetadata</a>
+----GstMetadataDemux
</pre>
</div>
<div class="refsect1" title="Properties">
<a name="gst-plugins-bad-plugins-metadatademux.properties"></a><h2>Properties</h2>
<pre class="synopsis">
"<a class="link" href="gst-plugins-bad-plugins-metadatademux.html#GstMetadataDemux--parse-only" title='The "parse-only" property'>parse-only</a>" <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write
</pre>
</div>
<div class="refsect1" title="Description">
<a name="gst-plugins-bad-plugins-metadatademux.description"></a><h2>Description</h2>
<p>
</p>
<div class="refsect2" title="Example launch line">
<a name="id393899"></a><h3>Example launch line</h3>
<p>
This element parses image files JPEG and PNG, to find metadata chunks (EXIF,
IPTC, XMP) in it, and then send individual tags as a 'tag message' do the
application and as 'tag event' to the next element in pipeline. It also
strips out the metadata chunks from original stream (unless the 'parse-only'
property is set to 'true'). In addition the whole metadata chunk (striped
or not) it also sent as a message to the application bus, so the application
can have more controls about the metadata.
</p>
<p>
</p>
<pre class="programlisting">
gst-launch -v -m filesrc location=./test.jpeg ! metadatademux ! fakesink
silent=TRUE
</pre>
<p>
</p>
<pre class="programlisting">
GST_DEBUG:*metadata:5 gst-launch filesrc location=./test.jpeg !
metadatademux ! fakesink
</pre>
<p>
</p>
<p>
</p>
<pre class="programlisting">
val = gst_tag_list_get_value_index (taglist, GST_TAG_EXIF, 0);
if (val) {
exif_chunk = gst_value_get_buffer (val);
if (exif_chunk) {
ed = exif_data_new_from_data (GST_BUFFER_DATA (exif_chunk),
GST_BUFFER_SIZE (exif_chunk));
}
}
</pre>
<p>
This same idea can be used to handle IPTC and XMP directly by using
libdata and exempi (or any other libraries). Notice: the whole metadata
chunk sent as a message to the application contains only metadata data, i.e.
the wrapper specific to the file format (JPEG, PNG, ...) is already
striped out.
</p>
</div>
</div>
<div class="refsect1" title="Details">
<a name="gst-plugins-bad-plugins-metadatademux.details"></a><h2>Details</h2>
<div class="refsect2" title="GstMetadataDemux">
<a name="GstMetadataDemux-struct"></a><h3>GstMetadataDemux</h3>
<pre class="programlisting">typedef struct _GstMetadataDemux GstMetadataDemux;</pre>
<p>
The opaque <a class="link" href="gst-plugins-bad-plugins-metadatademux.html#GstMetadataDemux"><span class="type">GstMetadataDemux</span></a> data structure.</p>
</div>
</div>
<div class="refsect1" title="Property Details">
<a name="gst-plugins-bad-plugins-metadatademux.property-details"></a><h2>Property Details</h2>
<div class="refsect2" title='The "parse-only" property'>
<a name="GstMetadataDemux--parse-only"></a><h3>The <code class="literal">"parse-only"</code> property</h3>
<pre class="programlisting"> "parse-only" <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
<p>If TRUE, don't strip out any chunk.</p>
<p>Default value: FALSE</p>
</div>
</div>
<div class="refsect1" title="See Also">
<a name="gst-plugins-bad-plugins-metadatademux.see-also"></a><h2>See Also</h2>
<span class="type">metadatamux</span>
</div>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.13</div>
</body>
</html>
