~sipe-collab/sipe-collab/gstreamer-plugins-base

« back to all changes in this revision

Viewing changes to docs/libs/html/gst-plugins-base-libs-gsttag.html

  • Committer: Sebastian Dröge
  • Date: 2014-04-19 13:47:47 UTC
  • mfrom: (1.1.23)
  • Revision ID: git-v1:d06393f82dba0d5f13ec2e66275d75cf8178fe5c
Merge tag 'upstream/1.2.4'

Upstream version 1.2.4

Show diffs side-by-side

added added

removed removed

Lines of Context:
2
2
<html>
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
 
<title>gsttag</title>
 
5
<title>GStreamer Base Plugins 1.0 Library Reference Manual: gsttag</title>
6
6
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7
7
<link rel="home" href="index.html" title="GStreamer Base Plugins 1.0 Library Reference Manual">
8
8
<link rel="up" href="gstreamer-tag.html" title="Tag Support Library">
9
9
<link rel="prev" href="gstreamer-tag.html" title="Tag Support Library">
10
10
<link rel="next" href="gst-plugins-base-libs-gsttagvorbis.html" title="gsttagvorbis">
11
 
<meta name="generator" content="GTK-Doc V1.19 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.20 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
 
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
 
<tr valign="middle">
17
 
<td><a accesskey="p" href="gstreamer-tag.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
 
<td><a accesskey="u" href="gstreamer-tag.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
 
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
 
<th width="100%" align="center">GStreamer Base Plugins 1.0 Library Reference Manual</th>
21
 
<td><a accesskey="n" href="gst-plugins-base-libs-gsttagvorbis.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
 
</tr>
23
 
<tr><td colspan="5" class="shortcuts">
24
 
<a href="#gst-plugins-base-libs-gsttag.synopsis" class="shortcut">Top</a>
25
 
                   | 
26
 
                  <a href="#gst-plugins-base-libs-gsttag.description" class="shortcut">Description</a>
27
 
</td></tr>
28
 
</table>
 
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
 
16
<td width="100%" align="left" class="shortcuts">
 
17
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 
 
18
                  <a href="#gst-plugins-base-libs-gsttag.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 
 
19
                  <a href="#gst-plugins-base-libs-gsttag.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
 
20
</td>
 
21
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
 
22
<td><a accesskey="u" href="gstreamer-tag.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
 
23
<td><a accesskey="p" href="gstreamer-tag.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
 
24
<td><a accesskey="n" href="gst-plugins-base-libs-gsttagvorbis.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
 
25
</tr></table>
29
26
<div class="refentry">
30
27
<a name="gst-plugins-base-libs-gsttag"></a><div class="titlepage"></div>
31
28
<div class="refnamediv"><table width="100%"><tr>
33
30
<h2><span class="refentrytitle"><a name="gst-plugins-base-libs-gsttag.top_of_page"></a>gsttag</span></h2>
34
31
<p>gsttag — additional tag definitions for plugins and applications</p>
35
32
</td>
36
 
<td valign="top" align="right"></td>
 
33
<td class="gallery_image" valign="top" align="right"></td>
37
34
</tr></table></div>
38
 
<div class="refsynopsisdiv">
39
 
<a name="gst-plugins-base-libs-gsttag.synopsis"></a><h2>Synopsis</h2>
40
 
<pre class="synopsis">
41
 
#include &lt;gst/tag/tag.h&gt;
42
 
 
43
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-MUSICBRAINZ-TRACKID:CAPS" title="GST_TAG_MUSICBRAINZ_TRACKID">GST_TAG_MUSICBRAINZ_TRACKID</a>
44
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-MUSICBRAINZ-ARTISTID:CAPS" title="GST_TAG_MUSICBRAINZ_ARTISTID">GST_TAG_MUSICBRAINZ_ARTISTID</a>
45
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-MUSICBRAINZ-ALBUMID:CAPS" title="GST_TAG_MUSICBRAINZ_ALBUMID">GST_TAG_MUSICBRAINZ_ALBUMID</a>
46
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-MUSICBRAINZ-ALBUMARTISTID:CAPS" title="GST_TAG_MUSICBRAINZ_ALBUMARTISTID">GST_TAG_MUSICBRAINZ_ALBUMARTISTID</a>
47
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-MUSICBRAINZ-TRMID:CAPS" title="GST_TAG_MUSICBRAINZ_TRMID">GST_TAG_MUSICBRAINZ_TRMID</a>
48
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CDDA-CDDB-DISCID:CAPS" title="GST_TAG_CDDA_CDDB_DISCID">GST_TAG_CDDA_CDDB_DISCID</a>
49
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CDDA-CDDB-DISCID-FULL:CAPS" title="GST_TAG_CDDA_CDDB_DISCID_FULL">GST_TAG_CDDA_CDDB_DISCID_FULL</a>
50
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CDDA-MUSICBRAINZ-DISCID:CAPS" title="GST_TAG_CDDA_MUSICBRAINZ_DISCID">GST_TAG_CDDA_MUSICBRAINZ_DISCID</a>
51
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CDDA-MUSICBRAINZ-DISCID-FULL:CAPS" title="GST_TAG_CDDA_MUSICBRAINZ_DISCID_FULL">GST_TAG_CDDA_MUSICBRAINZ_DISCID_FULL</a>
52
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CMML-CLIP:CAPS" title="GST_TAG_CMML_CLIP">GST_TAG_CMML_CLIP</a>
53
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CMML-HEAD:CAPS" title="GST_TAG_CMML_HEAD">GST_TAG_CMML_HEAD</a>
54
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CMML-STREAM:CAPS" title="GST_TAG_CMML_STREAM">GST_TAG_CMML_STREAM</a>
55
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-SHUTTER-SPEED:CAPS" title="GST_TAG_CAPTURING_SHUTTER_SPEED">GST_TAG_CAPTURING_SHUTTER_SPEED</a>
56
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-FOCAL-RATIO:CAPS" title="GST_TAG_CAPTURING_FOCAL_RATIO">GST_TAG_CAPTURING_FOCAL_RATIO</a>
57
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-FOCAL-LENGTH:CAPS" title="GST_TAG_CAPTURING_FOCAL_LENGTH">GST_TAG_CAPTURING_FOCAL_LENGTH</a>
58
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-DIGITAL-ZOOM-RATIO:CAPS" title="GST_TAG_CAPTURING_DIGITAL_ZOOM_RATIO">GST_TAG_CAPTURING_DIGITAL_ZOOM_RATIO</a>
59
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-ISO-SPEED:CAPS" title="GST_TAG_CAPTURING_ISO_SPEED">GST_TAG_CAPTURING_ISO_SPEED</a>
60
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-EXPOSURE-PROGRAM:CAPS" title="GST_TAG_CAPTURING_EXPOSURE_PROGRAM">GST_TAG_CAPTURING_EXPOSURE_PROGRAM</a>
61
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-EXPOSURE-MODE:CAPS" title="GST_TAG_CAPTURING_EXPOSURE_MODE">GST_TAG_CAPTURING_EXPOSURE_MODE</a>
62
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-SCENE-CAPTURE-TYPE:CAPS" title="GST_TAG_CAPTURING_SCENE_CAPTURE_TYPE">GST_TAG_CAPTURING_SCENE_CAPTURE_TYPE</a>
63
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-GAIN-ADJUSTMENT:CAPS" title="GST_TAG_CAPTURING_GAIN_ADJUSTMENT">GST_TAG_CAPTURING_GAIN_ADJUSTMENT</a>
64
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-WHITE-BALANCE:CAPS" title="GST_TAG_CAPTURING_WHITE_BALANCE">GST_TAG_CAPTURING_WHITE_BALANCE</a>
65
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-CONTRAST:CAPS" title="GST_TAG_CAPTURING_CONTRAST">GST_TAG_CAPTURING_CONTRAST</a>
66
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-SATURATION:CAPS" title="GST_TAG_CAPTURING_SATURATION">GST_TAG_CAPTURING_SATURATION</a>
67
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-SHARPNESS:CAPS" title="GST_TAG_CAPTURING_SHARPNESS">GST_TAG_CAPTURING_SHARPNESS</a>
68
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-FLASH-FIRED:CAPS" title="GST_TAG_CAPTURING_FLASH_FIRED">GST_TAG_CAPTURING_FLASH_FIRED</a>
69
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-FLASH-MODE:CAPS" title="GST_TAG_CAPTURING_FLASH_MODE">GST_TAG_CAPTURING_FLASH_MODE</a>
70
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-METERING-MODE:CAPS" title="GST_TAG_CAPTURING_METERING_MODE">GST_TAG_CAPTURING_METERING_MODE</a>
71
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-SOURCE:CAPS" title="GST_TAG_CAPTURING_SOURCE">GST_TAG_CAPTURING_SOURCE</a>
72
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-EXPOSURE-COMPENSATION:CAPS" title="GST_TAG_CAPTURING_EXPOSURE_COMPENSATION">GST_TAG_CAPTURING_EXPOSURE_COMPENSATION</a>
73
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-IMAGE-HORIZONTAL-PPI:CAPS" title="GST_TAG_IMAGE_HORIZONTAL_PPI">GST_TAG_IMAGE_HORIZONTAL_PPI</a>
74
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-IMAGE-VERTICAL-PPI:CAPS" title="GST_TAG_IMAGE_VERTICAL_PPI">GST_TAG_IMAGE_VERTICAL_PPI</a>
75
 
#define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-ID3V2-HEADER-SIZE:CAPS" title="GST_TAG_ID3V2_HEADER_SIZE">GST_TAG_ID3V2_HEADER_SIZE</a>
76
 
<span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-gsttag.html#gst-tag-register-musicbrainz-tags" title="gst_tag_register_musicbrainz_tags ()">gst_tag_register_musicbrainz_tags</a>   (<em class="parameter"><code><span class="type">void</span></code></em>);
77
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="gst-plugins-base-libs-gsttag.html#gst-tag-freeform-string-to-utf8" title="gst_tag_freeform_string_to_utf8 ()">gst_tag_freeform_string_to_utf8</a>     (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *data</code></em>,
78
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>,
79
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **env_vars</code></em>);
80
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gst-plugins-base-libs-gsttag.html#gst-tag-parse-extended-comment" title="gst_tag_parse_extended_comment ()">gst_tag_parse_extended_comment</a>      (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *ext_comment</code></em>,
81
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **key</code></em>,
82
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **lang</code></em>,
83
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **value</code></em>,
84
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> fail_if_no_key</code></em>);
85
 
enum                <a class="link" href="gst-plugins-base-libs-gsttag.html#GstTagImageType" title="enum GstTagImageType">GstTagImageType</a>;
 
35
<div class="refsect1">
 
36
<a name="gst-plugins-base-libs-gsttag.functions"></a><h2>Functions</h2>
 
37
<div class="informaltable"><table width="100%" border="0">
 
38
<colgroup>
 
39
<col width="150px" class="functions_return">
 
40
<col class="functions_name">
 
41
</colgroup>
 
42
<tbody>
 
43
<tr>
 
44
<td class="function_type">
 
45
<span class="returnvalue">void</span>
 
46
</td>
 
47
<td class="function_name">
 
48
<a class="link" href="gst-plugins-base-libs-gsttag.html#gst-tag-register-musicbrainz-tags" title="gst_tag_register_musicbrainz_tags ()">gst_tag_register_musicbrainz_tags</a> <span class="c_punctuation">()</span>
 
49
</td>
 
50
</tr>
 
51
<tr>
 
52
<td class="function_type">
 
53
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
54
</td>
 
55
<td class="function_name">
 
56
<a class="link" href="gst-plugins-base-libs-gsttag.html#gst-tag-freeform-string-to-utf8" title="gst_tag_freeform_string_to_utf8 ()">gst_tag_freeform_string_to_utf8</a> <span class="c_punctuation">()</span>
 
57
</td>
 
58
</tr>
 
59
<tr>
 
60
<td class="function_type">
 
61
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
62
</td>
 
63
<td class="function_name">
 
64
<a class="link" href="gst-plugins-base-libs-gsttag.html#gst-tag-parse-extended-comment" title="gst_tag_parse_extended_comment ()">gst_tag_parse_extended_comment</a> <span class="c_punctuation">()</span>
 
65
</td>
 
66
</tr>
 
67
</tbody>
 
68
</table></div>
 
69
</div>
 
70
<div class="refsect1">
 
71
<a name="gst-plugins-base-libs-gsttag.other"></a><h2>Types and Values</h2>
 
72
<div class="informaltable"><table width="100%" border="0">
 
73
<colgroup>
 
74
<col width="150px" class="name">
 
75
<col class="description">
 
76
</colgroup>
 
77
<tbody>
 
78
<tr>
 
79
<td class="define_keyword">#define</td>
 
80
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-MUSICBRAINZ-TRACKID:CAPS" title="GST_TAG_MUSICBRAINZ_TRACKID">GST_TAG_MUSICBRAINZ_TRACKID</a></td>
 
81
</tr>
 
82
<tr>
 
83
<td class="define_keyword">#define</td>
 
84
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-MUSICBRAINZ-ARTISTID:CAPS" title="GST_TAG_MUSICBRAINZ_ARTISTID">GST_TAG_MUSICBRAINZ_ARTISTID</a></td>
 
85
</tr>
 
86
<tr>
 
87
<td class="define_keyword">#define</td>
 
88
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-MUSICBRAINZ-ALBUMID:CAPS" title="GST_TAG_MUSICBRAINZ_ALBUMID">GST_TAG_MUSICBRAINZ_ALBUMID</a></td>
 
89
</tr>
 
90
<tr>
 
91
<td class="define_keyword">#define</td>
 
92
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-MUSICBRAINZ-ALBUMARTISTID:CAPS" title="GST_TAG_MUSICBRAINZ_ALBUMARTISTID">GST_TAG_MUSICBRAINZ_ALBUMARTISTID</a></td>
 
93
</tr>
 
94
<tr>
 
95
<td class="define_keyword">#define</td>
 
96
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-MUSICBRAINZ-TRMID:CAPS" title="GST_TAG_MUSICBRAINZ_TRMID">GST_TAG_MUSICBRAINZ_TRMID</a></td>
 
97
</tr>
 
98
<tr>
 
99
<td class="define_keyword">#define</td>
 
100
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CDDA-CDDB-DISCID:CAPS" title="GST_TAG_CDDA_CDDB_DISCID">GST_TAG_CDDA_CDDB_DISCID</a></td>
 
101
</tr>
 
102
<tr>
 
103
<td class="define_keyword">#define</td>
 
104
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CDDA-CDDB-DISCID-FULL:CAPS" title="GST_TAG_CDDA_CDDB_DISCID_FULL">GST_TAG_CDDA_CDDB_DISCID_FULL</a></td>
 
105
</tr>
 
106
<tr>
 
107
<td class="define_keyword">#define</td>
 
108
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CDDA-MUSICBRAINZ-DISCID:CAPS" title="GST_TAG_CDDA_MUSICBRAINZ_DISCID">GST_TAG_CDDA_MUSICBRAINZ_DISCID</a></td>
 
109
</tr>
 
110
<tr>
 
111
<td class="define_keyword">#define</td>
 
112
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CDDA-MUSICBRAINZ-DISCID-FULL:CAPS" title="GST_TAG_CDDA_MUSICBRAINZ_DISCID_FULL">GST_TAG_CDDA_MUSICBRAINZ_DISCID_FULL</a></td>
 
113
</tr>
 
114
<tr>
 
115
<td class="define_keyword">#define</td>
 
116
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CMML-CLIP:CAPS" title="GST_TAG_CMML_CLIP">GST_TAG_CMML_CLIP</a></td>
 
117
</tr>
 
118
<tr>
 
119
<td class="define_keyword">#define</td>
 
120
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CMML-HEAD:CAPS" title="GST_TAG_CMML_HEAD">GST_TAG_CMML_HEAD</a></td>
 
121
</tr>
 
122
<tr>
 
123
<td class="define_keyword">#define</td>
 
124
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CMML-STREAM:CAPS" title="GST_TAG_CMML_STREAM">GST_TAG_CMML_STREAM</a></td>
 
125
</tr>
 
126
<tr>
 
127
<td class="define_keyword">#define</td>
 
128
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-SHUTTER-SPEED:CAPS" title="GST_TAG_CAPTURING_SHUTTER_SPEED">GST_TAG_CAPTURING_SHUTTER_SPEED</a></td>
 
129
</tr>
 
130
<tr>
 
131
<td class="define_keyword">#define</td>
 
132
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-FOCAL-RATIO:CAPS" title="GST_TAG_CAPTURING_FOCAL_RATIO">GST_TAG_CAPTURING_FOCAL_RATIO</a></td>
 
133
</tr>
 
134
<tr>
 
135
<td class="define_keyword">#define</td>
 
136
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-FOCAL-LENGTH:CAPS" title="GST_TAG_CAPTURING_FOCAL_LENGTH">GST_TAG_CAPTURING_FOCAL_LENGTH</a></td>
 
137
</tr>
 
138
<tr>
 
139
<td class="define_keyword">#define</td>
 
140
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-DIGITAL-ZOOM-RATIO:CAPS" title="GST_TAG_CAPTURING_DIGITAL_ZOOM_RATIO">GST_TAG_CAPTURING_DIGITAL_ZOOM_RATIO</a></td>
 
141
</tr>
 
142
<tr>
 
143
<td class="define_keyword">#define</td>
 
144
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-ISO-SPEED:CAPS" title="GST_TAG_CAPTURING_ISO_SPEED">GST_TAG_CAPTURING_ISO_SPEED</a></td>
 
145
</tr>
 
146
<tr>
 
147
<td class="define_keyword">#define</td>
 
148
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-EXPOSURE-PROGRAM:CAPS" title="GST_TAG_CAPTURING_EXPOSURE_PROGRAM">GST_TAG_CAPTURING_EXPOSURE_PROGRAM</a></td>
 
149
</tr>
 
150
<tr>
 
151
<td class="define_keyword">#define</td>
 
152
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-EXPOSURE-MODE:CAPS" title="GST_TAG_CAPTURING_EXPOSURE_MODE">GST_TAG_CAPTURING_EXPOSURE_MODE</a></td>
 
153
</tr>
 
154
<tr>
 
155
<td class="define_keyword">#define</td>
 
156
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-SCENE-CAPTURE-TYPE:CAPS" title="GST_TAG_CAPTURING_SCENE_CAPTURE_TYPE">GST_TAG_CAPTURING_SCENE_CAPTURE_TYPE</a></td>
 
157
</tr>
 
158
<tr>
 
159
<td class="define_keyword">#define</td>
 
160
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-GAIN-ADJUSTMENT:CAPS" title="GST_TAG_CAPTURING_GAIN_ADJUSTMENT">GST_TAG_CAPTURING_GAIN_ADJUSTMENT</a></td>
 
161
</tr>
 
162
<tr>
 
163
<td class="define_keyword">#define</td>
 
164
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-WHITE-BALANCE:CAPS" title="GST_TAG_CAPTURING_WHITE_BALANCE">GST_TAG_CAPTURING_WHITE_BALANCE</a></td>
 
165
</tr>
 
166
<tr>
 
167
<td class="define_keyword">#define</td>
 
168
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-CONTRAST:CAPS" title="GST_TAG_CAPTURING_CONTRAST">GST_TAG_CAPTURING_CONTRAST</a></td>
 
169
</tr>
 
170
<tr>
 
171
<td class="define_keyword">#define</td>
 
172
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-SATURATION:CAPS" title="GST_TAG_CAPTURING_SATURATION">GST_TAG_CAPTURING_SATURATION</a></td>
 
173
</tr>
 
174
<tr>
 
175
<td class="define_keyword">#define</td>
 
176
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-SHARPNESS:CAPS" title="GST_TAG_CAPTURING_SHARPNESS">GST_TAG_CAPTURING_SHARPNESS</a></td>
 
177
</tr>
 
178
<tr>
 
179
<td class="define_keyword">#define</td>
 
180
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-FLASH-FIRED:CAPS" title="GST_TAG_CAPTURING_FLASH_FIRED">GST_TAG_CAPTURING_FLASH_FIRED</a></td>
 
181
</tr>
 
182
<tr>
 
183
<td class="define_keyword">#define</td>
 
184
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-FLASH-MODE:CAPS" title="GST_TAG_CAPTURING_FLASH_MODE">GST_TAG_CAPTURING_FLASH_MODE</a></td>
 
185
</tr>
 
186
<tr>
 
187
<td class="define_keyword">#define</td>
 
188
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-METERING-MODE:CAPS" title="GST_TAG_CAPTURING_METERING_MODE">GST_TAG_CAPTURING_METERING_MODE</a></td>
 
189
</tr>
 
190
<tr>
 
191
<td class="define_keyword">#define</td>
 
192
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-SOURCE:CAPS" title="GST_TAG_CAPTURING_SOURCE">GST_TAG_CAPTURING_SOURCE</a></td>
 
193
</tr>
 
194
<tr>
 
195
<td class="define_keyword">#define</td>
 
196
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-EXPOSURE-COMPENSATION:CAPS" title="GST_TAG_CAPTURING_EXPOSURE_COMPENSATION">GST_TAG_CAPTURING_EXPOSURE_COMPENSATION</a></td>
 
197
</tr>
 
198
<tr>
 
199
<td class="define_keyword">#define</td>
 
200
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-IMAGE-HORIZONTAL-PPI:CAPS" title="GST_TAG_IMAGE_HORIZONTAL_PPI">GST_TAG_IMAGE_HORIZONTAL_PPI</a></td>
 
201
</tr>
 
202
<tr>
 
203
<td class="define_keyword">#define</td>
 
204
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-IMAGE-VERTICAL-PPI:CAPS" title="GST_TAG_IMAGE_VERTICAL_PPI">GST_TAG_IMAGE_VERTICAL_PPI</a></td>
 
205
</tr>
 
206
<tr>
 
207
<td class="define_keyword">#define</td>
 
208
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-ID3V2-HEADER-SIZE:CAPS" title="GST_TAG_ID3V2_HEADER_SIZE">GST_TAG_ID3V2_HEADER_SIZE</a></td>
 
209
</tr>
 
210
<tr>
 
211
<td class="datatype_keyword">enum</td>
 
212
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gsttag.html#GstTagImageType" title="enum GstTagImageType">GstTagImageType</a></td>
 
213
</tr>
 
214
</tbody>
 
215
</table></div>
 
216
</div>
 
217
<div class="refsect1">
 
218
<a name="gst-plugins-base-libs-gsttag.object-hierarchy"></a><h2>Object Hierarchy</h2>
 
219
<pre class="screen">
 
220
</pre>
 
221
</div>
 
222
<div class="refsect1">
 
223
<a name="gst-plugins-base-libs-gsttag.includes"></a><h2>Includes</h2>
 
224
<pre class="synopsis">#include &lt;gst/tag/tag.h&gt;
86
225
</pre>
87
226
</div>
88
227
<div class="refsect1">
89
228
<a name="gst-plugins-base-libs-gsttag.description"></a><h2>Description</h2>
90
 
<p>
91
 
</p>
92
229
<div class="refsect2">
93
 
<a name="id-1.2.12.3.4.2.1"></a><p>
 
230
<a name="id-1.2.12.3.7.2"></a><p>
94
231
Contains additional standardized GStreamer tag definitions for plugins
95
232
and applications, and functions to register them with the GStreamer
96
233
tag system.
97
234
</p>
98
235
</div>
99
 
<p>
100
 
</p>
101
 
</div>
102
 
<div class="refsect1">
103
 
<a name="gst-plugins-base-libs-gsttag.details"></a><h2>Details</h2>
 
236
</div>
 
237
<div class="refsect1">
 
238
<a name="gst-plugins-base-libs-gsttag.functions_details"></a><h2>Functions</h2>
 
239
<div class="refsect2">
 
240
<a name="gst-tag-register-musicbrainz-tags"></a><h3>gst_tag_register_musicbrainz_tags ()</h3>
 
241
<pre class="programlisting"><span class="returnvalue">void</span>
 
242
gst_tag_register_musicbrainz_tags (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
243
<p>Registers additional musicbrainz-specific tags with the GStreamer tag
 
244
system. Plugins and applications that use these tags should call this
 
245
function before using them. Can be called multiple times.</p>
 
246
</div>
 
247
<hr>
 
248
<div class="refsect2">
 
249
<a name="gst-tag-freeform-string-to-utf8"></a><h3>gst_tag_freeform_string_to_utf8 ()</h3>
 
250
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
251
gst_tag_freeform_string_to_utf8 (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *data</code></em>,
 
252
                                 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>,
 
253
                                 <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **env_vars</code></em>);</pre>
 
254
<p>Convenience function to read a string with unknown character encoding. If
 
255
the string is already in UTF-8 encoding, it will be returned right away.
 
256
If not it tries to detect byte-order-mark for UTF-16/32 cases and use that.
 
257
Otherwise, the environment will be searched for a number of environment
 
258
variables (whose names are specified in the NULL-terminated string array
 
259
<em class="parameter"><code>env_vars</code></em>
 
260
) containing a list of character encodings to try/use. If none
 
261
are specified, the current locale will be tried. If that also doesn't work,
 
262
WINDOWS-1252/ISO-8859-1 is assumed (which will almost always succeed).</p>
 
263
<div class="refsect3">
 
264
<a name="id-1.2.12.3.8.3.5"></a><h4>Parameters</h4>
 
265
<div class="informaltable"><table width="100%" border="0">
 
266
<colgroup>
 
267
<col width="150px" class="parameters_name">
 
268
<col class="parameters_description">
 
269
<col width="200px" class="parameters_annotations">
 
270
</colgroup>
 
271
<tbody>
 
272
<tr>
 
273
<td class="parameter_name"><p>data</p></td>
 
274
<td class="parameter_description"><p>string data</p></td>
 
275
<td class="parameter_annotations"> </td>
 
276
</tr>
 
277
<tr>
 
278
<td class="parameter_name"><p>size</p></td>
 
279
<td class="parameter_description"><p>length of string data, or -1 if the string is NUL-terminated</p></td>
 
280
<td class="parameter_annotations"> </td>
 
281
</tr>
 
282
<tr>
 
283
<td class="parameter_name"><p>env_vars</p></td>
 
284
<td class="parameter_description"><p>a NULL-terminated string array of environment variable names,
 
285
or NULL</p></td>
 
286
<td class="parameter_annotations"> </td>
 
287
</tr>
 
288
</tbody>
 
289
</table></div>
 
290
</div>
 
291
<div class="refsect3">
 
292
<a name="id-1.2.12.3.8.3.6"></a><h4>Returns</h4>
 
293
<p> a newly-allocated string in UTF-8 encoding, or NULL</p>
 
294
<p></p>
 
295
</div>
 
296
</div>
 
297
<hr>
 
298
<div class="refsect2">
 
299
<a name="gst-tag-parse-extended-comment"></a><h3>gst_tag_parse_extended_comment ()</h3>
 
300
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
301
gst_tag_parse_extended_comment (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *ext_comment</code></em>,
 
302
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **key</code></em>,
 
303
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **lang</code></em>,
 
304
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **value</code></em>,
 
305
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> fail_if_no_key</code></em>);</pre>
 
306
<p>Convenience function to parse a GST_TAG_EXTENDED_COMMENT string and
 
307
separate it into its components.</p>
 
308
<p>If successful, <em class="parameter"><code>key</code></em>
 
309
, <em class="parameter"><code>lang</code></em>
 
310
 and/or <em class="parameter"><code>value</code></em>
 
311
 will be set to newly allocated
 
312
strings that you need to free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when done. <em class="parameter"><code>key</code></em>
 
313
 and <em class="parameter"><code>lang</code></em>
 
314
 
 
315
may also be set to NULL by this function if there is no key or no language
 
316
code in the extended comment string.</p>
 
317
<div class="refsect3">
 
318
<a name="id-1.2.12.3.8.4.6"></a><h4>Parameters</h4>
 
319
<div class="informaltable"><table width="100%" border="0">
 
320
<colgroup>
 
321
<col width="150px" class="parameters_name">
 
322
<col class="parameters_description">
 
323
<col width="200px" class="parameters_annotations">
 
324
</colgroup>
 
325
<tbody>
 
326
<tr>
 
327
<td class="parameter_name"><p>ext_comment</p></td>
 
328
<td class="parameter_description"><p>an extended comment string, see <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstTagList.html#GST-TAG-EXTENDED-COMMENT:CAPS"><span class="type">GST_TAG_EXTENDED_COMMENT</span></a></p></td>
 
329
<td class="parameter_annotations"> </td>
 
330
</tr>
 
331
<tr>
 
332
<td class="parameter_name"><p>key</p></td>
 
333
<td class="parameter_description"><p>return location for the comment description key, or NULL</p></td>
 
334
<td class="parameter_annotations"> </td>
 
335
</tr>
 
336
<tr>
 
337
<td class="parameter_name"><p>lang</p></td>
 
338
<td class="parameter_description"><p>return location for the comment ISO-639 language code, or NULL</p></td>
 
339
<td class="parameter_annotations"> </td>
 
340
</tr>
 
341
<tr>
 
342
<td class="parameter_name"><p>value</p></td>
 
343
<td class="parameter_description"><p>return location for the actual comment string, or NULL</p></td>
 
344
<td class="parameter_annotations"> </td>
 
345
</tr>
 
346
<tr>
 
347
<td class="parameter_name"><p>fail_if_no_key</p></td>
 
348
<td class="parameter_description"><p>whether to fail if strings are not in key=value form</p></td>
 
349
<td class="parameter_annotations"> </td>
 
350
</tr>
 
351
</tbody>
 
352
</table></div>
 
353
</div>
 
354
<div class="refsect3">
 
355
<a name="id-1.2.12.3.8.4.7"></a><h4>Returns</h4>
 
356
<p> TRUE if the string could be parsed, otherwise FALSE</p>
 
357
<p></p>
 
358
</div>
 
359
</div>
 
360
</div>
 
361
<div class="refsect1">
 
362
<a name="gst-plugins-base-libs-gsttag.other_details"></a><h2>Types and Values</h2>
104
363
<div class="refsect2">
105
364
<a name="GST-TAG-MUSICBRAINZ-TRACKID:CAPS"></a><h3>GST_TAG_MUSICBRAINZ_TRACKID</h3>
106
365
<pre class="programlisting">#define GST_TAG_MUSICBRAINZ_TRACKID "musicbrainz-trackid"
107
366
</pre>
108
 
<p>
109
 
MusicBrainz track ID
110
 
</p>
 
367
<p>MusicBrainz track ID</p>
111
368
</div>
112
369
<hr>
113
370
<div class="refsect2">
114
371
<a name="GST-TAG-MUSICBRAINZ-ARTISTID:CAPS"></a><h3>GST_TAG_MUSICBRAINZ_ARTISTID</h3>
115
372
<pre class="programlisting">#define GST_TAG_MUSICBRAINZ_ARTISTID "musicbrainz-artistid"
116
373
</pre>
117
 
<p>
118
 
MusicBrainz artist ID
119
 
</p>
 
374
<p>MusicBrainz artist ID</p>
120
375
</div>
121
376
<hr>
122
377
<div class="refsect2">
123
378
<a name="GST-TAG-MUSICBRAINZ-ALBUMID:CAPS"></a><h3>GST_TAG_MUSICBRAINZ_ALBUMID</h3>
124
379
<pre class="programlisting">#define GST_TAG_MUSICBRAINZ_ALBUMID "musicbrainz-albumid"
125
380
</pre>
126
 
<p>
127
 
MusicBrainz album ID
128
 
</p>
 
381
<p>MusicBrainz album ID</p>
129
382
</div>
130
383
<hr>
131
384
<div class="refsect2">
132
385
<a name="GST-TAG-MUSICBRAINZ-ALBUMARTISTID:CAPS"></a><h3>GST_TAG_MUSICBRAINZ_ALBUMARTISTID</h3>
133
386
<pre class="programlisting">#define GST_TAG_MUSICBRAINZ_ALBUMARTISTID "musicbrainz-albumartistid"
134
387
</pre>
135
 
<p>
136
 
MusicBrainz album artist ID
137
 
</p>
 
388
<p>MusicBrainz album artist ID</p>
138
389
</div>
139
390
<hr>
140
391
<div class="refsect2">
141
392
<a name="GST-TAG-MUSICBRAINZ-TRMID:CAPS"></a><h3>GST_TAG_MUSICBRAINZ_TRMID</h3>
142
393
<pre class="programlisting">#define GST_TAG_MUSICBRAINZ_TRMID "musicbrainz-trmid"
143
394
</pre>
144
 
<p>
145
 
MusicBrainz track TRM ID
146
 
</p>
 
395
<p>MusicBrainz track TRM ID</p>
147
396
</div>
148
397
<hr>
149
398
<div class="refsect2">
150
399
<a name="GST-TAG-CDDA-CDDB-DISCID:CAPS"></a><h3>GST_TAG_CDDA_CDDB_DISCID</h3>
151
400
<pre class="programlisting">#define GST_TAG_CDDA_CDDB_DISCID              "discid"
152
401
</pre>
153
 
<p>
154
 
CDDB disc id in its short form (e.g. 'aa063d0f')
155
 
</p>
 
402
<p>CDDB disc id in its short form (e.g. 'aa063d0f')</p>
156
403
</div>
157
404
<hr>
158
405
<div class="refsect2">
159
406
<a name="GST-TAG-CDDA-CDDB-DISCID-FULL:CAPS"></a><h3>GST_TAG_CDDA_CDDB_DISCID_FULL</h3>
160
407
<pre class="programlisting">#define GST_TAG_CDDA_CDDB_DISCID_FULL         "discid-full"
161
408
</pre>
162
 
<p>
163
 
CDDB disc id including all details
164
 
</p>
 
409
<p>CDDB disc id including all details</p>
165
410
</div>
166
411
<hr>
167
412
<div class="refsect2">
168
413
<a name="GST-TAG-CDDA-MUSICBRAINZ-DISCID:CAPS"></a><h3>GST_TAG_CDDA_MUSICBRAINZ_DISCID</h3>
169
414
<pre class="programlisting">#define GST_TAG_CDDA_MUSICBRAINZ_DISCID       "musicbrainz-discid"
170
415
</pre>
171
 
<p>
172
 
Musicbrainz disc id (e.g. 'ahg7JUcfR3vCYBphSDIogOOWrr0-')
173
 
</p>
 
416
<p>Musicbrainz disc id (e.g. 'ahg7JUcfR3vCYBphSDIogOOWrr0-')</p>
174
417
</div>
175
418
<hr>
176
419
<div class="refsect2">
177
420
<a name="GST-TAG-CDDA-MUSICBRAINZ-DISCID-FULL:CAPS"></a><h3>GST_TAG_CDDA_MUSICBRAINZ_DISCID_FULL</h3>
178
421
<pre class="programlisting">#define GST_TAG_CDDA_MUSICBRAINZ_DISCID_FULL  "musicbrainz-discid-full"
179
422
</pre>
180
 
<p>
181
 
Musicbrainz disc id details
182
 
</p>
 
423
<p>Musicbrainz disc id details</p>
183
424
</div>
184
425
<hr>
185
426
<div class="refsect2">
186
427
<a name="GST-TAG-CMML-CLIP:CAPS"></a><h3>GST_TAG_CMML_CLIP</h3>
187
428
<pre class="programlisting">#define GST_TAG_CMML_CLIP "cmml-clip"
188
429
</pre>
189
 
<p>
190
 
Annodex CMML clip element tag
191
 
</p>
 
430
<p>Annodex CMML clip element tag</p>
192
431
</div>
193
432
<hr>
194
433
<div class="refsect2">
195
434
<a name="GST-TAG-CMML-HEAD:CAPS"></a><h3>GST_TAG_CMML_HEAD</h3>
196
435
<pre class="programlisting">#define GST_TAG_CMML_HEAD "cmml-head"
197
436
</pre>
198
 
<p>
199
 
Annodex CMML head element tag
200
 
</p>
 
437
<p>Annodex CMML head element tag</p>
201
438
</div>
202
439
<hr>
203
440
<div class="refsect2">
204
441
<a name="GST-TAG-CMML-STREAM:CAPS"></a><h3>GST_TAG_CMML_STREAM</h3>
205
442
<pre class="programlisting">#define GST_TAG_CMML_STREAM "cmml-stream"
206
443
</pre>
207
 
<p>
208
 
Annodex CMML stream element tag
209
 
</p>
 
444
<p>Annodex CMML stream element tag</p>
210
445
</div>
211
446
<hr>
212
447
<div class="refsect2">
213
448
<a name="GST-TAG-CAPTURING-SHUTTER-SPEED:CAPS"></a><h3>GST_TAG_CAPTURING_SHUTTER_SPEED</h3>
214
449
<pre class="programlisting">#define GST_TAG_CAPTURING_SHUTTER_SPEED        "capturing-shutter-speed"
215
450
</pre>
216
 
<p>
217
 
Shutter speed used when capturing an image, in seconds. (fraction)
218
 
</p>
 
451
<p>Shutter speed used when capturing an image, in seconds. (fraction)</p>
219
452
</div>
220
453
<hr>
221
454
<div class="refsect2">
222
455
<a name="GST-TAG-CAPTURING-FOCAL-RATIO:CAPS"></a><h3>GST_TAG_CAPTURING_FOCAL_RATIO</h3>
223
456
<pre class="programlisting">#define GST_TAG_CAPTURING_FOCAL_RATIO          "capturing-focal-ratio"
224
457
</pre>
225
 
<p>
226
 
Focal ratio (f-number) used when capturing an image. (double)
227
 
</p>
228
 
<p>
229
 
The value stored is the denominator of the focal ratio (f-number).
230
 
For example, if this tag value is 2, the focal ratio is f/2.
231
 
</p>
 
458
<p>Focal ratio (f-number) used when capturing an image. (double)</p>
 
459
<p>The value stored is the denominator of the focal ratio (f-number).
 
460
For example, if this tag value is 2, the focal ratio is f/2.</p>
232
461
</div>
233
462
<hr>
234
463
<div class="refsect2">
235
464
<a name="GST-TAG-CAPTURING-FOCAL-LENGTH:CAPS"></a><h3>GST_TAG_CAPTURING_FOCAL_LENGTH</h3>
236
465
<pre class="programlisting">#define GST_TAG_CAPTURING_FOCAL_LENGTH         "capturing-focal-length"
237
466
</pre>
238
 
<p>
239
 
Focal length used when capturing an image, in mm. (double)
240
 
</p>
 
467
<p>Focal length used when capturing an image, in mm. (double)</p>
241
468
</div>
242
469
<hr>
243
470
<div class="refsect2">
244
471
<a name="GST-TAG-CAPTURING-DIGITAL-ZOOM-RATIO:CAPS"></a><h3>GST_TAG_CAPTURING_DIGITAL_ZOOM_RATIO</h3>
245
472
<pre class="programlisting">#define GST_TAG_CAPTURING_DIGITAL_ZOOM_RATIO   "capturing-digital-zoom-ratio"
246
473
</pre>
247
 
<p>
248
 
Digital zoom ratio used when capturing an image. (double)
249
 
</p>
 
474
<p>Digital zoom ratio used when capturing an image. (double)</p>
250
475
</div>
251
476
<hr>
252
477
<div class="refsect2">
253
478
<a name="GST-TAG-CAPTURING-ISO-SPEED:CAPS"></a><h3>GST_TAG_CAPTURING_ISO_SPEED</h3>
254
479
<pre class="programlisting">#define GST_TAG_CAPTURING_ISO_SPEED           "capturing-iso-speed"
255
480
</pre>
256
 
<p>
257
 
ISO speed used when capturing an image. (integer)
258
 
</p>
 
481
<p>ISO speed used when capturing an image. (integer)</p>
259
482
</div>
260
483
<hr>
261
484
<div class="refsect2">
262
485
<a name="GST-TAG-CAPTURING-EXPOSURE-PROGRAM:CAPS"></a><h3>GST_TAG_CAPTURING_EXPOSURE_PROGRAM</h3>
263
486
<pre class="programlisting">#define GST_TAG_CAPTURING_EXPOSURE_PROGRAM     "capturing-exposure-program"
264
487
</pre>
265
 
<p>
266
 
Type of exposure control used when capturing an image. (string)
267
 
</p>
268
 
<p>
269
 
The allowed values are:
 
488
<p>Type of exposure control used when capturing an image. (string)</p>
 
489
<p>The allowed values are:
270
490
  "undefined"
271
491
  "manual"
272
492
  "normal" - automatically controlled
275
495
  "creative" - biased towards depth of field
276
496
  "action" - biased towards fast shutter speed
277
497
  "portrait" - closeup, leaving background out of focus
278
 
  "landscape" - landscape photos, background in focus
279
 
</p>
 
498
  "landscape" - landscape photos, background in focus</p>
280
499
</div>
281
500
<hr>
282
501
<div class="refsect2">
283
502
<a name="GST-TAG-CAPTURING-EXPOSURE-MODE:CAPS"></a><h3>GST_TAG_CAPTURING_EXPOSURE_MODE</h3>
284
503
<pre class="programlisting">#define GST_TAG_CAPTURING_EXPOSURE_MODE       "capturing-exposure-mode"
285
504
</pre>
286
 
<p>
287
 
Exposure mode used when capturing an image. (string)
288
 
</p>
289
 
<p>
290
 
The allowed values are:
 
505
<p>Exposure mode used when capturing an image. (string)</p>
 
506
<p>The allowed values are:
291
507
  "auto-exposure"
292
508
  "manual-exposure"
293
 
  "auto-bracket"
294
 
</p>
 
509
  "auto-bracket"</p>
295
510
</div>
296
511
<hr>
297
512
<div class="refsect2">
298
513
<a name="GST-TAG-CAPTURING-SCENE-CAPTURE-TYPE:CAPS"></a><h3>GST_TAG_CAPTURING_SCENE_CAPTURE_TYPE</h3>
299
514
<pre class="programlisting">#define GST_TAG_CAPTURING_SCENE_CAPTURE_TYPE  "capturing-scene-capture-type"
300
515
</pre>
301
 
<p>
302
 
Scene mode used when capturing an image. (string)
303
 
</p>
304
 
<p>
305
 
The allowed values are:
 
516
<p>Scene mode used when capturing an image. (string)</p>
 
517
<p>The allowed values are:
306
518
  "standard"
307
519
  "landscape"
308
520
  "portrait"
309
 
  "night-scene"
310
 
</p>
 
521
  "night-scene"</p>
311
522
</div>
312
523
<hr>
313
524
<div class="refsect2">
314
525
<a name="GST-TAG-CAPTURING-GAIN-ADJUSTMENT:CAPS"></a><h3>GST_TAG_CAPTURING_GAIN_ADJUSTMENT</h3>
315
526
<pre class="programlisting">#define GST_TAG_CAPTURING_GAIN_ADJUSTMENT     "capturing-gain-adjustment"
316
527
</pre>
317
 
<p>
318
 
Gain adjustment applied to an image. (string)
319
 
</p>
320
 
<p>
321
 
The allowed values are:
 
528
<p>Gain adjustment applied to an image. (string)</p>
 
529
<p>The allowed values are:
322
530
  "none"
323
531
  "low-gain-up"
324
532
  "high-gain-up"
325
533
  "low-gain-down"
326
 
  "high-gain-down"
327
 
</p>
 
534
  "high-gain-down"</p>
328
535
</div>
329
536
<hr>
330
537
<div class="refsect2">
331
538
<a name="GST-TAG-CAPTURING-WHITE-BALANCE:CAPS"></a><h3>GST_TAG_CAPTURING_WHITE_BALANCE</h3>
332
539
<pre class="programlisting">#define GST_TAG_CAPTURING_WHITE_BALANCE       "capturing-white-balance"
333
540
</pre>
334
 
<p>
335
 
White balance mode used when capturing an image. (string)
336
 
</p>
337
 
<p>
338
 
The allowed values are:
 
541
<p>White balance mode used when capturing an image. (string)</p>
 
542
<p>The allowed values are:
339
543
  "auto"
340
544
  "manual"
341
545
  "daylight"
343
547
  "tungsten"
344
548
  "fluorescent"
345
549
  "fluorescent h" (newer daylight-calibrated fluorescents)
346
 
  "flash"
347
 
</p>
 
550
  "flash"</p>
348
551
</div>
349
552
<hr>
350
553
<div class="refsect2">
351
554
<a name="GST-TAG-CAPTURING-CONTRAST:CAPS"></a><h3>GST_TAG_CAPTURING_CONTRAST</h3>
352
555
<pre class="programlisting">#define GST_TAG_CAPTURING_CONTRAST            "capturing-contrast"
353
556
</pre>
354
 
<p>
355
 
Direction of contrast processing applied when capturing an image. (string)
356
 
</p>
357
 
<p>
358
 
The allowed values are:
 
557
<p>Direction of contrast processing applied when capturing an image. (string)</p>
 
558
<p>The allowed values are:
359
559
 "normal"
360
560
 "soft"
361
 
 "hard"
362
 
</p>
 
561
 "hard"</p>
363
562
</div>
364
563
<hr>
365
564
<div class="refsect2">
366
565
<a name="GST-TAG-CAPTURING-SATURATION:CAPS"></a><h3>GST_TAG_CAPTURING_SATURATION</h3>
367
566
<pre class="programlisting">#define GST_TAG_CAPTURING_SATURATION          "capturing-saturation"
368
567
</pre>
369
 
<p>
370
 
Direction of saturation processing applied when capturing an image. (string)
371
 
</p>
372
 
<p>
373
 
The allowed values are:
 
568
<p>Direction of saturation processing applied when capturing an image. (string)</p>
 
569
<p>The allowed values are:
374
570
 "normal"
375
571
 "low-saturation"
376
 
 "high-saturation"
377
 
</p>
 
572
 "high-saturation"</p>
378
573
</div>
379
574
<hr>
380
575
<div class="refsect2">
381
576
<a name="GST-TAG-CAPTURING-SHARPNESS:CAPS"></a><h3>GST_TAG_CAPTURING_SHARPNESS</h3>
382
577
<pre class="programlisting">#define GST_TAG_CAPTURING_SHARPNESS          "capturing-sharpness"
383
578
</pre>
384
 
<p>
385
 
Direction of sharpness processing applied when capturing an image. (string)
386
 
</p>
387
 
<p>
388
 
The allowed values are:
 
579
<p>Direction of sharpness processing applied when capturing an image. (string)</p>
 
580
<p>The allowed values are:
389
581
 "normal"
390
582
 "soft"
391
 
 "hard"
392
 
</p>
 
583
 "hard"</p>
393
584
</div>
394
585
<hr>
395
586
<div class="refsect2">
396
587
<a name="GST-TAG-CAPTURING-FLASH-FIRED:CAPS"></a><h3>GST_TAG_CAPTURING_FLASH_FIRED</h3>
397
588
<pre class="programlisting">#define GST_TAG_CAPTURING_FLASH_FIRED         "capturing-flash-fired"
398
589
</pre>
399
 
<p>
400
 
If flash was fired during the capture of an image. (boolean)
401
 
</p>
402
 
<p>
403
 
Note that if this tag isn't present, it should not be assumed that
404
 
the flash did not fire. It should be treated as unknown.
405
 
</p>
 
590
<p>If flash was fired during the capture of an image. (boolean)</p>
 
591
<p>Note that if this tag isn't present, it should not be assumed that
 
592
the flash did not fire. It should be treated as unknown.</p>
406
593
</div>
407
594
<hr>
408
595
<div class="refsect2">
409
596
<a name="GST-TAG-CAPTURING-FLASH-MODE:CAPS"></a><h3>GST_TAG_CAPTURING_FLASH_MODE</h3>
410
597
<pre class="programlisting">#define GST_TAG_CAPTURING_FLASH_MODE         "capturing-flash-mode"
411
598
</pre>
412
 
<p>
413
 
The flash mode selected during the capture of an image. (string)
414
 
</p>
415
 
<p>
416
 
The allowed values are:
 
599
<p>The flash mode selected during the capture of an image. (string)</p>
 
600
<p>The allowed values are:
417
601
 "auto"
418
602
 "always"
419
 
 "never"
420
 
</p>
 
603
 "never"</p>
421
604
</div>
422
605
<hr>
423
606
<div class="refsect2">
424
607
<a name="GST-TAG-CAPTURING-METERING-MODE:CAPS"></a><h3>GST_TAG_CAPTURING_METERING_MODE</h3>
425
608
<pre class="programlisting">#define GST_TAG_CAPTURING_METERING_MODE      "capturing-metering-mode"
426
609
</pre>
427
 
<p>
428
 
Defines the way a camera determines the exposure. (string)
429
 
</p>
430
 
<p>
431
 
The allowed values are:
 
610
<p>Defines the way a camera determines the exposure. (string)</p>
 
611
<p>The allowed values are:
432
612
  "unknown"
433
613
  "average"
434
614
  "center-weighted-average"
436
616
  "multi-spot"
437
617
  "pattern"
438
618
  "partial"
439
 
  "other"
440
 
</p>
 
619
  "other"</p>
441
620
</div>
442
621
<hr>
443
622
<div class="refsect2">
444
623
<a name="GST-TAG-CAPTURING-SOURCE:CAPS"></a><h3>GST_TAG_CAPTURING_SOURCE</h3>
445
624
<pre class="programlisting">#define GST_TAG_CAPTURING_SOURCE             "capturing-source"
446
625
</pre>
447
 
<p>
448
 
Indicates the source of capture. The device/medium used to do the
449
 
capture. (string)
450
 
</p>
451
 
<p>
452
 
Allowed values are:
 
626
<p>Indicates the source of capture. The device/medium used to do the
 
627
capture. (string)</p>
 
628
<p>Allowed values are:
453
629
  "dsc" (= digital still camera)
454
630
  "transparent-scanner"
455
631
  "reflex-scanner"
456
 
  "other"
457
 
</p>
 
632
  "other"</p>
458
633
</div>
459
634
<hr>
460
635
<div class="refsect2">
461
636
<a name="GST-TAG-CAPTURING-EXPOSURE-COMPENSATION:CAPS"></a><h3>GST_TAG_CAPTURING_EXPOSURE_COMPENSATION</h3>
462
637
<pre class="programlisting">#define GST_TAG_CAPTURING_EXPOSURE_COMPENSATION "capturing-exposure-compensation"
463
638
</pre>
464
 
<p>
465
 
Exposure compensation using when capturing an image in EV. (double)
466
 
</p>
 
639
<p>Exposure compensation using when capturing an image in EV. (double)</p>
467
640
</div>
468
641
<hr>
469
642
<div class="refsect2">
470
643
<a name="GST-TAG-IMAGE-HORIZONTAL-PPI:CAPS"></a><h3>GST_TAG_IMAGE_HORIZONTAL_PPI</h3>
471
644
<pre class="programlisting">#define GST_TAG_IMAGE_HORIZONTAL_PPI         "image-horizontal-ppi"
472
645
</pre>
473
 
<p>
474
 
Media (image/video) intended horizontal pixel density in ppi. (double)
475
 
</p>
 
646
<p>Media (image/video) intended horizontal pixel density in ppi. (double)</p>
476
647
</div>
477
648
<hr>
478
649
<div class="refsect2">
479
650
<a name="GST-TAG-IMAGE-VERTICAL-PPI:CAPS"></a><h3>GST_TAG_IMAGE_VERTICAL_PPI</h3>
480
651
<pre class="programlisting">#define GST_TAG_IMAGE_VERTICAL_PPI           "image-vertical-ppi"
481
652
</pre>
482
 
<p>
483
 
Media (image/video) intended vertical pixel density in ppi. (double)
484
 
</p>
 
653
<p>Media (image/video) intended vertical pixel density in ppi. (double)</p>
485
654
</div>
486
655
<hr>
487
656
<div class="refsect2">
488
657
<a name="GST-TAG-ID3V2-HEADER-SIZE:CAPS"></a><h3>GST_TAG_ID3V2_HEADER_SIZE</h3>
489
658
<pre class="programlisting">#define GST_TAG_ID3V2_HEADER_SIZE            10
490
659
</pre>
491
 
<p>
492
 
ID3V2 header size considered minimum input for some functions such as
493
 
<a class="link" href="gst-plugins-base-libs-gsttagid3.html#gst-tag-list-from-id3v2-tag" title="gst_tag_list_from_id3v2_tag ()"><code class="function">gst_tag_list_from_id3v2_tag()</code></a> and <a class="link" href="gst-plugins-base-libs-gsttagid3.html#gst-tag-get-id3v2-tag-size" title="gst_tag_get_id3v2_tag_size ()"><code class="function">gst_tag_get_id3v2_tag_size()</code></a> for example.
494
 
</p>
495
 
</div>
496
 
<hr>
497
 
<div class="refsect2">
498
 
<a name="gst-tag-register-musicbrainz-tags"></a><h3>gst_tag_register_musicbrainz_tags ()</h3>
499
 
<pre class="programlisting"><span class="returnvalue">void</span>                gst_tag_register_musicbrainz_tags   (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
500
 
<p>
501
 
Registers additional musicbrainz-specific tags with the GStreamer tag
502
 
system. Plugins and applications that use these tags should call this
503
 
function before using them. Can be called multiple times.
504
 
</p>
505
 
</div>
506
 
<hr>
507
 
<div class="refsect2">
508
 
<a name="gst-tag-freeform-string-to-utf8"></a><h3>gst_tag_freeform_string_to_utf8 ()</h3>
509
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             gst_tag_freeform_string_to_utf8     (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *data</code></em>,
510
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>,
511
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **env_vars</code></em>);</pre>
512
 
<p>
513
 
Convenience function to read a string with unknown character encoding. If
514
 
the string is already in UTF-8 encoding, it will be returned right away.
515
 
If not it tries to detect byte-order-mark for UTF-16/32 cases and use that.
516
 
Otherwise, the environment will be searched for a number of environment
517
 
variables (whose names are specified in the NULL-terminated string array
518
 
<em class="parameter"><code>env_vars</code></em>) containing a list of character encodings to try/use. If none
519
 
are specified, the current locale will be tried. If that also doesn't work,
520
 
WINDOWS-1252/ISO-8859-1 is assumed (which will almost always succeed).
521
 
</p>
522
 
<div class="variablelist"><table border="0" class="variablelist">
523
 
<colgroup>
524
 
<col align="left" valign="top">
525
 
<col>
526
 
</colgroup>
527
 
<tbody>
528
 
<tr>
529
 
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
530
 
<td>string data</td>
531
 
</tr>
532
 
<tr>
533
 
<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
534
 
<td>length of string data, or -1 if the string is NUL-terminated</td>
535
 
</tr>
536
 
<tr>
537
 
<td><p><span class="term"><em class="parameter"><code>env_vars</code></em> :</span></p></td>
538
 
<td>a NULL-terminated string array of environment variable names,
539
 
or NULL</td>
540
 
</tr>
541
 
<tr>
542
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
543
 
<td>a newly-allocated string in UTF-8 encoding, or NULL</td>
544
 
</tr>
545
 
</tbody>
546
 
</table></div>
547
 
</div>
548
 
<hr>
549
 
<div class="refsect2">
550
 
<a name="gst-tag-parse-extended-comment"></a><h3>gst_tag_parse_extended_comment ()</h3>
551
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_tag_parse_extended_comment      (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *ext_comment</code></em>,
552
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **key</code></em>,
553
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **lang</code></em>,
554
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **value</code></em>,
555
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> fail_if_no_key</code></em>);</pre>
556
 
<p>
557
 
Convenience function to parse a GST_TAG_EXTENDED_COMMENT string and
558
 
separate it into its components.
559
 
</p>
560
 
<p>
561
 
If successful, <em class="parameter"><code>key</code></em>, <em class="parameter"><code>lang</code></em> and/or <em class="parameter"><code>value</code></em> will be set to newly allocated
562
 
strings that you need to free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when done. <em class="parameter"><code>key</code></em> and <em class="parameter"><code>lang</code></em>
563
 
may also be set to NULL by this function if there is no key or no language
564
 
code in the extended comment string.
565
 
</p>
566
 
<div class="variablelist"><table border="0" class="variablelist">
567
 
<colgroup>
568
 
<col align="left" valign="top">
569
 
<col>
570
 
</colgroup>
571
 
<tbody>
572
 
<tr>
573
 
<td><p><span class="term"><em class="parameter"><code>ext_comment</code></em> :</span></p></td>
574
 
<td>an extended comment string, see <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstTagList.html#GST-TAG-EXTENDED-COMMENT:CAPS"><span class="type">GST_TAG_EXTENDED_COMMENT</span></a>
575
 
</td>
576
 
</tr>
577
 
<tr>
578
 
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
579
 
<td>return location for the comment description key, or NULL</td>
580
 
</tr>
581
 
<tr>
582
 
<td><p><span class="term"><em class="parameter"><code>lang</code></em> :</span></p></td>
583
 
<td>return location for the comment ISO-639 language code, or NULL</td>
584
 
</tr>
585
 
<tr>
586
 
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
587
 
<td>return location for the actual comment string, or NULL</td>
588
 
</tr>
589
 
<tr>
590
 
<td><p><span class="term"><em class="parameter"><code>fail_if_no_key</code></em> :</span></p></td>
591
 
<td>whether to fail if strings are not in key=value form</td>
592
 
</tr>
593
 
<tr>
594
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
595
 
<td>TRUE if the string could be parsed, otherwise FALSE</td>
596
 
</tr>
597
 
</tbody>
598
 
</table></div>
 
660
<p>ID3V2 header size considered minimum input for some functions such as
 
661
<a class="link" href="gst-plugins-base-libs-gsttagid3.html#gst-tag-list-from-id3v2-tag" title="gst_tag_list_from_id3v2_tag ()"><code class="function">gst_tag_list_from_id3v2_tag()</code></a> and <a class="link" href="gst-plugins-base-libs-gsttagid3.html#gst-tag-get-id3v2-tag-size" title="gst_tag_get_id3v2_tag_size ()"><code class="function">gst_tag_get_id3v2_tag_size()</code></a> for example.</p>
599
662
</div>
600
663
<hr>
601
664
<div class="refsect2">
602
665
<a name="GstTagImageType"></a><h3>enum GstTagImageType</h3>
603
 
<pre class="programlisting">typedef enum {
604
 
  GST_TAG_IMAGE_TYPE_NONE = -1,
605
 
  GST_TAG_IMAGE_TYPE_UNDEFINED = 0,
606
 
  GST_TAG_IMAGE_TYPE_FRONT_COVER,
607
 
  GST_TAG_IMAGE_TYPE_BACK_COVER,
608
 
  GST_TAG_IMAGE_TYPE_LEAFLET_PAGE,
609
 
  GST_TAG_IMAGE_TYPE_MEDIUM,
610
 
  GST_TAG_IMAGE_TYPE_LEAD_ARTIST,
611
 
  GST_TAG_IMAGE_TYPE_ARTIST,
612
 
  GST_TAG_IMAGE_TYPE_CONDUCTOR,
613
 
  GST_TAG_IMAGE_TYPE_BAND_ORCHESTRA,
614
 
  GST_TAG_IMAGE_TYPE_COMPOSER,
615
 
  GST_TAG_IMAGE_TYPE_LYRICIST,
616
 
  GST_TAG_IMAGE_TYPE_RECORDING_LOCATION,
617
 
  GST_TAG_IMAGE_TYPE_DURING_RECORDING,
618
 
  GST_TAG_IMAGE_TYPE_DURING_PERFORMANCE,
619
 
  GST_TAG_IMAGE_TYPE_VIDEO_CAPTURE,
620
 
  GST_TAG_IMAGE_TYPE_FISH,
621
 
  GST_TAG_IMAGE_TYPE_ILLUSTRATION,
622
 
  GST_TAG_IMAGE_TYPE_BAND_ARTIST_LOGO,
623
 
  GST_TAG_IMAGE_TYPE_PUBLISHER_STUDIO_LOGO
624
 
} GstTagImageType;
625
 
</pre>
626
 
<p>
627
 
Type of image contained in an image tag (specified as "image-type" field in
628
 
the info structure in the image's <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstSample.html#GstSample"><span class="type">GstSample</span></a>)
629
 
</p>
630
 
<div class="variablelist"><table border="0" class="variablelist">
 
666
<p>Type of image contained in an image tag (specified as "image-type" field in
 
667
the info structure in the image's <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstSample.html#GstSample"><span class="type">GstSample</span></a>)</p>
 
668
<div class="refsect3">
 
669
<a name="id-1.2.12.3.9.35.4"></a><h4>Members</h4>
 
670
<div class="informaltable"><table width="100%" border="0">
631
671
<colgroup>
632
 
<col align="left" valign="top">
633
 
<col>
 
672
<col width="300px" class="enum_members_name">
 
673
<col class="enum_members_description">
 
674
<col width="200px" class="enum_members_annotations">
634
675
</colgroup>
635
676
<tbody>
636
677
<tr>
637
 
<td><p><a name="GST-TAG-IMAGE-TYPE-NONE:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_NONE</code></span></p></td>
638
 
<td>No image type. Can be used to
 
678
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-NONE:CAPS"></a>GST_TAG_IMAGE_TYPE_NONE</p></td>
 
679
<td class="enum_member_description">
 
680
<p>No image type. Can be used to
639
681
     tell functions such as <code class="function">gst_tag_image_data_to_image_sample()</code> that no
640
 
     image type should be set.
641
 
</td>
642
 
</tr>
643
 
<tr>
644
 
<td><p><a name="GST-TAG-IMAGE-TYPE-UNDEFINED:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_UNDEFINED</code></span></p></td>
645
 
<td>Undefined/other image type
646
 
</td>
647
 
</tr>
648
 
<tr>
649
 
<td><p><a name="GST-TAG-IMAGE-TYPE-FRONT-COVER:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_FRONT_COVER</code></span></p></td>
650
 
<td>Cover (front)
651
 
</td>
652
 
</tr>
653
 
<tr>
654
 
<td><p><a name="GST-TAG-IMAGE-TYPE-BACK-COVER:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_BACK_COVER</code></span></p></td>
655
 
<td>Cover (back)
656
 
</td>
657
 
</tr>
658
 
<tr>
659
 
<td><p><a name="GST-TAG-IMAGE-TYPE-LEAFLET-PAGE:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_LEAFLET_PAGE</code></span></p></td>
660
 
<td>Leaflet page
661
 
</td>
662
 
</tr>
663
 
<tr>
664
 
<td><p><a name="GST-TAG-IMAGE-TYPE-MEDIUM:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_MEDIUM</code></span></p></td>
665
 
<td>Medium (e.g. label side of CD)
666
 
</td>
667
 
</tr>
668
 
<tr>
669
 
<td><p><a name="GST-TAG-IMAGE-TYPE-LEAD-ARTIST:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_LEAD_ARTIST</code></span></p></td>
670
 
<td>Lead artist/lead performer/soloist
671
 
</td>
672
 
</tr>
673
 
<tr>
674
 
<td><p><a name="GST-TAG-IMAGE-TYPE-ARTIST:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_ARTIST</code></span></p></td>
675
 
<td>Artist/performer
676
 
</td>
677
 
</tr>
678
 
<tr>
679
 
<td><p><a name="GST-TAG-IMAGE-TYPE-CONDUCTOR:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_CONDUCTOR</code></span></p></td>
680
 
<td>Conductor
681
 
</td>
682
 
</tr>
683
 
<tr>
684
 
<td><p><a name="GST-TAG-IMAGE-TYPE-BAND-ORCHESTRA:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_BAND_ORCHESTRA</code></span></p></td>
685
 
<td>Band/orchestra
686
 
</td>
687
 
</tr>
688
 
<tr>
689
 
<td><p><a name="GST-TAG-IMAGE-TYPE-COMPOSER:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_COMPOSER</code></span></p></td>
690
 
<td>Composer
691
 
</td>
692
 
</tr>
693
 
<tr>
694
 
<td><p><a name="GST-TAG-IMAGE-TYPE-LYRICIST:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_LYRICIST</code></span></p></td>
695
 
<td>Lyricist/text writer
696
 
</td>
697
 
</tr>
698
 
<tr>
699
 
<td><p><a name="GST-TAG-IMAGE-TYPE-RECORDING-LOCATION:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_RECORDING_LOCATION</code></span></p></td>
700
 
<td>Recording location
701
 
</td>
702
 
</tr>
703
 
<tr>
704
 
<td><p><a name="GST-TAG-IMAGE-TYPE-DURING-RECORDING:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_DURING_RECORDING</code></span></p></td>
705
 
<td>During recording
706
 
</td>
707
 
</tr>
708
 
<tr>
709
 
<td><p><a name="GST-TAG-IMAGE-TYPE-DURING-PERFORMANCE:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_DURING_PERFORMANCE</code></span></p></td>
710
 
<td>During performance
711
 
</td>
712
 
</tr>
713
 
<tr>
714
 
<td><p><a name="GST-TAG-IMAGE-TYPE-VIDEO-CAPTURE:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_VIDEO_CAPTURE</code></span></p></td>
715
 
<td>Movie/video screen capture
716
 
</td>
717
 
</tr>
718
 
<tr>
719
 
<td><p><a name="GST-TAG-IMAGE-TYPE-FISH:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_FISH</code></span></p></td>
720
 
<td>A fish as funny as the ID3v2 spec
721
 
</td>
722
 
</tr>
723
 
<tr>
724
 
<td><p><a name="GST-TAG-IMAGE-TYPE-ILLUSTRATION:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_ILLUSTRATION</code></span></p></td>
725
 
<td>Illustration
726
 
</td>
727
 
</tr>
728
 
<tr>
729
 
<td><p><a name="GST-TAG-IMAGE-TYPE-BAND-ARTIST-LOGO:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_BAND_ARTIST_LOGO</code></span></p></td>
730
 
<td>Band/artist logotype
731
 
</td>
732
 
</tr>
733
 
<tr>
734
 
<td><p><a name="GST-TAG-IMAGE-TYPE-PUBLISHER-STUDIO-LOGO:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_PUBLISHER_STUDIO_LOGO</code></span></p></td>
735
 
<td>Publisher/studio logotype
736
 
</td>
 
682
     image type should be set.</p>
 
683
</td>
 
684
<td class="enum_member_annotations"> </td>
 
685
</tr>
 
686
<tr>
 
687
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-UNDEFINED:CAPS"></a>GST_TAG_IMAGE_TYPE_UNDEFINED</p></td>
 
688
<td class="enum_member_description">
 
689
<p>Undefined/other image type</p>
 
690
</td>
 
691
<td class="enum_member_annotations"> </td>
 
692
</tr>
 
693
<tr>
 
694
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-FRONT-COVER:CAPS"></a>GST_TAG_IMAGE_TYPE_FRONT_COVER</p></td>
 
695
<td class="enum_member_description">
 
696
<p>Cover (front)</p>
 
697
</td>
 
698
<td class="enum_member_annotations"> </td>
 
699
</tr>
 
700
<tr>
 
701
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-BACK-COVER:CAPS"></a>GST_TAG_IMAGE_TYPE_BACK_COVER</p></td>
 
702
<td class="enum_member_description">
 
703
<p>Cover (back)</p>
 
704
</td>
 
705
<td class="enum_member_annotations"> </td>
 
706
</tr>
 
707
<tr>
 
708
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-LEAFLET-PAGE:CAPS"></a>GST_TAG_IMAGE_TYPE_LEAFLET_PAGE</p></td>
 
709
<td class="enum_member_description">
 
710
<p>Leaflet page</p>
 
711
</td>
 
712
<td class="enum_member_annotations"> </td>
 
713
</tr>
 
714
<tr>
 
715
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-MEDIUM:CAPS"></a>GST_TAG_IMAGE_TYPE_MEDIUM</p></td>
 
716
<td class="enum_member_description">
 
717
<p>Medium (e.g. label side of CD)</p>
 
718
</td>
 
719
<td class="enum_member_annotations"> </td>
 
720
</tr>
 
721
<tr>
 
722
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-LEAD-ARTIST:CAPS"></a>GST_TAG_IMAGE_TYPE_LEAD_ARTIST</p></td>
 
723
<td class="enum_member_description">
 
724
<p>Lead artist/lead performer/soloist</p>
 
725
</td>
 
726
<td class="enum_member_annotations"> </td>
 
727
</tr>
 
728
<tr>
 
729
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-ARTIST:CAPS"></a>GST_TAG_IMAGE_TYPE_ARTIST</p></td>
 
730
<td class="enum_member_description">
 
731
<p>Artist/performer</p>
 
732
</td>
 
733
<td class="enum_member_annotations"> </td>
 
734
</tr>
 
735
<tr>
 
736
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-CONDUCTOR:CAPS"></a>GST_TAG_IMAGE_TYPE_CONDUCTOR</p></td>
 
737
<td class="enum_member_description">
 
738
<p>Conductor</p>
 
739
</td>
 
740
<td class="enum_member_annotations"> </td>
 
741
</tr>
 
742
<tr>
 
743
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-BAND-ORCHESTRA:CAPS"></a>GST_TAG_IMAGE_TYPE_BAND_ORCHESTRA</p></td>
 
744
<td class="enum_member_description">
 
745
<p>Band/orchestra</p>
 
746
</td>
 
747
<td class="enum_member_annotations"> </td>
 
748
</tr>
 
749
<tr>
 
750
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-COMPOSER:CAPS"></a>GST_TAG_IMAGE_TYPE_COMPOSER</p></td>
 
751
<td class="enum_member_description">
 
752
<p>Composer</p>
 
753
</td>
 
754
<td class="enum_member_annotations"> </td>
 
755
</tr>
 
756
<tr>
 
757
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-LYRICIST:CAPS"></a>GST_TAG_IMAGE_TYPE_LYRICIST</p></td>
 
758
<td class="enum_member_description">
 
759
<p>Lyricist/text writer</p>
 
760
</td>
 
761
<td class="enum_member_annotations"> </td>
 
762
</tr>
 
763
<tr>
 
764
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-RECORDING-LOCATION:CAPS"></a>GST_TAG_IMAGE_TYPE_RECORDING_LOCATION</p></td>
 
765
<td class="enum_member_description">
 
766
<p>Recording location</p>
 
767
</td>
 
768
<td class="enum_member_annotations"> </td>
 
769
</tr>
 
770
<tr>
 
771
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-DURING-RECORDING:CAPS"></a>GST_TAG_IMAGE_TYPE_DURING_RECORDING</p></td>
 
772
<td class="enum_member_description">
 
773
<p>During recording</p>
 
774
</td>
 
775
<td class="enum_member_annotations"> </td>
 
776
</tr>
 
777
<tr>
 
778
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-DURING-PERFORMANCE:CAPS"></a>GST_TAG_IMAGE_TYPE_DURING_PERFORMANCE</p></td>
 
779
<td class="enum_member_description">
 
780
<p>During performance</p>
 
781
</td>
 
782
<td class="enum_member_annotations"> </td>
 
783
</tr>
 
784
<tr>
 
785
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-VIDEO-CAPTURE:CAPS"></a>GST_TAG_IMAGE_TYPE_VIDEO_CAPTURE</p></td>
 
786
<td class="enum_member_description">
 
787
<p>Movie/video screen capture</p>
 
788
</td>
 
789
<td class="enum_member_annotations"> </td>
 
790
</tr>
 
791
<tr>
 
792
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-FISH:CAPS"></a>GST_TAG_IMAGE_TYPE_FISH</p></td>
 
793
<td class="enum_member_description">
 
794
<p>A fish as funny as the ID3v2 spec</p>
 
795
</td>
 
796
<td class="enum_member_annotations"> </td>
 
797
</tr>
 
798
<tr>
 
799
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-ILLUSTRATION:CAPS"></a>GST_TAG_IMAGE_TYPE_ILLUSTRATION</p></td>
 
800
<td class="enum_member_description">
 
801
<p>Illustration</p>
 
802
</td>
 
803
<td class="enum_member_annotations"> </td>
 
804
</tr>
 
805
<tr>
 
806
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-BAND-ARTIST-LOGO:CAPS"></a>GST_TAG_IMAGE_TYPE_BAND_ARTIST_LOGO</p></td>
 
807
<td class="enum_member_description">
 
808
<p>Band/artist logotype</p>
 
809
</td>
 
810
<td class="enum_member_annotations"> </td>
 
811
</tr>
 
812
<tr>
 
813
<td class="enum_member_name"><p><a name="GST-TAG-IMAGE-TYPE-PUBLISHER-STUDIO-LOGO:CAPS"></a>GST_TAG_IMAGE_TYPE_PUBLISHER_STUDIO_LOGO</p></td>
 
814
<td class="enum_member_description">
 
815
<p>Publisher/studio logotype</p>
 
816
</td>
 
817
<td class="enum_member_annotations"> </td>
737
818
</tr>
738
819
</tbody>
739
820
</table></div>
740
821
</div>
741
822
</div>
 
823
</div>
742
824
<div class="refsect1">
743
825
<a name="gst-plugins-base-libs-gsttag.see-also"></a><h2>See Also</h2>
744
 
<a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstTagList.html#GstTagList"><span class="type">GstTagList</span></a>
 
826
<p><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstTagList.html#GstTagList"><span class="type">GstTagList</span></a></p>
745
827
</div>
746
828
</div>
747
829
<div class="footer">
748
830
<hr>
749
 
          Generated by GTK-Doc V1.19</div>
 
831
          Generated by GTK-Doc V1.20</div>
750
832
</body>
751
833
</html>
 
 
b'\\ No newline at end of file'