Initialize Tizen 2.3
[framework/multimedia/gstreamer0.10.git] / wearable / docs / gst / html / gstreamer-GstValue.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>GstValue</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7 <link rel="home" href="index.html" title="GStreamer 0.10 Core Reference Manual">
8 <link rel="up" href="libgstreamer.html" title="GStreamer Core Library">
9 <link rel="prev" href="gstreamer-GstUtils.html" title="GstUtils">
10 <link rel="next" href="gstreamer-GstVersion.html" title="GstVersion">
11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
13 </head>
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-GstUtils.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="libgstreamer.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 0.10 Core Reference Manual</th>
21 <td><a accesskey="n" href="gstreamer-GstVersion.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="#gstreamer-GstValue.synopsis" class="shortcut">Top</a>
25                    | 
26                   <a href="#gstreamer-GstValue.description" class="shortcut">Description</a>
27 </td></tr>
28 </table>
29 <div class="refentry">
30 <a name="gstreamer-GstValue"></a><div class="titlepage"></div>
31 <div class="refnamediv"><table width="100%"><tr>
32 <td valign="top">
33 <h2><span class="refentrytitle"><a name="gstreamer-GstValue.top_of_page"></a>GstValue</span></h2>
34 <p>GstValue — GValue implementations specific
35 to GStreamer</p>
36 </td>
37 <td valign="top" align="right"></td>
38 </tr></table></div>
39 <div class="refsynopsisdiv">
40 <a name="gstreamer-GstValue.synopsis"></a><h2>Synopsis</h2>
41 <pre class="synopsis">
42 #include &lt;gst/gst.h&gt;
43
44 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-HOLDS-FOURCC:CAPS" title="GST_VALUE_HOLDS_FOURCC()">GST_VALUE_HOLDS_FOURCC</a>              (x)
45 #define             <a class="link" href="gstreamer-GstValue.html#GST-MAKE-FOURCC:CAPS" title="GST_MAKE_FOURCC()">GST_MAKE_FOURCC</a>                     (a,
46                                                          b,
47                                                          c,
48                                                          d)
49 #define             <a class="link" href="gstreamer-GstValue.html#GST-STR-FOURCC:CAPS" title="GST_STR_FOURCC()">GST_STR_FOURCC</a>                      (f)
50 #define             <a class="link" href="gstreamer-GstValue.html#GST-FOURCC-FORMAT:CAPS" title="GST_FOURCC_FORMAT">GST_FOURCC_FORMAT</a>
51 #define             <a class="link" href="gstreamer-GstValue.html#GST-FOURCC-ARGS:CAPS" title="GST_FOURCC_ARGS()">GST_FOURCC_ARGS</a>                     (fourcc)
52 #define             <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FOURCC:CAPS" title="GST_TYPE_FOURCC">GST_TYPE_FOURCC</a>
53 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-set-fourcc" title="gst_value_set_fourcc ()">gst_value_set_fourcc</a>                (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
54                                                          <em class="parameter"><code><span class="type">guint32</span> fourcc</code></em>);
55 <span class="returnvalue">guint32</span>             <a class="link" href="gstreamer-GstValue.html#gst-value-get-fourcc" title="gst_value_get_fourcc ()">gst_value_get_fourcc</a>                (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
56
57 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-HOLDS-INT-RANGE:CAPS" title="GST_VALUE_HOLDS_INT_RANGE()">GST_VALUE_HOLDS_INT_RANGE</a>           (x)
58 #define             <a class="link" href="gstreamer-GstValue.html#GST-TYPE-INT-RANGE:CAPS" title="GST_TYPE_INT_RANGE">GST_TYPE_INT_RANGE</a>
59 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-set-int-range" title="gst_value_set_int_range ()">gst_value_set_int_range</a>             (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
60                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> start</code></em>,
61                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> end</code></em>);
62 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gstreamer-GstValue.html#gst-value-get-int-range-min" title="gst_value_get_int_range_min ()">gst_value_get_int_range_min</a>         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
63 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gstreamer-GstValue.html#gst-value-get-int-range-max" title="gst_value_get_int_range_max ()">gst_value_get_int_range_max</a>         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
64
65 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-HOLDS-INT64-RANGE:CAPS" title="GST_VALUE_HOLDS_INT64_RANGE()">GST_VALUE_HOLDS_INT64_RANGE</a>         (x)
66 #define             <a class="link" href="gstreamer-GstValue.html#GST-TYPE-INT64-RANGE:CAPS" title="GST_TYPE_INT64_RANGE">GST_TYPE_INT64_RANGE</a>
67 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-set-int64-range" title="gst_value_set_int64_range ()">gst_value_set_int64_range</a>           (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
68                                                          <em class="parameter"><code><span class="type">gint64</span> start</code></em>,
69                                                          <em class="parameter"><code><span class="type">gint64</span> end</code></em>);
70 <span class="returnvalue">gint64</span>              <a class="link" href="gstreamer-GstValue.html#gst-value-get-int64-range-min" title="gst_value_get_int64_range_min ()">gst_value_get_int64_range_min</a>       (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
71 <span class="returnvalue">gint64</span>              <a class="link" href="gstreamer-GstValue.html#gst-value-get-int64-range-max" title="gst_value_get_int64_range_max ()">gst_value_get_int64_range_max</a>       (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
72
73 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-HOLDS-DOUBLE-RANGE:CAPS" title="GST_VALUE_HOLDS_DOUBLE_RANGE()">GST_VALUE_HOLDS_DOUBLE_RANGE</a>        (x)
74 #define             <a class="link" href="gstreamer-GstValue.html#GST-TYPE-DOUBLE-RANGE:CAPS" title="GST_TYPE_DOUBLE_RANGE">GST_TYPE_DOUBLE_RANGE</a>
75 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-set-double-range" title="gst_value_set_double_range ()">gst_value_set_double_range</a>          (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
76                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> start</code></em>,
77                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> end</code></em>);
78 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>             <a class="link" href="gstreamer-GstValue.html#gst-value-get-double-range-min" title="gst_value_get_double_range_min ()">gst_value_get_double_range_min</a>      (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
79 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>             <a class="link" href="gstreamer-GstValue.html#gst-value-get-double-range-max" title="gst_value_get_double_range_max ()">gst_value_get_double_range_max</a>      (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
80
81 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-HOLDS-LIST:CAPS" title="GST_VALUE_HOLDS_LIST()">GST_VALUE_HOLDS_LIST</a>                (x)
82 #define             <a class="link" href="gstreamer-GstValue.html#GST-TYPE-LIST:CAPS" title="GST_TYPE_LIST">GST_TYPE_LIST</a>
83 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-HOLDS-ARRAY:CAPS" title="GST_VALUE_HOLDS_ARRAY()">GST_VALUE_HOLDS_ARRAY</a>               (x)
84 #define             <a class="link" href="gstreamer-GstValue.html#GST-TYPE-ARRAY:CAPS" title="GST_TYPE_ARRAY">GST_TYPE_ARRAY</a>
85 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-list-append-value" title="gst_value_list_append_value ()">gst_value_list_append_value</a>         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
86                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *append_value</code></em>);
87 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-list-prepend-value" title="gst_value_list_prepend_value ()">gst_value_list_prepend_value</a>        (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
88                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *prepend_value</code></em>);
89 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-list-concat" title="gst_value_list_concat ()">gst_value_list_concat</a>               (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
90                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
91                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);
92 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-list-merge" title="gst_value_list_merge ()">gst_value_list_merge</a>                (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
93                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
94                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);
95 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gstreamer-GstValue.html#gst-value-list-get-size" title="gst_value_list_get_size ()">gst_value_list_get_size</a>             (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
96 const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *      <a class="link" href="gstreamer-GstValue.html#gst-value-list-get-value" title="gst_value_list_get_value ()">gst_value_list_get_value</a>            (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
97                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);
98
99 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-HOLDS-FRACTION:CAPS" title="GST_VALUE_HOLDS_FRACTION()">GST_VALUE_HOLDS_FRACTION</a>            (x)
100 #define             <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FRACTION:CAPS" title="GST_TYPE_FRACTION">GST_TYPE_FRACTION</a>
101 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-set-fraction" title="gst_value_set_fraction ()">gst_value_set_fraction</a>              (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
102                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> numerator</code></em>,
103                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> denominator</code></em>);
104 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gstreamer-GstValue.html#gst-value-get-fraction-numerator" title="gst_value_get_fraction_numerator ()">gst_value_get_fraction_numerator</a>    (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
105 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gstreamer-GstValue.html#gst-value-get-fraction-denominator" title="gst_value_get_fraction_denominator ()">gst_value_get_fraction_denominator</a>  (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
106 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstValue.html#gst-value-fraction-multiply" title="gst_value_fraction_multiply ()">gst_value_fraction_multiply</a>         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *product</code></em>,
107                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *factor1</code></em>,
108                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *factor2</code></em>);
109 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstValue.html#gst-value-fraction-subtract" title="gst_value_fraction_subtract ()">gst_value_fraction_subtract</a>         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
110                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *minuend</code></em>,
111                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *subtrahend</code></em>);
112
113 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-HOLDS-FRACTION-RANGE:CAPS" title="GST_VALUE_HOLDS_FRACTION_RANGE()">GST_VALUE_HOLDS_FRACTION_RANGE</a>      (x)
114 #define             <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FRACTION-RANGE:CAPS" title="GST_TYPE_FRACTION_RANGE">GST_TYPE_FRACTION_RANGE</a>
115 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-set-fraction-range" title="gst_value_set_fraction_range ()">gst_value_set_fraction_range</a>        (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
116                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *start</code></em>,
117                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *end</code></em>);
118 const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *      <a class="link" href="gstreamer-GstValue.html#gst-value-get-fraction-range-min" title="gst_value_get_fraction_range_min ()">gst_value_get_fraction_range_min</a>    (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
119 const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *      <a class="link" href="gstreamer-GstValue.html#gst-value-get-fraction-range-max" title="gst_value_get_fraction_range_max ()">gst_value_get_fraction_range_max</a>    (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
120 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-set-fraction-range-full" title="gst_value_set_fraction_range_full ()">gst_value_set_fraction_range_full</a>   (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
121                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> numerator_start</code></em>,
122                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> denominator_start</code></em>,
123                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> numerator_end</code></em>,
124                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> denominator_end</code></em>);
125
126 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-HOLDS-DATE:CAPS" title="GST_VALUE_HOLDS_DATE()">GST_VALUE_HOLDS_DATE</a>                (x)
127 #define             <a class="link" href="gstreamer-GstValue.html#GST-TYPE-DATE:CAPS" title="GST_TYPE_DATE">GST_TYPE_DATE</a>
128 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-set-date" title="gst_value_set_date ()">gst_value_set_date</a>                  (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
129                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *date</code></em>);
130 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="returnvalue">GDate</span></a> *       <a class="link" href="gstreamer-GstValue.html#gst-value-get-date" title="gst_value_get_date ()">gst_value_get_date</a>                  (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
131
132 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-HOLDS-DATE-TIME:CAPS" title="GST_VALUE_HOLDS_DATE_TIME()">GST_VALUE_HOLDS_DATE_TIME</a>           (x)
133
134 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-HOLDS-CAPS" title="GST_VALUE_HOLDS_CAPS()">GST_VALUE_HOLDS_CAPS</a>                (x)
135 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-set-caps" title="gst_value_set_caps ()">gst_value_set_caps</a>                  (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
136                                                          <em class="parameter"><code>const <a class="link" href="gstreamer-GstCaps.html#GstCaps" title="struct GstCaps"><span class="type">GstCaps</span></a> *caps</code></em>);
137 const <a class="link" href="gstreamer-GstCaps.html#GstCaps" title="struct GstCaps"><span class="returnvalue">GstCaps</span></a> *     <a class="link" href="gstreamer-GstValue.html#gst-value-get-caps" title="gst_value_get_caps ()">gst_value_get_caps</a>                  (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
138
139 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-HOLDS-STRUCTURE:CAPS" title="GST_VALUE_HOLDS_STRUCTURE()">GST_VALUE_HOLDS_STRUCTURE</a>           (x)
140 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-set-structure" title="gst_value_set_structure ()">gst_value_set_structure</a>             (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
141                                                          <em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>);
142 const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> * <a class="link" href="gstreamer-GstValue.html#gst-value-get-structure" title="gst_value_get_structure ()">gst_value_get_structure</a>            (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
143
144 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-HOLDS-MINI-OBJECT:CAPS" title="GST_VALUE_HOLDS_MINI_OBJECT()">GST_VALUE_HOLDS_MINI_OBJECT</a>         (value)
145 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-HOLDS-BUFFER:CAPS" title="GST_VALUE_HOLDS_BUFFER()">GST_VALUE_HOLDS_BUFFER</a>              (x)
146 #define             <a class="link" href="gstreamer-GstValue.html#gst-value-get-buffer" title="gst_value_get_buffer()">gst_value_get_buffer</a>                (v)
147 #define             <a class="link" href="gstreamer-GstValue.html#gst-value-set-buffer" title="gst_value_set_buffer()">gst_value_set_buffer</a>                (v,
148                                                          b)
149 #define             <a class="link" href="gstreamer-GstValue.html#gst-value-take-buffer" title="gst_value_take_buffer()">gst_value_take_buffer</a>               (v,
150                                                          b)
151
152 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-LESS-THAN:CAPS" title="GST_VALUE_LESS_THAN">GST_VALUE_LESS_THAN</a>
153 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-EQUAL:CAPS" title="GST_VALUE_EQUAL">GST_VALUE_EQUAL</a>
154 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-GREATER-THAN:CAPS" title="GST_VALUE_GREATER_THAN">GST_VALUE_GREATER_THAN</a>
155 #define             <a class="link" href="gstreamer-GstValue.html#GST-VALUE-UNORDERED:CAPS" title="GST_VALUE_UNORDERED">GST_VALUE_UNORDERED</a>
156 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                (<a class="link" href="gstreamer-GstValue.html#GstValueCompareFunc" title="GstValueCompareFunc ()">*GstValueCompareFunc</a>)              (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
157                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);
158 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             (<a class="link" href="gstreamer-GstValue.html#GstValueSerializeFunc" title="GstValueSerializeFunc ()">*GstValueSerializeFunc</a>)            (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>);
159 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (<a class="link" href="gstreamer-GstValue.html#GstValueDeserializeFunc" title="GstValueDeserializeFunc ()">*GstValueDeserializeFunc</a>)          (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
160                                                          <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> *s</code></em>);
161 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (<a class="link" href="gstreamer-GstValue.html#GstValueUnionFunc" title="GstValueUnionFunc ()">*GstValueUnionFunc</a>)                (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
162                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
163                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);
164 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (<a class="link" href="gstreamer-GstValue.html#GstValueIntersectFunc" title="GstValueIntersectFunc ()">*GstValueIntersectFunc</a>)            (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
165                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
166                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);
167 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (<a class="link" href="gstreamer-GstValue.html#GstValueSubtractFunc" title="GstValueSubtractFunc ()">*GstValueSubtractFunc</a>)             (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
168                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *minuend</code></em>,
169                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *subtrahend</code></em>);
170 struct              <a class="link" href="gstreamer-GstValue.html#GstValueTable" title="struct GstValueTable">GstValueTable</a>;
171 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstValue.html#gst-value-is-fixed" title="gst_value_is_fixed ()">gst_value_is_fixed</a>                  (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
172 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-register" title="gst_value_register ()">gst_value_register</a>                  (<em class="parameter"><code>const <a class="link" href="gstreamer-GstValue.html#GstValueTable" title="struct GstValueTable"><span class="type">GstValueTable</span></a> *table</code></em>);
173 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-init-and-copy" title="gst_value_init_and_copy ()">gst_value_init_and_copy</a>             (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
174                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *src</code></em>);
175 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="gstreamer-GstValue.html#gst-value-serialize" title="gst_value_serialize ()">gst_value_serialize</a>                 (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
176 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstValue.html#gst-value-deserialize" title="gst_value_deserialize ()">gst_value_deserialize</a>               (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
177                                                          <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> *src</code></em>);
178 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gstreamer-GstValue.html#gst-value-compare" title="gst_value_compare ()">gst_value_compare</a>                   (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
179                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);
180 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstValue.html#gst-value-can-compare" title="gst_value_can_compare ()">gst_value_can_compare</a>               (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
181                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);
182 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstValue.html#gst-value-union" title="gst_value_union ()">gst_value_union</a>                     (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
183                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
184                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);
185 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstValue.html#gst-value-can-union" title="gst_value_can_union ()">gst_value_can_union</a>                 (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
186                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);
187 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-register-union-func" title="gst_value_register_union_func ()">gst_value_register_union_func</a>       (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type1</code></em>,
188                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type2</code></em>,
189                                                          <em class="parameter"><code><a class="link" href="gstreamer-GstValue.html#GstValueUnionFunc" title="GstValueUnionFunc ()"><span class="type">GstValueUnionFunc</span></a> func</code></em>);
190 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstValue.html#gst-value-subtract" title="gst_value_subtract ()">gst_value_subtract</a>                  (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
191                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *minuend</code></em>,
192                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *subtrahend</code></em>);
193 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstValue.html#gst-value-can-subtract" title="gst_value_can_subtract ()">gst_value_can_subtract</a>              (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *minuend</code></em>,
194                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *subtrahend</code></em>);
195 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-register-subtract-func" title="gst_value_register_subtract_func ()">gst_value_register_subtract_func</a>    (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> minuend_type</code></em>,
196                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> subtrahend_type</code></em>,
197                                                          <em class="parameter"><code><a class="link" href="gstreamer-GstValue.html#GstValueSubtractFunc" title="GstValueSubtractFunc ()"><span class="type">GstValueSubtractFunc</span></a> func</code></em>);
198 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstValue.html#gst-value-intersect" title="gst_value_intersect ()">gst_value_intersect</a>                 (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
199                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
200                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);
201 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstValue.html#gst-value-can-intersect" title="gst_value_can_intersect ()">gst_value_can_intersect</a>             (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
202                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);
203 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-register-intersect-func" title="gst_value_register_intersect_func ()">gst_value_register_intersect_func</a>   (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type1</code></em>,
204                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type2</code></em>,
205                                                          <em class="parameter"><code><a class="link" href="gstreamer-GstValue.html#GstValueIntersectFunc" title="GstValueIntersectFunc ()"><span class="type">GstValueIntersectFunc</span></a> func</code></em>);
206 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-array-append-value" title="gst_value_array_append_value ()">gst_value_array_append_value</a>        (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
207                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *append_value</code></em>);
208 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gstreamer-GstValue.html#gst-value-array-get-size" title="gst_value_array_get_size ()">gst_value_array_get_size</a>            (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
209 const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *      <a class="link" href="gstreamer-GstValue.html#gst-value-array-get-value" title="gst_value_array_get_value ()">gst_value_array_get_value</a>           (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
210                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);
211 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstValue.html#gst-value-array-prepend-value" title="gst_value_array_prepend_value ()">gst_value_array_prepend_value</a>       (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
212                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *prepend_value</code></em>);
213 </pre>
214 </div>
215 <div class="refsect1">
216 <a name="gstreamer-GstValue.description"></a><h2>Description</h2>
217 <p>
218 GValue implementations specific to GStreamer.
219 </p>
220 <p>
221 Note that operations on the same <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> from multiple threads may lead to
222 undefined behaviour.
223 </p>
224 <p>
225 Last reviewed on 2008-03-11 (0.10.18)
226 </p>
227 </div>
228 <div class="refsect1">
229 <a name="gstreamer-GstValue.details"></a><h2>Details</h2>
230 <div class="refsect2">
231 <a name="GST-VALUE-HOLDS-FOURCC:CAPS"></a><h3>GST_VALUE_HOLDS_FOURCC()</h3>
232 <pre class="programlisting">#define GST_VALUE_HOLDS_FOURCC(x)       (G_VALUE_HOLDS((x), gst_fourcc_get_type ()))
233 </pre>
234 <p>
235 Checks if the given <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> contains a <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FOURCC:CAPS" title="GST_TYPE_FOURCC"><span class="type">GST_TYPE_FOURCC</span></a> value.
236 </p>
237 <div class="variablelist"><table border="0">
238 <col align="left" valign="top">
239 <tbody><tr>
240 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
241 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to check</td>
242 </tr></tbody>
243 </table></div>
244 </div>
245 <hr>
246 <div class="refsect2">
247 <a name="GST-MAKE-FOURCC:CAPS"></a><h3>GST_MAKE_FOURCC()</h3>
248 <pre class="programlisting">#define GST_MAKE_FOURCC(a,b,c,d)        ((guint32)((a)|(b)&lt;&lt;8|(c)&lt;&lt;16|(d)&lt;&lt;24))
249 </pre>
250 <p>
251 Transform four characters into a <span class="type">guint32</span> fourcc value with host
252 endianness.
253 </p>
254 <div class="informalexample">
255   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
256     <tbody>
257       <tr>
258         <td class="listing_lines" align="right"><pre>1</pre></td>
259         <td class="listing_code"><pre class="programlisting">guint32 fourcc <span class="gtkdoc opt">=</span> <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstValue.html#GST-MAKE-FOURCC:CAPS">GST_MAKE_FOURCC</a></span> <span class="gtkdoc opt">(</span><span class="string">'M'</span><span class="gtkdoc opt">,</span> <span class="string">'J'</span><span class="gtkdoc opt">,</span> <span class="string">'P'</span><span class="gtkdoc opt">,</span> <span class="string">'G'</span><span class="gtkdoc opt">);</span></pre></td>
260       </tr>
261     </tbody>
262   </table>
263 </div>
264
265 <p>
266 </p>
267 <div class="variablelist"><table border="0">
268 <col align="left" valign="top">
269 <tbody>
270 <tr>
271 <td><p><span class="term"><em class="parameter"><code>a</code></em> :</span></p></td>
272 <td>the first character</td>
273 </tr>
274 <tr>
275 <td><p><span class="term"><em class="parameter"><code>b</code></em> :</span></p></td>
276 <td>the second character</td>
277 </tr>
278 <tr>
279 <td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
280 <td>the third character</td>
281 </tr>
282 <tr>
283 <td><p><span class="term"><em class="parameter"><code>d</code></em> :</span></p></td>
284 <td>the fourth character</td>
285 </tr>
286 </tbody>
287 </table></div>
288 </div>
289 <hr>
290 <div class="refsect2">
291 <a name="GST-STR-FOURCC:CAPS"></a><h3>GST_STR_FOURCC()</h3>
292 <pre class="programlisting">#define GST_STR_FOURCC(f)               ((guint32)(((f)[0])|((f)[1]&lt;&lt;8)|((f)[2]&lt;&lt;16)|((f)[3]&lt;&lt;24)))
293 </pre>
294 <p>
295 Transform an input string into a <span class="type">guint32</span> fourcc value with host
296 endianness.
297 Caller is responsible for ensuring the input string consists of at least
298 four characters.
299 </p>
300 <div class="informalexample">
301   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
302     <tbody>
303       <tr>
304         <td class="listing_lines" align="right"><pre>1</pre></td>
305         <td class="listing_code"><pre class="programlisting">guint32 fourcc <span class="gtkdoc opt">=</span> <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstValue.html#GST-STR-FOURCC:CAPS">GST_STR_FOURCC</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;MJPG&quot;</span><span class="gtkdoc opt">);</span></pre></td>
306       </tr>
307     </tbody>
308   </table>
309 </div>
310
311 <p>
312 </p>
313 <div class="variablelist"><table border="0">
314 <col align="left" valign="top">
315 <tbody><tr>
316 <td><p><span class="term"><em class="parameter"><code>f</code></em> :</span></p></td>
317 <td>a string with at least four characters</td>
318 </tr></tbody>
319 </table></div>
320 </div>
321 <hr>
322 <div class="refsect2">
323 <a name="GST-FOURCC-FORMAT:CAPS"></a><h3>GST_FOURCC_FORMAT</h3>
324 <pre class="programlisting">#define GST_FOURCC_FORMAT "c%c%c%c"
325 </pre>
326 <p>
327 Can be used together with <a class="link" href="gstreamer-GstValue.html#GST-FOURCC-ARGS:CAPS" title="GST_FOURCC_ARGS()"><span class="type">GST_FOURCC_ARGS</span></a> to properly output a
328 <span class="type">guint32</span> fourcc value in a <code class="function">printf()</code>-style text message.
329 </p>
330 <div class="informalexample">
331   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
332     <tbody>
333       <tr>
334         <td class="listing_lines" align="right"><pre>1</pre></td>
335         <td class="listing_code"><pre class="programlisting"><span class="function">printf</span> <span class="gtkdoc opt">(</span><span class="string">&quot;fourcc: %&quot;</span> GST_FOURCC_FORMAT <span class="string">&quot;</span><span class="gtkdoc esc">\n</span><span class="string">&quot;</span><span class="gtkdoc opt">,</span> <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstValue.html#GST-FOURCC-ARGS:CAPS">GST_FOURCC_ARGS</a></span> <span class="gtkdoc opt">(</span>fcc<span class="gtkdoc opt">));</span></pre></td>
336       </tr>
337     </tbody>
338   </table>
339 </div>
340
341 <p>
342 </p>
343 </div>
344 <hr>
345 <div class="refsect2">
346 <a name="GST-FOURCC-ARGS:CAPS"></a><h3>GST_FOURCC_ARGS()</h3>
347 <pre class="programlisting">#define             GST_FOURCC_ARGS(fourcc)</pre>
348 <p>
349 Can be used together with <a class="link" href="gstreamer-GstValue.html#GST-FOURCC-FORMAT:CAPS" title="GST_FOURCC_FORMAT"><span class="type">GST_FOURCC_FORMAT</span></a> to properly output a
350 <span class="type">guint32</span> fourcc value in a <code class="function">printf()</code>-style text message.
351 </p>
352 <div class="variablelist"><table border="0">
353 <col align="left" valign="top">
354 <tbody><tr>
355 <td><p><span class="term"><em class="parameter"><code>fourcc</code></em> :</span></p></td>
356 <td>a <span class="type">guint32</span> fourcc value to output</td>
357 </tr></tbody>
358 </table></div>
359 </div>
360 <hr>
361 <div class="refsect2">
362 <a name="GST-TYPE-FOURCC:CAPS"></a><h3>GST_TYPE_FOURCC</h3>
363 <pre class="programlisting">#define GST_TYPE_FOURCC                  gst_fourcc_get_type ()
364 </pre>
365 <p>
366 a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> type that represents 4 byte identifier (e.g. used for codecs)
367 </p>
368 <div class="variablelist"><table border="0">
369 <col align="left" valign="top">
370 <tbody><tr>
371 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
372 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of GstFourcc</td>
373 </tr></tbody>
374 </table></div>
375 </div>
376 <hr>
377 <div class="refsect2">
378 <a name="gst-value-set-fourcc"></a><h3>gst_value_set_fourcc ()</h3>
379 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_set_fourcc                (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
380                                                          <em class="parameter"><code><span class="type">guint32</span> fourcc</code></em>);</pre>
381 <p>
382 Sets <em class="parameter"><code>value</code></em> to <em class="parameter"><code>fourcc</code></em>.
383 </p>
384 <div class="variablelist"><table border="0">
385 <col align="left" valign="top">
386 <tbody>
387 <tr>
388 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
389 <td>a GValue initialized to <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FOURCC:CAPS" title="GST_TYPE_FOURCC"><span class="type">GST_TYPE_FOURCC</span></a>
390 </td>
391 </tr>
392 <tr>
393 <td><p><span class="term"><em class="parameter"><code>fourcc</code></em> :</span></p></td>
394 <td>the <span class="type">guint32</span> fourcc to set</td>
395 </tr>
396 </tbody>
397 </table></div>
398 </div>
399 <hr>
400 <div class="refsect2">
401 <a name="gst-value-get-fourcc"></a><h3>gst_value_get_fourcc ()</h3>
402 <pre class="programlisting"><span class="returnvalue">guint32</span>             gst_value_get_fourcc                (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
403 <p>
404 Gets the <span class="type">guint32</span> fourcc contained in <em class="parameter"><code>value</code></em>.
405 </p>
406 <div class="variablelist"><table border="0">
407 <col align="left" valign="top">
408 <tbody>
409 <tr>
410 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
411 <td>a GValue initialized to <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FOURCC:CAPS" title="GST_TYPE_FOURCC"><span class="type">GST_TYPE_FOURCC</span></a>
412 </td>
413 </tr>
414 <tr>
415 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
416 <td>the <span class="type">guint32</span> fourcc contained in <em class="parameter"><code>value</code></em>.</td>
417 </tr>
418 </tbody>
419 </table></div>
420 </div>
421 <hr>
422 <div class="refsect2">
423 <a name="GST-VALUE-HOLDS-INT-RANGE:CAPS"></a><h3>GST_VALUE_HOLDS_INT_RANGE()</h3>
424 <pre class="programlisting">#define GST_VALUE_HOLDS_INT_RANGE(x)    (G_VALUE_HOLDS((x), gst_int_range_get_type ()))
425 </pre>
426 <p>
427 Checks if the given <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> contains a <a class="link" href="gstreamer-GstValue.html#GST-TYPE-INT-RANGE:CAPS" title="GST_TYPE_INT_RANGE"><span class="type">GST_TYPE_INT_RANGE</span></a> value.
428 </p>
429 <div class="variablelist"><table border="0">
430 <col align="left" valign="top">
431 <tbody><tr>
432 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
433 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to check</td>
434 </tr></tbody>
435 </table></div>
436 </div>
437 <hr>
438 <div class="refsect2">
439 <a name="GST-TYPE-INT-RANGE:CAPS"></a><h3>GST_TYPE_INT_RANGE</h3>
440 <pre class="programlisting">#define GST_TYPE_INT_RANGE               gst_int_range_get_type ()
441 </pre>
442 <p>
443 a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> type that represents an integer range
444 </p>
445 <div class="variablelist"><table border="0">
446 <col align="left" valign="top">
447 <tbody><tr>
448 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
449 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of GstIntRange</td>
450 </tr></tbody>
451 </table></div>
452 </div>
453 <hr>
454 <div class="refsect2">
455 <a name="gst-value-set-int-range"></a><h3>gst_value_set_int_range ()</h3>
456 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_set_int_range             (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
457                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> start</code></em>,
458                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> end</code></em>);</pre>
459 <p>
460 Sets <em class="parameter"><code>value</code></em> to the range specified by <em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em>.
461 </p>
462 <div class="variablelist"><table border="0">
463 <col align="left" valign="top">
464 <tbody>
465 <tr>
466 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
467 <td>a GValue initialized to GST_TYPE_INT_RANGE</td>
468 </tr>
469 <tr>
470 <td><p><span class="term"><em class="parameter"><code>start</code></em> :</span></p></td>
471 <td>the start of the range</td>
472 </tr>
473 <tr>
474 <td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td>
475 <td>the end of the range</td>
476 </tr>
477 </tbody>
478 </table></div>
479 </div>
480 <hr>
481 <div class="refsect2">
482 <a name="gst-value-get-int-range-min"></a><h3>gst_value_get_int_range_min ()</h3>
483 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gst_value_get_int_range_min         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
484 <p>
485 Gets the minimum of the range specified by <em class="parameter"><code>value</code></em>.
486 </p>
487 <div class="variablelist"><table border="0">
488 <col align="left" valign="top">
489 <tbody>
490 <tr>
491 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
492 <td>a GValue initialized to GST_TYPE_INT_RANGE</td>
493 </tr>
494 <tr>
495 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
496 <td>the minimum of the range</td>
497 </tr>
498 </tbody>
499 </table></div>
500 </div>
501 <hr>
502 <div class="refsect2">
503 <a name="gst-value-get-int-range-max"></a><h3>gst_value_get_int_range_max ()</h3>
504 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gst_value_get_int_range_max         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
505 <p>
506 Gets the maximum of the range specified by <em class="parameter"><code>value</code></em>.
507 </p>
508 <div class="variablelist"><table border="0">
509 <col align="left" valign="top">
510 <tbody>
511 <tr>
512 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
513 <td>a GValue initialized to GST_TYPE_INT_RANGE</td>
514 </tr>
515 <tr>
516 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
517 <td>the maxumum of the range</td>
518 </tr>
519 </tbody>
520 </table></div>
521 </div>
522 <hr>
523 <div class="refsect2">
524 <a name="GST-VALUE-HOLDS-INT64-RANGE:CAPS"></a><h3>GST_VALUE_HOLDS_INT64_RANGE()</h3>
525 <pre class="programlisting">#define GST_VALUE_HOLDS_INT64_RANGE(x)    (G_VALUE_HOLDS((x), gst_int64_range_get_type ()))
526 </pre>
527 <p>
528 Checks if the given <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> contains a <a class="link" href="gstreamer-GstValue.html#GST-TYPE-INT64-RANGE:CAPS" title="GST_TYPE_INT64_RANGE"><span class="type">GST_TYPE_INT64_RANGE</span></a> value.
529 </p>
530 <div class="variablelist"><table border="0">
531 <col align="left" valign="top">
532 <tbody><tr>
533 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
534 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to check</td>
535 </tr></tbody>
536 </table></div>
537 <p class="since">Since 0.10.31</p>
538 </div>
539 <hr>
540 <div class="refsect2">
541 <a name="GST-TYPE-INT64-RANGE:CAPS"></a><h3>GST_TYPE_INT64_RANGE</h3>
542 <pre class="programlisting">#define GST_TYPE_INT64_RANGE             gst_int64_range_get_type ()
543 </pre>
544 <p>
545 a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> type that represents an <span class="type">gint64</span> range
546 </p>
547 <div class="variablelist"><table border="0">
548 <col align="left" valign="top">
549 <tbody><tr>
550 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
551 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of GstInt64Range</td>
552 </tr></tbody>
553 </table></div>
554 <p class="since">Since 0.10.31</p>
555 </div>
556 <hr>
557 <div class="refsect2">
558 <a name="gst-value-set-int64-range"></a><h3>gst_value_set_int64_range ()</h3>
559 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_set_int64_range           (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
560                                                          <em class="parameter"><code><span class="type">gint64</span> start</code></em>,
561                                                          <em class="parameter"><code><span class="type">gint64</span> end</code></em>);</pre>
562 <p>
563 Sets <em class="parameter"><code>value</code></em> to the range specified by <em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em>.
564 </p>
565 <div class="variablelist"><table border="0">
566 <col align="left" valign="top">
567 <tbody>
568 <tr>
569 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
570 <td>a GValue initialized to GST_TYPE_INT64_RANGE</td>
571 </tr>
572 <tr>
573 <td><p><span class="term"><em class="parameter"><code>start</code></em> :</span></p></td>
574 <td>the start of the range</td>
575 </tr>
576 <tr>
577 <td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td>
578 <td>the end of the range</td>
579 </tr>
580 </tbody>
581 </table></div>
582 <p class="since">Since 0.10.31</p>
583 </div>
584 <hr>
585 <div class="refsect2">
586 <a name="gst-value-get-int64-range-min"></a><h3>gst_value_get_int64_range_min ()</h3>
587 <pre class="programlisting"><span class="returnvalue">gint64</span>              gst_value_get_int64_range_min       (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
588 <p>
589 Gets the minimum of the range specified by <em class="parameter"><code>value</code></em>.
590 </p>
591 <div class="variablelist"><table border="0">
592 <col align="left" valign="top">
593 <tbody>
594 <tr>
595 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
596 <td>a GValue initialized to GST_TYPE_INT64_RANGE</td>
597 </tr>
598 <tr>
599 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
600 <td>the minimum of the range</td>
601 </tr>
602 </tbody>
603 </table></div>
604 <p class="since">Since 0.10.31</p>
605 </div>
606 <hr>
607 <div class="refsect2">
608 <a name="gst-value-get-int64-range-max"></a><h3>gst_value_get_int64_range_max ()</h3>
609 <pre class="programlisting"><span class="returnvalue">gint64</span>              gst_value_get_int64_range_max       (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
610 <p>
611 Gets the maximum of the range specified by <em class="parameter"><code>value</code></em>.
612 </p>
613 <div class="variablelist"><table border="0">
614 <col align="left" valign="top">
615 <tbody>
616 <tr>
617 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
618 <td>a GValue initialized to GST_TYPE_INT64_RANGE</td>
619 </tr>
620 <tr>
621 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
622 <td>the maxumum of the range</td>
623 </tr>
624 </tbody>
625 </table></div>
626 <p class="since">Since 0.10.31</p>
627 </div>
628 <hr>
629 <div class="refsect2">
630 <a name="GST-VALUE-HOLDS-DOUBLE-RANGE:CAPS"></a><h3>GST_VALUE_HOLDS_DOUBLE_RANGE()</h3>
631 <pre class="programlisting">#define GST_VALUE_HOLDS_DOUBLE_RANGE(x) (G_VALUE_HOLDS((x), gst_double_range_get_type ()))
632 </pre>
633 <p>
634 Checks if the given <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> contains a <a class="link" href="gstreamer-GstValue.html#GST-TYPE-DOUBLE-RANGE:CAPS" title="GST_TYPE_DOUBLE_RANGE"><span class="type">GST_TYPE_DOUBLE_RANGE</span></a> value.
635 </p>
636 <div class="variablelist"><table border="0">
637 <col align="left" valign="top">
638 <tbody><tr>
639 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
640 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to check</td>
641 </tr></tbody>
642 </table></div>
643 </div>
644 <hr>
645 <div class="refsect2">
646 <a name="GST-TYPE-DOUBLE-RANGE:CAPS"></a><h3>GST_TYPE_DOUBLE_RANGE</h3>
647 <pre class="programlisting">#define GST_TYPE_DOUBLE_RANGE            gst_double_range_get_type ()
648 </pre>
649 <p>
650 a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> type that represents a floating point range with double precission
651 </p>
652 <div class="variablelist"><table border="0">
653 <col align="left" valign="top">
654 <tbody><tr>
655 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
656 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of GstIntRange</td>
657 </tr></tbody>
658 </table></div>
659 </div>
660 <hr>
661 <div class="refsect2">
662 <a name="gst-value-set-double-range"></a><h3>gst_value_set_double_range ()</h3>
663 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_set_double_range          (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
664                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> start</code></em>,
665                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> end</code></em>);</pre>
666 <p>
667 Sets <em class="parameter"><code>value</code></em> to the range specified by <em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em>.
668 </p>
669 <div class="variablelist"><table border="0">
670 <col align="left" valign="top">
671 <tbody>
672 <tr>
673 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
674 <td>a GValue initialized to GST_TYPE_DOUBLE_RANGE</td>
675 </tr>
676 <tr>
677 <td><p><span class="term"><em class="parameter"><code>start</code></em> :</span></p></td>
678 <td>the start of the range</td>
679 </tr>
680 <tr>
681 <td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td>
682 <td>the end of the range</td>
683 </tr>
684 </tbody>
685 </table></div>
686 </div>
687 <hr>
688 <div class="refsect2">
689 <a name="gst-value-get-double-range-min"></a><h3>gst_value_get_double_range_min ()</h3>
690 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>             gst_value_get_double_range_min      (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
691 <p>
692 Gets the minimum of the range specified by <em class="parameter"><code>value</code></em>.
693 </p>
694 <div class="variablelist"><table border="0">
695 <col align="left" valign="top">
696 <tbody>
697 <tr>
698 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
699 <td>a GValue initialized to GST_TYPE_DOUBLE_RANGE</td>
700 </tr>
701 <tr>
702 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
703 <td>the minimum of the range</td>
704 </tr>
705 </tbody>
706 </table></div>
707 </div>
708 <hr>
709 <div class="refsect2">
710 <a name="gst-value-get-double-range-max"></a><h3>gst_value_get_double_range_max ()</h3>
711 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>             gst_value_get_double_range_max      (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
712 <p>
713 Gets the maximum of the range specified by <em class="parameter"><code>value</code></em>.
714 </p>
715 <div class="variablelist"><table border="0">
716 <col align="left" valign="top">
717 <tbody>
718 <tr>
719 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
720 <td>a GValue initialized to GST_TYPE_DOUBLE_RANGE</td>
721 </tr>
722 <tr>
723 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
724 <td>the maxumum of the range</td>
725 </tr>
726 </tbody>
727 </table></div>
728 </div>
729 <hr>
730 <div class="refsect2">
731 <a name="GST-VALUE-HOLDS-LIST:CAPS"></a><h3>GST_VALUE_HOLDS_LIST()</h3>
732 <pre class="programlisting">#define GST_VALUE_HOLDS_LIST(x)             (G_VALUE_HOLDS((x), gst_value_list_get_type ()))
733 </pre>
734 <p>
735 Checks if the given <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> contains a <a class="link" href="gstreamer-GstValue.html#GST-TYPE-LIST:CAPS" title="GST_TYPE_LIST"><span class="type">GST_TYPE_LIST</span></a> value.
736 </p>
737 <div class="variablelist"><table border="0">
738 <col align="left" valign="top">
739 <tbody><tr>
740 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
741 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to check</td>
742 </tr></tbody>
743 </table></div>
744 </div>
745 <hr>
746 <div class="refsect2">
747 <a name="GST-TYPE-LIST:CAPS"></a><h3>GST_TYPE_LIST</h3>
748 <pre class="programlisting">#define GST_TYPE_LIST                    gst_value_list_get_type ()
749 </pre>
750 <p>
751 a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> type that represents an unordered list of <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> values. This
752 is used for example to express a list of possible values for a field in
753 a caps structure, like a list of possible sample rates, of which only one
754 will be chosen in the end. This means that all values in the list are
755 meaningful on their own.
756 </p>
757 <div class="variablelist"><table border="0">
758 <col align="left" valign="top">
759 <tbody><tr>
760 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
761 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of GstValueList (which is not explicitly typed)</td>
762 </tr></tbody>
763 </table></div>
764 </div>
765 <hr>
766 <div class="refsect2">
767 <a name="GST-VALUE-HOLDS-ARRAY:CAPS"></a><h3>GST_VALUE_HOLDS_ARRAY()</h3>
768 <pre class="programlisting">#define GST_VALUE_HOLDS_ARRAY(x) (G_VALUE_HOLDS((x), gst_value_array_get_type ()))
769 </pre>
770 <p>
771 Checks if the given <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> contains a <a class="link" href="gstreamer-GstValue.html#GST-TYPE-ARRAY:CAPS" title="GST_TYPE_ARRAY"><span class="type">GST_TYPE_ARRAY</span></a> value.
772 </p>
773 <div class="variablelist"><table border="0">
774 <col align="left" valign="top">
775 <tbody><tr>
776 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
777 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to check</td>
778 </tr></tbody>
779 </table></div>
780 </div>
781 <hr>
782 <div class="refsect2">
783 <a name="GST-TYPE-ARRAY:CAPS"></a><h3>GST_TYPE_ARRAY</h3>
784 <pre class="programlisting">#define GST_TYPE_ARRAY                       gst_value_array_get_type ()
785 </pre>
786 <p>
787 a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> type that represents an ordered list of <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> values. This is
788 used to express a set of values that is meaningful only in their specific
789 combination and order of values. Each value on its own is not particularly
790 meaningful, only the ordered array in its entirety is meaningful. This is
791 used for example to express channel layouts for multichannel audio where
792 each channel needs to be mapped to a position in the room.
793 </p>
794 <div class="variablelist"><table border="0">
795 <col align="left" valign="top">
796 <tbody><tr>
797 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
798 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of GstArrayList (which is not explicitly typed)</td>
799 </tr></tbody>
800 </table></div>
801 </div>
802 <hr>
803 <div class="refsect2">
804 <a name="gst-value-list-append-value"></a><h3>gst_value_list_append_value ()</h3>
805 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_list_append_value         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
806                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *append_value</code></em>);</pre>
807 <p>
808 Appends <em class="parameter"><code>append_value</code></em> to the GstValueList in <em class="parameter"><code>value</code></em>.
809 </p>
810 <div class="variablelist"><table border="0">
811 <col align="left" valign="top">
812 <tbody>
813 <tr>
814 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
815 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a class="link" href="gstreamer-GstValue.html#GST-TYPE-LIST:CAPS" title="GST_TYPE_LIST"><span class="type">GST_TYPE_LIST</span></a>
816 </td>
817 </tr>
818 <tr>
819 <td><p><span class="term"><em class="parameter"><code>append_value</code></em> :</span></p></td>
820 <td>the value to append</td>
821 </tr>
822 </tbody>
823 </table></div>
824 </div>
825 <hr>
826 <div class="refsect2">
827 <a name="gst-value-list-prepend-value"></a><h3>gst_value_list_prepend_value ()</h3>
828 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_list_prepend_value        (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
829                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *prepend_value</code></em>);</pre>
830 <p>
831 Prepends <em class="parameter"><code>prepend_value</code></em> to the GstValueList in <em class="parameter"><code>value</code></em>.
832 </p>
833 <div class="variablelist"><table border="0">
834 <col align="left" valign="top">
835 <tbody>
836 <tr>
837 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
838 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a class="link" href="gstreamer-GstValue.html#GST-TYPE-LIST:CAPS" title="GST_TYPE_LIST"><span class="type">GST_TYPE_LIST</span></a>
839 </td>
840 </tr>
841 <tr>
842 <td><p><span class="term"><em class="parameter"><code>prepend_value</code></em> :</span></p></td>
843 <td>the value to prepend</td>
844 </tr>
845 </tbody>
846 </table></div>
847 </div>
848 <hr>
849 <div class="refsect2">
850 <a name="gst-value-list-concat"></a><h3>gst_value_list_concat ()</h3>
851 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_list_concat               (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
852                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
853                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);</pre>
854 <p>
855 Concatenates copies of <em class="parameter"><code>value1</code></em> and <em class="parameter"><code>value2</code></em> into a list.  Values that are not
856 of type <a class="link" href="gstreamer-GstValue.html#GST-TYPE-LIST:CAPS" title="GST_TYPE_LIST"><span class="type">GST_TYPE_LIST</span></a> are treated as if they were lists of length 1.
857 <em class="parameter"><code>dest</code></em> will be initialized to the type <a class="link" href="gstreamer-GstValue.html#GST-TYPE-LIST:CAPS" title="GST_TYPE_LIST"><span class="type">GST_TYPE_LIST</span></a>.
858 </p>
859 <div class="variablelist"><table border="0">
860 <col align="left" valign="top">
861 <tbody>
862 <tr>
863 <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
864 <td>an uninitialized <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to take the result. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym> caller-allocates]</span>
865 </td>
866 </tr>
867 <tr>
868 <td><p><span class="term"><em class="parameter"><code>value1</code></em> :</span></p></td>
869 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>
870 </td>
871 </tr>
872 <tr>
873 <td><p><span class="term"><em class="parameter"><code>value2</code></em> :</span></p></td>
874 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>
875 </td>
876 </tr>
877 </tbody>
878 </table></div>
879 </div>
880 <hr>
881 <div class="refsect2">
882 <a name="gst-value-list-merge"></a><h3>gst_value_list_merge ()</h3>
883 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_list_merge                (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
884                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
885                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);</pre>
886 <p>
887 Merges copies of <em class="parameter"><code>value1</code></em> and <em class="parameter"><code>value2</code></em>.  Values that are not
888 of type <a class="link" href="gstreamer-GstValue.html#GST-TYPE-LIST:CAPS" title="GST_TYPE_LIST"><span class="type">GST_TYPE_LIST</span></a> are treated as if they were lists of length 1.
889 </p>
890 <p>
891 The result will be put into <em class="parameter"><code>dest</code></em> and will either be a list that will not
892 contain any duplicates, or a non-list type (if <em class="parameter"><code>value1</code></em> and <em class="parameter"><code>value2</code></em>
893 were equal).
894 </p>
895 <div class="variablelist"><table border="0">
896 <col align="left" valign="top">
897 <tbody>
898 <tr>
899 <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
900 <td>an uninitialized <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to take the result. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym> caller-allocates]</span>
901 </td>
902 </tr>
903 <tr>
904 <td><p><span class="term"><em class="parameter"><code>value1</code></em> :</span></p></td>
905 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>
906 </td>
907 </tr>
908 <tr>
909 <td><p><span class="term"><em class="parameter"><code>value2</code></em> :</span></p></td>
910 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>
911 </td>
912 </tr>
913 </tbody>
914 </table></div>
915 <p class="since">Since 0.10.32</p>
916 </div>
917 <hr>
918 <div class="refsect2">
919 <a name="gst-value-list-get-size"></a><h3>gst_value_list_get_size ()</h3>
920 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gst_value_list_get_size             (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
921 <p>
922 Gets the number of values contained in <em class="parameter"><code>value</code></em>.
923 </p>
924 <div class="variablelist"><table border="0">
925 <col align="left" valign="top">
926 <tbody>
927 <tr>
928 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
929 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a class="link" href="gstreamer-GstValue.html#GST-TYPE-LIST:CAPS" title="GST_TYPE_LIST"><span class="type">GST_TYPE_LIST</span></a>
930 </td>
931 </tr>
932 <tr>
933 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
934 <td>the number of values</td>
935 </tr>
936 </tbody>
937 </table></div>
938 </div>
939 <hr>
940 <div class="refsect2">
941 <a name="gst-value-list-get-value"></a><h3>gst_value_list_get_value ()</h3>
942 <pre class="programlisting">const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *      gst_value_list_get_value            (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
943                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);</pre>
944 <p>
945 Gets the value that is a member of the list contained in <em class="parameter"><code>value</code></em> and
946 has the index <em class="parameter"><code>index</code></em>.
947 </p>
948 <div class="variablelist"><table border="0">
949 <col align="left" valign="top">
950 <tbody>
951 <tr>
952 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
953 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a class="link" href="gstreamer-GstValue.html#GST-TYPE-LIST:CAPS" title="GST_TYPE_LIST"><span class="type">GST_TYPE_LIST</span></a>
954 </td>
955 </tr>
956 <tr>
957 <td><p><span class="term"><em class="parameter"><code>index</code></em> :</span></p></td>
958 <td>index of value to get from the list</td>
959 </tr>
960 <tr>
961 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
962 <td>the value at the given index. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
963 </td>
964 </tr>
965 </tbody>
966 </table></div>
967 </div>
968 <hr>
969 <div class="refsect2">
970 <a name="GST-VALUE-HOLDS-FRACTION:CAPS"></a><h3>GST_VALUE_HOLDS_FRACTION()</h3>
971 <pre class="programlisting">#define GST_VALUE_HOLDS_FRACTION(x) (G_VALUE_HOLDS((x), gst_fraction_get_type ()))
972 </pre>
973 <p>
974 Checks if the given <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> contains a <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FRACTION:CAPS" title="GST_TYPE_FRACTION"><span class="type">GST_TYPE_FRACTION</span></a> value.
975 </p>
976 <div class="variablelist"><table border="0">
977 <col align="left" valign="top">
978 <tbody><tr>
979 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
980 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to check</td>
981 </tr></tbody>
982 </table></div>
983 </div>
984 <hr>
985 <div class="refsect2">
986 <a name="GST-TYPE-FRACTION:CAPS"></a><h3>GST_TYPE_FRACTION</h3>
987 <pre class="programlisting">#define GST_TYPE_FRACTION                gst_fraction_get_type ()
988 </pre>
989 <p>
990 a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> type that represents a fraction of an integer numerator over
991 an integer denominator
992 </p>
993 <div class="variablelist"><table border="0">
994 <col align="left" valign="top">
995 <tbody><tr>
996 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
997 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of GstFraction (which is not explicitly typed)</td>
998 </tr></tbody>
999 </table></div>
1000 </div>
1001 <hr>
1002 <div class="refsect2">
1003 <a name="gst-value-set-fraction"></a><h3>gst_value_set_fraction ()</h3>
1004 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_set_fraction              (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
1005                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> numerator</code></em>,
1006                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> denominator</code></em>);</pre>
1007 <p>
1008 Sets <em class="parameter"><code>value</code></em> to the fraction specified by <em class="parameter"><code>numerator</code></em> over <em class="parameter"><code>denominator</code></em>.
1009 The fraction gets reduced to the smallest numerator and denominator,
1010 and if necessary the sign is moved to the numerator.
1011 </p>
1012 <div class="variablelist"><table border="0">
1013 <col align="left" valign="top">
1014 <tbody>
1015 <tr>
1016 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1017 <td>a GValue initialized to <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FRACTION:CAPS" title="GST_TYPE_FRACTION"><span class="type">GST_TYPE_FRACTION</span></a>
1018 </td>
1019 </tr>
1020 <tr>
1021 <td><p><span class="term"><em class="parameter"><code>numerator</code></em> :</span></p></td>
1022 <td>the numerator of the fraction</td>
1023 </tr>
1024 <tr>
1025 <td><p><span class="term"><em class="parameter"><code>denominator</code></em> :</span></p></td>
1026 <td>the denominator of the fraction</td>
1027 </tr>
1028 </tbody>
1029 </table></div>
1030 </div>
1031 <hr>
1032 <div class="refsect2">
1033 <a name="gst-value-get-fraction-numerator"></a><h3>gst_value_get_fraction_numerator ()</h3>
1034 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gst_value_get_fraction_numerator    (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
1035 <p>
1036 Gets the numerator of the fraction specified by <em class="parameter"><code>value</code></em>.
1037 </p>
1038 <div class="variablelist"><table border="0">
1039 <col align="left" valign="top">
1040 <tbody>
1041 <tr>
1042 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1043 <td>a GValue initialized to <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FRACTION:CAPS" title="GST_TYPE_FRACTION"><span class="type">GST_TYPE_FRACTION</span></a>
1044 </td>
1045 </tr>
1046 <tr>
1047 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1048 <td>the numerator of the fraction.</td>
1049 </tr>
1050 </tbody>
1051 </table></div>
1052 </div>
1053 <hr>
1054 <div class="refsect2">
1055 <a name="gst-value-get-fraction-denominator"></a><h3>gst_value_get_fraction_denominator ()</h3>
1056 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gst_value_get_fraction_denominator  (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
1057 <p>
1058 Gets the denominator of the fraction specified by <em class="parameter"><code>value</code></em>.
1059 </p>
1060 <div class="variablelist"><table border="0">
1061 <col align="left" valign="top">
1062 <tbody>
1063 <tr>
1064 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1065 <td>a GValue initialized to <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FRACTION:CAPS" title="GST_TYPE_FRACTION"><span class="type">GST_TYPE_FRACTION</span></a>
1066 </td>
1067 </tr>
1068 <tr>
1069 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1070 <td>the denominator of the fraction.</td>
1071 </tr>
1072 </tbody>
1073 </table></div>
1074 </div>
1075 <hr>
1076 <div class="refsect2">
1077 <a name="gst-value-fraction-multiply"></a><h3>gst_value_fraction_multiply ()</h3>
1078 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_value_fraction_multiply         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *product</code></em>,
1079                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *factor1</code></em>,
1080                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *factor2</code></em>);</pre>
1081 <p>
1082 Multiplies the two <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> items containing a <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FRACTION:CAPS" title="GST_TYPE_FRACTION"><span class="type">GST_TYPE_FRACTION</span></a> and sets
1083 <em class="parameter"><code>product</code></em> to the product of the two fractions.
1084 </p>
1085 <div class="variablelist"><table border="0">
1086 <col align="left" valign="top">
1087 <tbody>
1088 <tr>
1089 <td><p><span class="term"><em class="parameter"><code>product</code></em> :</span></p></td>
1090 <td>a GValue initialized to <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FRACTION:CAPS" title="GST_TYPE_FRACTION"><span class="type">GST_TYPE_FRACTION</span></a>
1091 </td>
1092 </tr>
1093 <tr>
1094 <td><p><span class="term"><em class="parameter"><code>factor1</code></em> :</span></p></td>
1095 <td>a GValue initialized to <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FRACTION:CAPS" title="GST_TYPE_FRACTION"><span class="type">GST_TYPE_FRACTION</span></a>
1096 </td>
1097 </tr>
1098 <tr>
1099 <td><p><span class="term"><em class="parameter"><code>factor2</code></em> :</span></p></td>
1100 <td>a GValue initialized to <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FRACTION:CAPS" title="GST_TYPE_FRACTION"><span class="type">GST_TYPE_FRACTION</span></a>
1101 </td>
1102 </tr>
1103 <tr>
1104 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1105 <td>FALSE in case of an error (like integer overflow), TRUE otherwise.</td>
1106 </tr>
1107 </tbody>
1108 </table></div>
1109 </div>
1110 <hr>
1111 <div class="refsect2">
1112 <a name="gst-value-fraction-subtract"></a><h3>gst_value_fraction_subtract ()</h3>
1113 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_value_fraction_subtract         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
1114                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *minuend</code></em>,
1115                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *subtrahend</code></em>);</pre>
1116 <p>
1117 Subtracts the <em class="parameter"><code>subtrahend</code></em> from the <em class="parameter"><code>minuend</code></em> and sets <em class="parameter"><code>dest</code></em> to the result.
1118 </p>
1119 <div class="variablelist"><table border="0">
1120 <col align="left" valign="top">
1121 <tbody>
1122 <tr>
1123 <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
1124 <td>a GValue initialized to <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FRACTION:CAPS" title="GST_TYPE_FRACTION"><span class="type">GST_TYPE_FRACTION</span></a>
1125 </td>
1126 </tr>
1127 <tr>
1128 <td><p><span class="term"><em class="parameter"><code>minuend</code></em> :</span></p></td>
1129 <td>a GValue initialized to <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FRACTION:CAPS" title="GST_TYPE_FRACTION"><span class="type">GST_TYPE_FRACTION</span></a>
1130 </td>
1131 </tr>
1132 <tr>
1133 <td><p><span class="term"><em class="parameter"><code>subtrahend</code></em> :</span></p></td>
1134 <td>a GValue initialized to <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FRACTION:CAPS" title="GST_TYPE_FRACTION"><span class="type">GST_TYPE_FRACTION</span></a>
1135 </td>
1136 </tr>
1137 <tr>
1138 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1139 <td>FALSE in case of an error (like integer overflow), TRUE otherwise.</td>
1140 </tr>
1141 </tbody>
1142 </table></div>
1143 </div>
1144 <hr>
1145 <div class="refsect2">
1146 <a name="GST-VALUE-HOLDS-FRACTION-RANGE:CAPS"></a><h3>GST_VALUE_HOLDS_FRACTION_RANGE()</h3>
1147 <pre class="programlisting">#define GST_VALUE_HOLDS_FRACTION_RANGE(x)    (G_VALUE_HOLDS((x), gst_fraction_range_get_type ()))
1148 </pre>
1149 <p>
1150 Checks if the given <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> contains a <a class="link" href="gstreamer-GstValue.html#GST-TYPE-FRACTION-RANGE:CAPS" title="GST_TYPE_FRACTION_RANGE"><span class="type">GST_TYPE_FRACTION_RANGE</span></a> value.
1151 </p>
1152 <div class="variablelist"><table border="0">
1153 <col align="left" valign="top">
1154 <tbody><tr>
1155 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
1156 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to check</td>
1157 </tr></tbody>
1158 </table></div>
1159 </div>
1160 <hr>
1161 <div class="refsect2">
1162 <a name="GST-TYPE-FRACTION-RANGE:CAPS"></a><h3>GST_TYPE_FRACTION_RANGE</h3>
1163 <pre class="programlisting">#define GST_TYPE_FRACTION_RANGE            gst_fraction_range_get_type ()
1164 </pre>
1165 <p>
1166 a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> type that represents a GstFraction range
1167 </p>
1168 <div class="variablelist"><table border="0">
1169 <col align="left" valign="top">
1170 <tbody><tr>
1171 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1172 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of GstFractionRange</td>
1173 </tr></tbody>
1174 </table></div>
1175 </div>
1176 <hr>
1177 <div class="refsect2">
1178 <a name="gst-value-set-fraction-range"></a><h3>gst_value_set_fraction_range ()</h3>
1179 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_set_fraction_range        (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
1180                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *start</code></em>,
1181                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *end</code></em>);</pre>
1182 <p>
1183 Sets <em class="parameter"><code>value</code></em> to the range specified by <em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em>.
1184 </p>
1185 <div class="variablelist"><table border="0">
1186 <col align="left" valign="top">
1187 <tbody>
1188 <tr>
1189 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1190 <td>a GValue initialized to GST_TYPE_FRACTION_RANGE</td>
1191 </tr>
1192 <tr>
1193 <td><p><span class="term"><em class="parameter"><code>start</code></em> :</span></p></td>
1194 <td>the start of the range (a GST_TYPE_FRACTION GValue)</td>
1195 </tr>
1196 <tr>
1197 <td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td>
1198 <td>the end of the range (a GST_TYPE_FRACTION GValue)</td>
1199 </tr>
1200 </tbody>
1201 </table></div>
1202 </div>
1203 <hr>
1204 <div class="refsect2">
1205 <a name="gst-value-get-fraction-range-min"></a><h3>gst_value_get_fraction_range_min ()</h3>
1206 <pre class="programlisting">const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *      gst_value_get_fraction_range_min    (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
1207 <p>
1208 Gets the minimum of the range specified by <em class="parameter"><code>value</code></em>.
1209 </p>
1210 <div class="variablelist"><table border="0">
1211 <col align="left" valign="top">
1212 <tbody>
1213 <tr>
1214 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1215 <td>a GValue initialized to GST_TYPE_FRACTION_RANGE</td>
1216 </tr>
1217 <tr>
1218 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1219 <td>the minimum of the range</td>
1220 </tr>
1221 </tbody>
1222 </table></div>
1223 </div>
1224 <hr>
1225 <div class="refsect2">
1226 <a name="gst-value-get-fraction-range-max"></a><h3>gst_value_get_fraction_range_max ()</h3>
1227 <pre class="programlisting">const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *      gst_value_get_fraction_range_max    (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
1228 <p>
1229 Gets the maximum of the range specified by <em class="parameter"><code>value</code></em>.
1230 </p>
1231 <div class="variablelist"><table border="0">
1232 <col align="left" valign="top">
1233 <tbody>
1234 <tr>
1235 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1236 <td>a GValue initialized to GST_TYPE_FRACTION_RANGE</td>
1237 </tr>
1238 <tr>
1239 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1240 <td>the maximum of the range</td>
1241 </tr>
1242 </tbody>
1243 </table></div>
1244 </div>
1245 <hr>
1246 <div class="refsect2">
1247 <a name="gst-value-set-fraction-range-full"></a><h3>gst_value_set_fraction_range_full ()</h3>
1248 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_set_fraction_range_full   (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
1249                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> numerator_start</code></em>,
1250                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> denominator_start</code></em>,
1251                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> numerator_end</code></em>,
1252                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> denominator_end</code></em>);</pre>
1253 <p>
1254 Sets <em class="parameter"><code>value</code></em> to the range specified by <em class="parameter"><code>numerator_start</code></em>/<em class="parameter"><code>denominator_start</code></em>
1255 and <em class="parameter"><code>numerator_end</code></em>/<em class="parameter"><code>denominator_end</code></em>.
1256 </p>
1257 <div class="variablelist"><table border="0">
1258 <col align="left" valign="top">
1259 <tbody>
1260 <tr>
1261 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1262 <td>a GValue initialized to GST_TYPE_FRACTION_RANGE</td>
1263 </tr>
1264 <tr>
1265 <td><p><span class="term"><em class="parameter"><code>numerator_start</code></em> :</span></p></td>
1266 <td>the numerator start of the range</td>
1267 </tr>
1268 <tr>
1269 <td><p><span class="term"><em class="parameter"><code>denominator_start</code></em> :</span></p></td>
1270 <td>the denominator start of the range</td>
1271 </tr>
1272 <tr>
1273 <td><p><span class="term"><em class="parameter"><code>numerator_end</code></em> :</span></p></td>
1274 <td>the numerator end of the range</td>
1275 </tr>
1276 <tr>
1277 <td><p><span class="term"><em class="parameter"><code>denominator_end</code></em> :</span></p></td>
1278 <td>the denominator end of the range</td>
1279 </tr>
1280 </tbody>
1281 </table></div>
1282 </div>
1283 <hr>
1284 <div class="refsect2">
1285 <a name="GST-VALUE-HOLDS-DATE:CAPS"></a><h3>GST_VALUE_HOLDS_DATE()</h3>
1286 <pre class="programlisting">#define GST_VALUE_HOLDS_DATE(x)         (G_VALUE_HOLDS((x), gst_date_get_type ()))
1287 </pre>
1288 <p>
1289 Checks if the given <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> contains a <a class="link" href="gstreamer-GstValue.html#GST-TYPE-DATE:CAPS" title="GST_TYPE_DATE"><span class="type">GST_TYPE_DATE</span></a> value.
1290 </p>
1291 <div class="variablelist"><table border="0">
1292 <col align="left" valign="top">
1293 <tbody><tr>
1294 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
1295 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to check</td>
1296 </tr></tbody>
1297 </table></div>
1298 </div>
1299 <hr>
1300 <div class="refsect2">
1301 <a name="GST-TYPE-DATE:CAPS"></a><h3>GST_TYPE_DATE</h3>
1302 <pre class="programlisting">#define GST_TYPE_DATE                    gst_date_get_type ()
1303 </pre>
1304 <p>
1305 a boxed <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> type for <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> that represents a date.
1306 </p>
1307 <div class="variablelist"><table border="0">
1308 <col align="left" valign="top">
1309 <tbody><tr>
1310 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1311 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of GstDate</td>
1312 </tr></tbody>
1313 </table></div>
1314 </div>
1315 <hr>
1316 <div class="refsect2">
1317 <a name="gst-value-set-date"></a><h3>gst_value_set_date ()</h3>
1318 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_set_date                  (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
1319                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *date</code></em>);</pre>
1320 <p>
1321 Sets the contents of <em class="parameter"><code>value</code></em> to correspond to <em class="parameter"><code>date</code></em>.  The actual
1322 <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> structure is copied before it is used.
1323 </p>
1324 <div class="variablelist"><table border="0">
1325 <col align="left" valign="top">
1326 <tbody>
1327 <tr>
1328 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1329 <td>a GValue initialized to GST_TYPE_DATE</td>
1330 </tr>
1331 <tr>
1332 <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1333 <td>the date to set the value to</td>
1334 </tr>
1335 </tbody>
1336 </table></div>
1337 </div>
1338 <hr>
1339 <div class="refsect2">
1340 <a name="gst-value-get-date"></a><h3>gst_value_get_date ()</h3>
1341 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="returnvalue">GDate</span></a> *       gst_value_get_date                  (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
1342 <p>
1343 Gets the contents of <em class="parameter"><code>value</code></em>.
1344 </p>
1345 <div class="variablelist"><table border="0">
1346 <col align="left" valign="top">
1347 <tbody>
1348 <tr>
1349 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1350 <td>a GValue initialized to GST_TYPE_DATE</td>
1351 </tr>
1352 <tr>
1353 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1354 <td>the contents of <em class="parameter"><code>value</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1355 </td>
1356 </tr>
1357 </tbody>
1358 </table></div>
1359 </div>
1360 <hr>
1361 <div class="refsect2">
1362 <a name="GST-VALUE-HOLDS-DATE-TIME:CAPS"></a><h3>GST_VALUE_HOLDS_DATE_TIME()</h3>
1363 <pre class="programlisting">#define GST_VALUE_HOLDS_DATE_TIME(x)    (G_VALUE_HOLDS((x), gst_date_time_get_type ()))
1364 </pre>
1365 <p>
1366 Checks if the given <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> contains a <a class="link" href="gstreamer-GstDateTime.html#GST-TYPE-DATE-TIME:CAPS" title="GST_TYPE_DATE_TIME"><span class="type">GST_TYPE_DATE_TIME</span></a> value.
1367 </p>
1368 <div class="variablelist"><table border="0">
1369 <col align="left" valign="top">
1370 <tbody><tr>
1371 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
1372 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to check</td>
1373 </tr></tbody>
1374 </table></div>
1375 <p class="since">Since 0.10.31</p>
1376 </div>
1377 <hr>
1378 <div class="refsect2">
1379 <a name="GST-VALUE-HOLDS-CAPS"></a><h3>GST_VALUE_HOLDS_CAPS()</h3>
1380 <pre class="programlisting">#define GST_VALUE_HOLDS_CAPS(x)             (G_VALUE_HOLDS((x), GST_TYPE_CAPS))
1381 </pre>
1382 <p>
1383 Checks if the given <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> contains a <span class="type">GST_TYPE_CAPS</span> value.
1384 </p>
1385 <div class="variablelist"><table border="0">
1386 <col align="left" valign="top">
1387 <tbody><tr>
1388 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
1389 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to check</td>
1390 </tr></tbody>
1391 </table></div>
1392 </div>
1393 <hr>
1394 <div class="refsect2">
1395 <a name="gst-value-set-caps"></a><h3>gst_value_set_caps ()</h3>
1396 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_set_caps                  (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
1397                                                          <em class="parameter"><code>const <a class="link" href="gstreamer-GstCaps.html#GstCaps" title="struct GstCaps"><span class="type">GstCaps</span></a> *caps</code></em>);</pre>
1398 <p>
1399 Sets the contents of <em class="parameter"><code>value</code></em> to <em class="parameter"><code>caps</code></em>. A reference to the
1400 provided <em class="parameter"><code>caps</code></em> will be taken by the <em class="parameter"><code>value</code></em>.
1401 </p>
1402 <div class="variablelist"><table border="0">
1403 <col align="left" valign="top">
1404 <tbody>
1405 <tr>
1406 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1407 <td>a GValue initialized to GST_TYPE_CAPS</td>
1408 </tr>
1409 <tr>
1410 <td><p><span class="term"><em class="parameter"><code>caps</code></em> :</span></p></td>
1411 <td>the caps to set the value to. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1412 </td>
1413 </tr>
1414 </tbody>
1415 </table></div>
1416 </div>
1417 <hr>
1418 <div class="refsect2">
1419 <a name="gst-value-get-caps"></a><h3>gst_value_get_caps ()</h3>
1420 <pre class="programlisting">const <a class="link" href="gstreamer-GstCaps.html#GstCaps" title="struct GstCaps"><span class="returnvalue">GstCaps</span></a> *     gst_value_get_caps                  (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
1421 <p>
1422 Gets the contents of <em class="parameter"><code>value</code></em>. The reference count of the returned
1423 <a class="link" href="gstreamer-GstCaps.html#GstCaps" title="struct GstCaps"><span class="type">GstCaps</span></a> will not be modified, therefore the caller must take one
1424 before getting rid of the <em class="parameter"><code>value</code></em>.
1425 </p>
1426 <div class="variablelist"><table border="0">
1427 <col align="left" valign="top">
1428 <tbody>
1429 <tr>
1430 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1431 <td>a GValue initialized to GST_TYPE_CAPS</td>
1432 </tr>
1433 <tr>
1434 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1435 <td>the contents of <em class="parameter"><code>value</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1436 </td>
1437 </tr>
1438 </tbody>
1439 </table></div>
1440 </div>
1441 <hr>
1442 <div class="refsect2">
1443 <a name="GST-VALUE-HOLDS-STRUCTURE:CAPS"></a><h3>GST_VALUE_HOLDS_STRUCTURE()</h3>
1444 <pre class="programlisting">#define GST_VALUE_HOLDS_STRUCTURE(x)                (G_VALUE_HOLDS((x), GST_TYPE_STRUCTURE))
1445 </pre>
1446 <p>
1447 Checks if the given <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> contains a <span class="type">GST_TYPE_STRUCTURE</span> value.
1448 </p>
1449 <div class="variablelist"><table border="0">
1450 <col align="left" valign="top">
1451 <tbody><tr>
1452 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
1453 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to check</td>
1454 </tr></tbody>
1455 </table></div>
1456 <p class="since">Since 0.10.15</p>
1457 </div>
1458 <hr>
1459 <div class="refsect2">
1460 <a name="gst-value-set-structure"></a><h3>gst_value_set_structure ()</h3>
1461 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_set_structure             (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
1462                                                          <em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>);</pre>
1463 <p>
1464 Sets the contents of <em class="parameter"><code>value</code></em> to <em class="parameter"><code>structure</code></em>.  The actual
1465 </p>
1466 <div class="variablelist"><table border="0">
1467 <col align="left" valign="top">
1468 <tbody>
1469 <tr>
1470 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1471 <td>a GValue initialized to GST_TYPE_STRUCTURE</td>
1472 </tr>
1473 <tr>
1474 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1475 <td>the structure to set the value to</td>
1476 </tr>
1477 </tbody>
1478 </table></div>
1479 <p class="since">Since 0.10.15</p>
1480 </div>
1481 <hr>
1482 <div class="refsect2">
1483 <a name="gst-value-get-structure"></a><h3>gst_value_get_structure ()</h3>
1484 <pre class="programlisting">const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> * gst_value_get_structure            (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
1485 <p>
1486 Gets the contents of <em class="parameter"><code>value</code></em>.
1487 </p>
1488 <div class="variablelist"><table border="0">
1489 <col align="left" valign="top">
1490 <tbody>
1491 <tr>
1492 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1493 <td>a GValue initialized to GST_TYPE_STRUCTURE</td>
1494 </tr>
1495 <tr>
1496 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1497 <td>the contents of <em class="parameter"><code>value</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1498 </td>
1499 </tr>
1500 </tbody>
1501 </table></div>
1502 <p class="since">Since 0.10.15</p>
1503 </div>
1504 <hr>
1505 <div class="refsect2">
1506 <a name="GST-VALUE-HOLDS-MINI-OBJECT:CAPS"></a><h3>GST_VALUE_HOLDS_MINI_OBJECT()</h3>
1507 <pre class="programlisting">#define GST_VALUE_HOLDS_MINI_OBJECT(value)  (G_VALUE_HOLDS(value, GST_TYPE_MINI_OBJECT))
1508 </pre>
1509 <p>
1510 Checks if the given <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> contains a <span class="type">GST_TYPE_MINI_OBJECT</span> value.
1511 </p>
1512 <div class="variablelist"><table border="0">
1513 <col align="left" valign="top">
1514 <tbody><tr>
1515 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1516 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to check</td>
1517 </tr></tbody>
1518 </table></div>
1519 </div>
1520 <hr>
1521 <div class="refsect2">
1522 <a name="GST-VALUE-HOLDS-BUFFER:CAPS"></a><h3>GST_VALUE_HOLDS_BUFFER()</h3>
1523 <pre class="programlisting">#define GST_VALUE_HOLDS_BUFFER(x)       (G_VALUE_HOLDS((x), GST_TYPE_BUFFER))
1524 </pre>
1525 <p>
1526 Checks if the given <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> contains a <span class="type">GST_TYPE_BUFFER</span> value.
1527 </p>
1528 <div class="variablelist"><table border="0">
1529 <col align="left" valign="top">
1530 <tbody><tr>
1531 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
1532 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to check</td>
1533 </tr></tbody>
1534 </table></div>
1535 </div>
1536 <hr>
1537 <div class="refsect2">
1538 <a name="gst-value-get-buffer"></a><h3>gst_value_get_buffer()</h3>
1539 <pre class="programlisting">#define         gst_value_get_buffer(v)         GST_BUFFER_CAST (gst_value_get_mini_object(v))
1540 </pre>
1541 <p>
1542 Receives a <a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="type">GstBuffer</span></a> as the value of <em class="parameter"><code>v</code></em>. Does not return a reference to
1543 the buffer, so the pointer is only valid for as long as the caller owns
1544 a reference to <em class="parameter"><code>v</code></em>.
1545 </p>
1546 <div class="variablelist"><table border="0">
1547 <col align="left" valign="top">
1548 <tbody>
1549 <tr>
1550 <td><p><span class="term"><em class="parameter"><code>v</code></em> :</span></p></td>
1551 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to query</td>
1552 </tr>
1553 <tr>
1554 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1555 <td>buffer. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1556 </td>
1557 </tr>
1558 </tbody>
1559 </table></div>
1560 </div>
1561 <hr>
1562 <div class="refsect2">
1563 <a name="gst-value-set-buffer"></a><h3>gst_value_set_buffer()</h3>
1564 <pre class="programlisting">#define         gst_value_set_buffer(v,b)       gst_value_set_mini_object(v, GST_MINI_OBJECT_CAST(b))
1565 </pre>
1566 <p>
1567 Sets <em class="parameter"><code>b</code></em> as the value of <em class="parameter"><code>v</code></em>.  Caller retains reference to buffer.
1568 </p>
1569 <div class="variablelist"><table border="0">
1570 <col align="left" valign="top">
1571 <tbody>
1572 <tr>
1573 <td><p><span class="term"><em class="parameter"><code>v</code></em> :</span></p></td>
1574 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to receive the data</td>
1575 </tr>
1576 <tr>
1577 <td><p><span class="term"><em class="parameter"><code>b</code></em> :</span></p></td>
1578 <td>a <a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="type">GstBuffer</span></a> to assign to the GstValue. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1579 </td>
1580 </tr>
1581 </tbody>
1582 </table></div>
1583 </div>
1584 <hr>
1585 <div class="refsect2">
1586 <a name="gst-value-take-buffer"></a><h3>gst_value_take_buffer()</h3>
1587 <pre class="programlisting">#define         gst_value_take_buffer(v,b)      gst_value_take_mini_object(v, GST_MINI_OBJECT_CAST(b))
1588 </pre>
1589 <p>
1590 Sets <em class="parameter"><code>b</code></em> as the value of <em class="parameter"><code>v</code></em>.  Caller gives away reference to buffer.
1591 </p>
1592 <div class="variablelist"><table border="0">
1593 <col align="left" valign="top">
1594 <tbody>
1595 <tr>
1596 <td><p><span class="term"><em class="parameter"><code>v</code></em> :</span></p></td>
1597 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to receive the data</td>
1598 </tr>
1599 <tr>
1600 <td><p><span class="term"><em class="parameter"><code>b</code></em> :</span></p></td>
1601 <td>a <a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="type">GstBuffer</span></a> to assign to the GstValue. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1602 </td>
1603 </tr>
1604 </tbody>
1605 </table></div>
1606 </div>
1607 <hr>
1608 <div class="refsect2">
1609 <a name="GST-VALUE-LESS-THAN:CAPS"></a><h3>GST_VALUE_LESS_THAN</h3>
1610 <pre class="programlisting">#define GST_VALUE_LESS_THAN              (-1)
1611 </pre>
1612 <p>
1613 Indicates that the first value provided to a comparison function
1614 (<a class="link" href="gstreamer-GstValue.html#gst-value-compare" title="gst_value_compare ()"><code class="function">gst_value_compare()</code></a>) is lesser than the second one.
1615 </p>
1616 </div>
1617 <hr>
1618 <div class="refsect2">
1619 <a name="GST-VALUE-EQUAL:CAPS"></a><h3>GST_VALUE_EQUAL</h3>
1620 <pre class="programlisting">#define GST_VALUE_EQUAL                   0
1621 </pre>
1622 <p>
1623 Indicates that the first value provided to a comparison function
1624 (<a class="link" href="gstreamer-GstValue.html#gst-value-compare" title="gst_value_compare ()"><code class="function">gst_value_compare()</code></a>) is equal to the second one.
1625 </p>
1626 </div>
1627 <hr>
1628 <div class="refsect2">
1629 <a name="GST-VALUE-GREATER-THAN:CAPS"></a><h3>GST_VALUE_GREATER_THAN</h3>
1630 <pre class="programlisting">#define GST_VALUE_GREATER_THAN            1
1631 </pre>
1632 <p>
1633 Indicates that the first value provided to a comparison function
1634 (<a class="link" href="gstreamer-GstValue.html#gst-value-compare" title="gst_value_compare ()"><code class="function">gst_value_compare()</code></a>) is greater than the second one.
1635 </p>
1636 </div>
1637 <hr>
1638 <div class="refsect2">
1639 <a name="GST-VALUE-UNORDERED:CAPS"></a><h3>GST_VALUE_UNORDERED</h3>
1640 <pre class="programlisting">#define GST_VALUE_UNORDERED               2
1641 </pre>
1642 <p>
1643 Indicates that the comparison function (<a class="link" href="gstreamer-GstValue.html#gst-value-compare" title="gst_value_compare ()"><code class="function">gst_value_compare()</code></a>) can not
1644 determine a order for the two provided values.
1645 </p>
1646 </div>
1647 <hr>
1648 <div class="refsect2">
1649 <a name="GstValueCompareFunc"></a><h3>GstValueCompareFunc ()</h3>
1650 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                (*GstValueCompareFunc)              (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
1651                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);</pre>
1652 <p>
1653 Used together with <a class="link" href="gstreamer-GstValue.html#gst-value-compare" title="gst_value_compare ()"><code class="function">gst_value_compare()</code></a> to compare <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> items.
1654 </p>
1655 <div class="variablelist"><table border="0">
1656 <col align="left" valign="top">
1657 <tbody>
1658 <tr>
1659 <td><p><span class="term"><em class="parameter"><code>value1</code></em> :</span></p></td>
1660 <td>first value for comparison</td>
1661 </tr>
1662 <tr>
1663 <td><p><span class="term"><em class="parameter"><code>value2</code></em> :</span></p></td>
1664 <td>second value for comparison</td>
1665 </tr>
1666 <tr>
1667 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1668 <td>one of GST_VALUE_LESS_THAN, GST_VALUE_EQUAL, GST_VALUE_GREATER_THAN
1669 or GST_VALUE_UNORDERED</td>
1670 </tr>
1671 </tbody>
1672 </table></div>
1673 </div>
1674 <hr>
1675 <div class="refsect2">
1676 <a name="GstValueSerializeFunc"></a><h3>GstValueSerializeFunc ()</h3>
1677 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             (*GstValueSerializeFunc)            (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>);</pre>
1678 <p>
1679 Used by <a class="link" href="gstreamer-GstValue.html#gst-value-serialize" title="gst_value_serialize ()"><code class="function">gst_value_serialize()</code></a> to obtain a non-binary form of the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
1680 </p>
1681 <p>
1682 Free-function: g_free
1683 </p>
1684 <div class="variablelist"><table border="0">
1685 <col align="left" valign="top">
1686 <tbody>
1687 <tr>
1688 <td><p><span class="term"><em class="parameter"><code>value1</code></em> :</span></p></td>
1689 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>
1690 </td>
1691 </tr>
1692 <tr>
1693 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1694 <td>the string representation of the value. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1695 </td>
1696 </tr>
1697 </tbody>
1698 </table></div>
1699 </div>
1700 <hr>
1701 <div class="refsect2">
1702 <a name="GstValueDeserializeFunc"></a><h3>GstValueDeserializeFunc ()</h3>
1703 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (*GstValueDeserializeFunc)          (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
1704                                                          <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> *s</code></em>);</pre>
1705 <p>
1706 Used by <a class="link" href="gstreamer-GstValue.html#gst-value-deserialize" title="gst_value_deserialize ()"><code class="function">gst_value_deserialize()</code></a> to parse a non-binary form into the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>.
1707 </p>
1708 <div class="variablelist"><table border="0">
1709 <col align="left" valign="top">
1710 <tbody>
1711 <tr>
1712 <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
1713 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>
1714 </td>
1715 </tr>
1716 <tr>
1717 <td><p><span class="term"><em class="parameter"><code>s</code></em> :</span></p></td>
1718 <td>a string</td>
1719 </tr>
1720 <tr>
1721 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1722 <td>
1723 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> for success</td>
1724 </tr>
1725 </tbody>
1726 </table></div>
1727 </div>
1728 <hr>
1729 <div class="refsect2">
1730 <a name="GstValueUnionFunc"></a><h3>GstValueUnionFunc ()</h3>
1731 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (*GstValueUnionFunc)                (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
1732                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
1733                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);</pre>
1734 <p>
1735 Used by <a class="link" href="gstreamer-GstValue.html#gst-value-union" title="gst_value_union ()"><code class="function">gst_value_union()</code></a> to perform unification for a specific <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>
1736 type. Register a new implementation with <a class="link" href="gstreamer-GstValue.html#gst-value-register-union-func" title="gst_value_register_union_func ()"><code class="function">gst_value_register_union_func()</code></a>.
1737 </p>
1738 <div class="variablelist"><table border="0">
1739 <col align="left" valign="top">
1740 <tbody>
1741 <tr>
1742 <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
1743 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> for the result</td>
1744 </tr>
1745 <tr>
1746 <td><p><span class="term"><em class="parameter"><code>value1</code></em> :</span></p></td>
1747 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> operand</td>
1748 </tr>
1749 <tr>
1750 <td><p><span class="term"><em class="parameter"><code>value2</code></em> :</span></p></td>
1751 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> operand</td>
1752 </tr>
1753 <tr>
1754 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1755 <td>
1756 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a union was successful</td>
1757 </tr>
1758 </tbody>
1759 </table></div>
1760 </div>
1761 <hr>
1762 <div class="refsect2">
1763 <a name="GstValueIntersectFunc"></a><h3>GstValueIntersectFunc ()</h3>
1764 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (*GstValueIntersectFunc)            (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
1765                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
1766                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);</pre>
1767 <p>
1768 Used by <a class="link" href="gstreamer-GstValue.html#gst-value-intersect" title="gst_value_intersect ()"><code class="function">gst_value_intersect()</code></a> to perform intersection for a specific <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>
1769 type. If the intersection is non-empty, the result is
1770 placed in <em class="parameter"><code>dest</code></em> and TRUE is returned.  If the intersection is
1771 empty, <em class="parameter"><code>dest</code></em> is unmodified and FALSE is returned.
1772 Register a new implementation with <a class="link" href="gstreamer-GstValue.html#gst-value-register-intersect-func" title="gst_value_register_intersect_func ()"><code class="function">gst_value_register_intersect_func()</code></a>.
1773 </p>
1774 <div class="variablelist"><table border="0">
1775 <col align="left" valign="top">
1776 <tbody>
1777 <tr>
1778 <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
1779 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> for the result. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym> caller-allocates]</span>
1780 </td>
1781 </tr>
1782 <tr>
1783 <td><p><span class="term"><em class="parameter"><code>value1</code></em> :</span></p></td>
1784 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> operand</td>
1785 </tr>
1786 <tr>
1787 <td><p><span class="term"><em class="parameter"><code>value2</code></em> :</span></p></td>
1788 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> operand</td>
1789 </tr>
1790 <tr>
1791 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1792 <td>
1793 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the values can intersect</td>
1794 </tr>
1795 </tbody>
1796 </table></div>
1797 </div>
1798 <hr>
1799 <div class="refsect2">
1800 <a name="GstValueSubtractFunc"></a><h3>GstValueSubtractFunc ()</h3>
1801 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (*GstValueSubtractFunc)             (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
1802                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *minuend</code></em>,
1803                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *subtrahend</code></em>);</pre>
1804 <p>
1805 Used by <a class="link" href="gstreamer-GstValue.html#gst-value-subtract" title="gst_value_subtract ()"><code class="function">gst_value_subtract()</code></a> to perform subtraction for a specific <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>
1806 type. Register a new implementation with <a class="link" href="gstreamer-GstValue.html#gst-value-register-subtract-func" title="gst_value_register_subtract_func ()"><code class="function">gst_value_register_subtract_func()</code></a>.
1807 </p>
1808 <div class="variablelist"><table border="0">
1809 <col align="left" valign="top">
1810 <tbody>
1811 <tr>
1812 <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
1813 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> for the result. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym> caller-allocates]</span>
1814 </td>
1815 </tr>
1816 <tr>
1817 <td><p><span class="term"><em class="parameter"><code>minuend</code></em> :</span></p></td>
1818 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> operand</td>
1819 </tr>
1820 <tr>
1821 <td><p><span class="term"><em class="parameter"><code>subtrahend</code></em> :</span></p></td>
1822 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> operand</td>
1823 </tr>
1824 <tr>
1825 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1826 <td>
1827 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the subtraction is not empty</td>
1828 </tr>
1829 </tbody>
1830 </table></div>
1831 </div>
1832 <hr>
1833 <div class="refsect2">
1834 <a name="GstValueTable"></a><h3>struct GstValueTable</h3>
1835 <pre class="programlisting">struct GstValueTable {
1836   GType type;
1837   GstValueCompareFunc compare;
1838   GstValueSerializeFunc serialize;
1839   GstValueDeserializeFunc deserialize;
1840 };
1841 </pre>
1842 <p>
1843 VTable for the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> <em class="parameter"><code>type</code></em>.
1844 </p>
1845 <div class="variablelist"><table border="0">
1846 <col align="left" valign="top">
1847 <tbody>
1848 <tr>
1849 <td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> <em class="structfield"><code><a name="GstValueTable.type"></a>type</code></em>;</span></p></td>
1850 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a>
1851 </td>
1852 </tr>
1853 <tr>
1854 <td><p><span class="term"><a class="link" href="gstreamer-GstValue.html#GstValueCompareFunc" title="GstValueCompareFunc ()"><span class="type">GstValueCompareFunc</span></a> <em class="structfield"><code><a name="GstValueTable.compare"></a>compare</code></em>;</span></p></td>
1855 <td>a <a class="link" href="gstreamer-GstValue.html#GstValueCompareFunc" title="GstValueCompareFunc ()"><span class="type">GstValueCompareFunc</span></a>
1856 </td>
1857 </tr>
1858 <tr>
1859 <td><p><span class="term"><a class="link" href="gstreamer-GstValue.html#GstValueSerializeFunc" title="GstValueSerializeFunc ()"><span class="type">GstValueSerializeFunc</span></a> <em class="structfield"><code><a name="GstValueTable.serialize"></a>serialize</code></em>;</span></p></td>
1860 <td>a <a class="link" href="gstreamer-GstValue.html#GstValueSerializeFunc" title="GstValueSerializeFunc ()"><span class="type">GstValueSerializeFunc</span></a>
1861 </td>
1862 </tr>
1863 <tr>
1864 <td><p><span class="term"><a class="link" href="gstreamer-GstValue.html#GstValueDeserializeFunc" title="GstValueDeserializeFunc ()"><span class="type">GstValueDeserializeFunc</span></a> <em class="structfield"><code><a name="GstValueTable.deserialize"></a>deserialize</code></em>;</span></p></td>
1865 <td>a <a class="link" href="gstreamer-GstValue.html#GstValueDeserializeFunc" title="GstValueDeserializeFunc ()"><span class="type">GstValueDeserializeFunc</span></a>
1866 </td>
1867 </tr>
1868 </tbody>
1869 </table></div>
1870 </div>
1871 <hr>
1872 <div class="refsect2">
1873 <a name="gst-value-is-fixed"></a><h3>gst_value_is_fixed ()</h3>
1874 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_value_is_fixed                  (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
1875 <p>
1876 Tests if the given GValue, if available in a GstStructure (or any other
1877 container) contains a "fixed" (which means: one value) or an "unfixed"
1878 (which means: multiple possible values, such as data lists or data
1879 ranges) value.
1880 </p>
1881 <div class="variablelist"><table border="0">
1882 <col align="left" valign="top">
1883 <tbody>
1884 <tr>
1885 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1886 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to check</td>
1887 </tr>
1888 <tr>
1889 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1890 <td>true if the value is "fixed".</td>
1891 </tr>
1892 </tbody>
1893 </table></div>
1894 </div>
1895 <hr>
1896 <div class="refsect2">
1897 <a name="gst-value-register"></a><h3>gst_value_register ()</h3>
1898 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_register                  (<em class="parameter"><code>const <a class="link" href="gstreamer-GstValue.html#GstValueTable" title="struct GstValueTable"><span class="type">GstValueTable</span></a> *table</code></em>);</pre>
1899 <p>
1900 Registers functions to perform calculations on <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> items of a given
1901 type. Each type can only be added once.
1902 </p>
1903 <div class="variablelist"><table border="0">
1904 <col align="left" valign="top">
1905 <tbody><tr>
1906 <td><p><span class="term"><em class="parameter"><code>table</code></em> :</span></p></td>
1907 <td>structure containing functions to register</td>
1908 </tr></tbody>
1909 </table></div>
1910 </div>
1911 <hr>
1912 <div class="refsect2">
1913 <a name="gst-value-init-and-copy"></a><h3>gst_value_init_and_copy ()</h3>
1914 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_init_and_copy             (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
1915                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *src</code></em>);</pre>
1916 <p>
1917 Initialises the target value to be of the same type as source and then copies
1918 the contents from source to target.
1919 </p>
1920 <div class="variablelist"><table border="0">
1921 <col align="left" valign="top">
1922 <tbody>
1923 <tr>
1924 <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
1925 <td>the target value. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym> caller-allocates]</span>
1926 </td>
1927 </tr>
1928 <tr>
1929 <td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
1930 <td>the source value</td>
1931 </tr>
1932 </tbody>
1933 </table></div>
1934 </div>
1935 <hr>
1936 <div class="refsect2">
1937 <a name="gst-value-serialize"></a><h3>gst_value_serialize ()</h3>
1938 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             gst_value_serialize                 (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
1939 <p>
1940 tries to transform the given <em class="parameter"><code>value</code></em> into a string representation that allows
1941 getting back this string later on using <a class="link" href="gstreamer-GstValue.html#gst-value-deserialize" title="gst_value_deserialize ()"><code class="function">gst_value_deserialize()</code></a>.
1942 </p>
1943 <p>
1944 Free-function: g_free
1945 </p>
1946 <div class="variablelist"><table border="0">
1947 <col align="left" valign="top">
1948 <tbody>
1949 <tr>
1950 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1951 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to serialize</td>
1952 </tr>
1953 <tr>
1954 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1955 <td>the serialization for <em class="parameter"><code>value</code></em> or NULL if none exists. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1956 </td>
1957 </tr>
1958 </tbody>
1959 </table></div>
1960 </div>
1961 <hr>
1962 <div class="refsect2">
1963 <a name="gst-value-deserialize"></a><h3>gst_value_deserialize ()</h3>
1964 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_value_deserialize               (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
1965                                                          <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> *src</code></em>);</pre>
1966 <p>
1967 Tries to deserialize a string into the type specified by the given GValue.
1968 If the operation succeeds, TRUE is returned, FALSE otherwise.
1969 </p>
1970 <div class="variablelist"><table border="0">
1971 <col align="left" valign="top">
1972 <tbody>
1973 <tr>
1974 <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
1975 <td>
1976 <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to fill with contents of
1977 deserialization. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym> caller-allocates]</span>
1978 </td>
1979 </tr>
1980 <tr>
1981 <td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
1982 <td>string to deserialize</td>
1983 </tr>
1984 <tr>
1985 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1986 <td>TRUE on success</td>
1987 </tr>
1988 </tbody>
1989 </table></div>
1990 </div>
1991 <hr>
1992 <div class="refsect2">
1993 <a name="gst-value-compare"></a><h3>gst_value_compare ()</h3>
1994 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gst_value_compare                   (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
1995                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);</pre>
1996 <p>
1997 Compares <em class="parameter"><code>value1</code></em> and <em class="parameter"><code>value2</code></em>.  If <em class="parameter"><code>value1</code></em> and <em class="parameter"><code>value2</code></em> cannot be
1998 compared, the function returns GST_VALUE_UNORDERED.  Otherwise,
1999 if <em class="parameter"><code>value1</code></em> is greater than <em class="parameter"><code>value2</code></em>, GST_VALUE_GREATER_THAN is returned.
2000 If <em class="parameter"><code>value1</code></em> is less than <em class="parameter"><code>value2</code></em>, GST_VALUE_LESS_THAN is returned.
2001 If the values are equal, GST_VALUE_EQUAL is returned.
2002 </p>
2003 <div class="variablelist"><table border="0">
2004 <col align="left" valign="top">
2005 <tbody>
2006 <tr>
2007 <td><p><span class="term"><em class="parameter"><code>value1</code></em> :</span></p></td>
2008 <td>a value to compare</td>
2009 </tr>
2010 <tr>
2011 <td><p><span class="term"><em class="parameter"><code>value2</code></em> :</span></p></td>
2012 <td>another value to compare</td>
2013 </tr>
2014 <tr>
2015 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2016 <td>comparison result</td>
2017 </tr>
2018 </tbody>
2019 </table></div>
2020 </div>
2021 <hr>
2022 <div class="refsect2">
2023 <a name="gst-value-can-compare"></a><h3>gst_value_can_compare ()</h3>
2024 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_value_can_compare               (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
2025                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);</pre>
2026 <p>
2027 Determines if <em class="parameter"><code>value1</code></em> and <em class="parameter"><code>value2</code></em> can be compared.
2028 </p>
2029 <div class="variablelist"><table border="0">
2030 <col align="left" valign="top">
2031 <tbody>
2032 <tr>
2033 <td><p><span class="term"><em class="parameter"><code>value1</code></em> :</span></p></td>
2034 <td>a value to compare</td>
2035 </tr>
2036 <tr>
2037 <td><p><span class="term"><em class="parameter"><code>value2</code></em> :</span></p></td>
2038 <td>another value to compare</td>
2039 </tr>
2040 <tr>
2041 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2042 <td>TRUE if the values can be compared</td>
2043 </tr>
2044 </tbody>
2045 </table></div>
2046 </div>
2047 <hr>
2048 <div class="refsect2">
2049 <a name="gst-value-union"></a><h3>gst_value_union ()</h3>
2050 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_value_union                     (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
2051                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
2052                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);</pre>
2053 <p>
2054 Creates a GValue corresponding to the union of <em class="parameter"><code>value1</code></em> and <em class="parameter"><code>value2</code></em>.
2055 </p>
2056 <div class="variablelist"><table border="0">
2057 <col align="left" valign="top">
2058 <tbody>
2059 <tr>
2060 <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
2061 <td>the destination value. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym> caller-allocates]</span>
2062 </td>
2063 </tr>
2064 <tr>
2065 <td><p><span class="term"><em class="parameter"><code>value1</code></em> :</span></p></td>
2066 <td>a value to union</td>
2067 </tr>
2068 <tr>
2069 <td><p><span class="term"><em class="parameter"><code>value2</code></em> :</span></p></td>
2070 <td>another value to union</td>
2071 </tr>
2072 <tr>
2073 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2074 <td>always returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
2075 </td>
2076 </tr>
2077 </tbody>
2078 </table></div>
2079 </div>
2080 <hr>
2081 <div class="refsect2">
2082 <a name="gst-value-can-union"></a><h3>gst_value_can_union ()</h3>
2083 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_value_can_union                 (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
2084                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);</pre>
2085 <p>
2086 Determines if <em class="parameter"><code>value1</code></em> and <em class="parameter"><code>value2</code></em> can be non-trivially unioned.
2087 Any two values can be trivially unioned by adding both of them
2088 to a GstValueList.  However, certain types have the possibility
2089 to be unioned in a simpler way.  For example, an integer range
2090 and an integer can be unioned if the integer is a subset of the
2091 integer range.  If there is the possibility that two values can
2092 be unioned, this function returns TRUE.
2093 </p>
2094 <div class="variablelist"><table border="0">
2095 <col align="left" valign="top">
2096 <tbody>
2097 <tr>
2098 <td><p><span class="term"><em class="parameter"><code>value1</code></em> :</span></p></td>
2099 <td>a value to union</td>
2100 </tr>
2101 <tr>
2102 <td><p><span class="term"><em class="parameter"><code>value2</code></em> :</span></p></td>
2103 <td>another value to union</td>
2104 </tr>
2105 <tr>
2106 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2107 <td>TRUE if there is a function allowing the two values to
2108 be unioned.</td>
2109 </tr>
2110 </tbody>
2111 </table></div>
2112 </div>
2113 <hr>
2114 <div class="refsect2">
2115 <a name="gst-value-register-union-func"></a><h3>gst_value_register_union_func ()</h3>
2116 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_register_union_func       (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type1</code></em>,
2117                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type2</code></em>,
2118                                                          <em class="parameter"><code><a class="link" href="gstreamer-GstValue.html#GstValueUnionFunc" title="GstValueUnionFunc ()"><span class="type">GstValueUnionFunc</span></a> func</code></em>);</pre>
2119 <p>
2120 Registers a union function that can create a union between <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> items
2121 of the type <em class="parameter"><code>type1</code></em> and <em class="parameter"><code>type2</code></em>.
2122 </p>
2123 <p>
2124 Union functions should be registered at startup before any pipelines are
2125 started, as <a class="link" href="gstreamer-GstValue.html#gst-value-register-union-func" title="gst_value_register_union_func ()"><code class="function">gst_value_register_union_func()</code></a> is not thread-safe and cannot
2126 be used at the same time as <a class="link" href="gstreamer-GstValue.html#gst-value-union" title="gst_value_union ()"><code class="function">gst_value_union()</code></a> or <a class="link" href="gstreamer-GstValue.html#gst-value-can-union" title="gst_value_can_union ()"><code class="function">gst_value_can_union()</code></a>.
2127 </p>
2128 <div class="variablelist"><table border="0">
2129 <col align="left" valign="top">
2130 <tbody>
2131 <tr>
2132 <td><p><span class="term"><em class="parameter"><code>type1</code></em> :</span></p></td>
2133 <td>a type to union</td>
2134 </tr>
2135 <tr>
2136 <td><p><span class="term"><em class="parameter"><code>type2</code></em> :</span></p></td>
2137 <td>another type to union</td>
2138 </tr>
2139 <tr>
2140 <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
2141 <td>a function that implements creating a union between the two types</td>
2142 </tr>
2143 </tbody>
2144 </table></div>
2145 </div>
2146 <hr>
2147 <div class="refsect2">
2148 <a name="gst-value-subtract"></a><h3>gst_value_subtract ()</h3>
2149 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_value_subtract                  (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
2150                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *minuend</code></em>,
2151                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *subtrahend</code></em>);</pre>
2152 <p>
2153 Subtracts <em class="parameter"><code>subtrahend</code></em> from <em class="parameter"><code>minuend</code></em> and stores the result in <em class="parameter"><code>dest</code></em>.
2154 Note that this means subtraction as in sets, not as in mathematics.
2155 </p>
2156 <div class="variablelist"><table border="0">
2157 <col align="left" valign="top">
2158 <tbody>
2159 <tr>
2160 <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
2161 <td>the destination value for the result if the
2162 subtraction is not empty. May be NULL, in which case the resulting set
2163 will not be computed, which can give a fair speedup. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym> caller-allocates]</span>
2164 </td>
2165 </tr>
2166 <tr>
2167 <td><p><span class="term"><em class="parameter"><code>minuend</code></em> :</span></p></td>
2168 <td>the value to subtract from</td>
2169 </tr>
2170 <tr>
2171 <td><p><span class="term"><em class="parameter"><code>subtrahend</code></em> :</span></p></td>
2172 <td>the value to subtract</td>
2173 </tr>
2174 <tr>
2175 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2176 <td>
2177 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the subtraction is not empty</td>
2178 </tr>
2179 </tbody>
2180 </table></div>
2181 </div>
2182 <hr>
2183 <div class="refsect2">
2184 <a name="gst-value-can-subtract"></a><h3>gst_value_can_subtract ()</h3>
2185 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_value_can_subtract              (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *minuend</code></em>,
2186                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *subtrahend</code></em>);</pre>
2187 <p>
2188 Checks if it's possible to subtract <em class="parameter"><code>subtrahend</code></em> from <em class="parameter"><code>minuend</code></em>.
2189 </p>
2190 <div class="variablelist"><table border="0">
2191 <col align="left" valign="top">
2192 <tbody>
2193 <tr>
2194 <td><p><span class="term"><em class="parameter"><code>minuend</code></em> :</span></p></td>
2195 <td>the value to subtract from</td>
2196 </tr>
2197 <tr>
2198 <td><p><span class="term"><em class="parameter"><code>subtrahend</code></em> :</span></p></td>
2199 <td>the value to subtract</td>
2200 </tr>
2201 <tr>
2202 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2203 <td>TRUE if a subtraction is possible</td>
2204 </tr>
2205 </tbody>
2206 </table></div>
2207 </div>
2208 <hr>
2209 <div class="refsect2">
2210 <a name="gst-value-register-subtract-func"></a><h3>gst_value_register_subtract_func ()</h3>
2211 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_register_subtract_func    (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> minuend_type</code></em>,
2212                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> subtrahend_type</code></em>,
2213                                                          <em class="parameter"><code><a class="link" href="gstreamer-GstValue.html#GstValueSubtractFunc" title="GstValueSubtractFunc ()"><span class="type">GstValueSubtractFunc</span></a> func</code></em>);</pre>
2214 <p>
2215 Registers <em class="parameter"><code>func</code></em> as a function capable of subtracting the values of
2216 <em class="parameter"><code>subtrahend_type</code></em> from values of <em class="parameter"><code>minuend_type</code></em>.
2217 </p>
2218 <p>
2219 Subtract functions should be registered at startup before any pipelines are
2220 started, as <a class="link" href="gstreamer-GstValue.html#gst-value-register-subtract-func" title="gst_value_register_subtract_func ()"><code class="function">gst_value_register_subtract_func()</code></a> is not thread-safe and
2221 cannot be used at the same time as <a class="link" href="gstreamer-GstValue.html#gst-value-subtract" title="gst_value_subtract ()"><code class="function">gst_value_subtract()</code></a>.
2222 </p>
2223 <div class="variablelist"><table border="0">
2224 <col align="left" valign="top">
2225 <tbody>
2226 <tr>
2227 <td><p><span class="term"><em class="parameter"><code>minuend_type</code></em> :</span></p></td>
2228 <td>type of the minuend</td>
2229 </tr>
2230 <tr>
2231 <td><p><span class="term"><em class="parameter"><code>subtrahend_type</code></em> :</span></p></td>
2232 <td>type of the subtrahend</td>
2233 </tr>
2234 <tr>
2235 <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
2236 <td>function to use</td>
2237 </tr>
2238 </tbody>
2239 </table></div>
2240 </div>
2241 <hr>
2242 <div class="refsect2">
2243 <a name="gst-value-intersect"></a><h3>gst_value_intersect ()</h3>
2244 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_value_intersect                 (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
2245                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
2246                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);</pre>
2247 <p>
2248 Calculates the intersection of two values.  If the values have
2249 a non-empty intersection, the value representing the intersection
2250 is placed in <em class="parameter"><code>dest</code></em>, unless NULL.  If the intersection is non-empty,
2251 <em class="parameter"><code>dest</code></em> is not modified.
2252 </p>
2253 <div class="variablelist"><table border="0">
2254 <col align="left" valign="top">
2255 <tbody>
2256 <tr>
2257 <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
2258 <td>a uninitialized <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> that will hold the calculated
2259 intersection value. May be NULL if the resulting set if not needed. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym> caller-allocates]</span>
2260 </td>
2261 </tr>
2262 <tr>
2263 <td><p><span class="term"><em class="parameter"><code>value1</code></em> :</span></p></td>
2264 <td>a value to intersect</td>
2265 </tr>
2266 <tr>
2267 <td><p><span class="term"><em class="parameter"><code>value2</code></em> :</span></p></td>
2268 <td>another value to intersect</td>
2269 </tr>
2270 <tr>
2271 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2272 <td>TRUE if the intersection is non-empty</td>
2273 </tr>
2274 </tbody>
2275 </table></div>
2276 </div>
2277 <hr>
2278 <div class="refsect2">
2279 <a name="gst-value-can-intersect"></a><h3>gst_value_can_intersect ()</h3>
2280 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_value_can_intersect             (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value1</code></em>,
2281                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value2</code></em>);</pre>
2282 <p>
2283 Determines if intersecting two values will produce a valid result.
2284 Two values will produce a valid intersection if they have the same
2285 type, or if there is a method (registered by
2286 <a class="link" href="gstreamer-GstValue.html#gst-value-register-intersect-func" title="gst_value_register_intersect_func ()"><code class="function">gst_value_register_intersect_func()</code></a>) to calculate the intersection.
2287 </p>
2288 <div class="variablelist"><table border="0">
2289 <col align="left" valign="top">
2290 <tbody>
2291 <tr>
2292 <td><p><span class="term"><em class="parameter"><code>value1</code></em> :</span></p></td>
2293 <td>a value to intersect</td>
2294 </tr>
2295 <tr>
2296 <td><p><span class="term"><em class="parameter"><code>value2</code></em> :</span></p></td>
2297 <td>another value to intersect</td>
2298 </tr>
2299 <tr>
2300 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2301 <td>TRUE if the values can intersect</td>
2302 </tr>
2303 </tbody>
2304 </table></div>
2305 </div>
2306 <hr>
2307 <div class="refsect2">
2308 <a name="gst-value-register-intersect-func"></a><h3>gst_value_register_intersect_func ()</h3>
2309 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_register_intersect_func   (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type1</code></em>,
2310                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type2</code></em>,
2311                                                          <em class="parameter"><code><a class="link" href="gstreamer-GstValue.html#GstValueIntersectFunc" title="GstValueIntersectFunc ()"><span class="type">GstValueIntersectFunc</span></a> func</code></em>);</pre>
2312 <p>
2313 Registers a function that is called to calculate the intersection
2314 of the values having the types <em class="parameter"><code>type1</code></em> and <em class="parameter"><code>type2</code></em>.
2315 </p>
2316 <p>
2317 Intersect functions should be registered at startup before any pipelines are
2318 started, as <a class="link" href="gstreamer-GstValue.html#gst-value-register-intersect-func" title="gst_value_register_intersect_func ()"><code class="function">gst_value_register_intersect_func()</code></a> is not thread-safe and
2319 cannot be used at the same time as <a class="link" href="gstreamer-GstValue.html#gst-value-intersect" title="gst_value_intersect ()"><code class="function">gst_value_intersect()</code></a> or
2320 <a class="link" href="gstreamer-GstValue.html#gst-value-can-intersect" title="gst_value_can_intersect ()"><code class="function">gst_value_can_intersect()</code></a>.
2321 </p>
2322 <div class="variablelist"><table border="0">
2323 <col align="left" valign="top">
2324 <tbody>
2325 <tr>
2326 <td><p><span class="term"><em class="parameter"><code>type1</code></em> :</span></p></td>
2327 <td>the first type to intersect</td>
2328 </tr>
2329 <tr>
2330 <td><p><span class="term"><em class="parameter"><code>type2</code></em> :</span></p></td>
2331 <td>the second type to intersect</td>
2332 </tr>
2333 <tr>
2334 <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
2335 <td>the intersection function</td>
2336 </tr>
2337 </tbody>
2338 </table></div>
2339 </div>
2340 <hr>
2341 <div class="refsect2">
2342 <a name="gst-value-array-append-value"></a><h3>gst_value_array_append_value ()</h3>
2343 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_array_append_value        (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
2344                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *append_value</code></em>);</pre>
2345 <p>
2346 Appends <em class="parameter"><code>append_value</code></em> to the GstValueArray in <em class="parameter"><code>value</code></em>.
2347 </p>
2348 <div class="variablelist"><table border="0">
2349 <col align="left" valign="top">
2350 <tbody>
2351 <tr>
2352 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2353 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a class="link" href="gstreamer-GstValue.html#GST-TYPE-ARRAY:CAPS" title="GST_TYPE_ARRAY"><span class="type">GST_TYPE_ARRAY</span></a>
2354 </td>
2355 </tr>
2356 <tr>
2357 <td><p><span class="term"><em class="parameter"><code>append_value</code></em> :</span></p></td>
2358 <td>the value to append</td>
2359 </tr>
2360 </tbody>
2361 </table></div>
2362 </div>
2363 <hr>
2364 <div class="refsect2">
2365 <a name="gst-value-array-get-size"></a><h3>gst_value_array_get_size ()</h3>
2366 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gst_value_array_get_size            (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
2367 <p>
2368 Gets the number of values contained in <em class="parameter"><code>value</code></em>.
2369 </p>
2370 <div class="variablelist"><table border="0">
2371 <col align="left" valign="top">
2372 <tbody>
2373 <tr>
2374 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2375 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a class="link" href="gstreamer-GstValue.html#GST-TYPE-ARRAY:CAPS" title="GST_TYPE_ARRAY"><span class="type">GST_TYPE_ARRAY</span></a>
2376 </td>
2377 </tr>
2378 <tr>
2379 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2380 <td>the number of values</td>
2381 </tr>
2382 </tbody>
2383 </table></div>
2384 </div>
2385 <hr>
2386 <div class="refsect2">
2387 <a name="gst-value-array-get-value"></a><h3>gst_value_array_get_value ()</h3>
2388 <pre class="programlisting">const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *      gst_value_array_get_value           (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
2389                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);</pre>
2390 <p>
2391 Gets the value that is a member of the array contained in <em class="parameter"><code>value</code></em> and
2392 has the index <em class="parameter"><code>index</code></em>.
2393 </p>
2394 <div class="variablelist"><table border="0">
2395 <col align="left" valign="top">
2396 <tbody>
2397 <tr>
2398 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2399 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a class="link" href="gstreamer-GstValue.html#GST-TYPE-ARRAY:CAPS" title="GST_TYPE_ARRAY"><span class="type">GST_TYPE_ARRAY</span></a>
2400 </td>
2401 </tr>
2402 <tr>
2403 <td><p><span class="term"><em class="parameter"><code>index</code></em> :</span></p></td>
2404 <td>index of value to get from the array</td>
2405 </tr>
2406 <tr>
2407 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2408 <td>the value at the given index. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2409 </td>
2410 </tr>
2411 </tbody>
2412 </table></div>
2413 </div>
2414 <hr>
2415 <div class="refsect2">
2416 <a name="gst-value-array-prepend-value"></a><h3>gst_value_array_prepend_value ()</h3>
2417 <pre class="programlisting"><span class="returnvalue">void</span>                gst_value_array_prepend_value       (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
2418                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *prepend_value</code></em>);</pre>
2419 <p>
2420 Prepends <em class="parameter"><code>prepend_value</code></em> to the GstValueArray in <em class="parameter"><code>value</code></em>.
2421 </p>
2422 <div class="variablelist"><table border="0">
2423 <col align="left" valign="top">
2424 <tbody>
2425 <tr>
2426 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2427 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of type <a class="link" href="gstreamer-GstValue.html#GST-TYPE-ARRAY:CAPS" title="GST_TYPE_ARRAY"><span class="type">GST_TYPE_ARRAY</span></a>
2428 </td>
2429 </tr>
2430 <tr>
2431 <td><p><span class="term"><em class="parameter"><code>prepend_value</code></em> :</span></p></td>
2432 <td>the value to prepend</td>
2433 </tr>
2434 </tbody>
2435 </table></div>
2436 </div>
2437 </div>
2438 </div>
2439 <div class="footer">
2440 <hr>
2441           Generated by GTK-Doc V1.18</div>
2442 </body>
2443 </html>