docs/libs/html/gst-plugins-base-libs-encoding-profile.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>encoding-profile</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GStreamer Base Plugins 0.10 Library Reference Manual">
   8 <link rel="up" href="gstreamer-base-utils.html" title="Base Utils Library">
   9 <link rel="prev" href="gst-plugins-base-libs-gstdiscoverer.html" title="gstdiscoverer">
  10 <link rel="next" href="gstreamer-video.html" title="Video Library">
  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="gst-plugins-base-libs-gstdiscoverer.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="gstreamer-base-utils.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">GStreamer Base Plugins 0.10 Library Reference Manual</th>
  21 <td><a accesskey="n" href="gstreamer-video.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#gst-plugins-base-libs-encoding-profile.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#gst-plugins-base-libs-encoding-profile.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#gst-plugins-base-libs-encoding-profile.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29 </td></tr>
  30 </table>
  31 <div class="refentry">
  32 <a name="gst-plugins-base-libs-encoding-profile"></a><div class="titlepage"></div>
  33 <div class="refnamediv"><table width="100%"><tr>
  34 <td valign="top">
  35 <h2><span class="refentrytitle"><a name="gst-plugins-base-libs-encoding-profile.top_of_page"></a>encoding-profile</span></h2>
  36 <p>encoding-profile — Encoding profile library</p>
  37 </td>
  38 <td valign="top" align="right"></td>
  39 </tr></table></div>
  40 <div class="refsynopsisdiv">
  41 <a name="gst-plugins-base-libs-encoding-profile.synopsis"></a><h2>Synopsis</h2>
  42 <a name="GstEncodingProfile"></a><a name="GstEncodingContainerProfile"></a><a name="GstEncodingAudioProfile"></a><a name="GstEncodingVideoProfile"></a><a name="GstEncodingTarget"></a><pre class="synopsis">
  43 #include &lt;gst/pbutils/encoding-profile.h&gt;
  44
  45                     <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile-struct" title="GstEncodingProfile">GstEncodingProfile</a>;
  46 #define             <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-unref" title="gst_encoding_profile_unref()">gst_encoding_profile_unref</a>          (profile)
  47 #define             <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-ref" title="gst_encoding_profile_ref()">gst_encoding_profile_ref</a>            (profile)
  48 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="returnvalue">GstEncodingProfile</span></a> * <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-find" title="gst_encoding_profile_find ()">gst_encoding_profile_find</a>          (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *targetname</code></em>,
  49                                                          <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> *profilename</code></em>,
  50                                                          <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> *category</code></em>);
  51 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="returnvalue">GstEncodingProfile</span></a> * <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-from-discoverer" title="gst_encoding_profile_from_discoverer ()">gst_encoding_profile_from_discoverer</a>
  52                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstdiscoverer.html#GstDiscovererInfo"><span class="type">GstDiscovererInfo</span></a> *info</code></em>);
  53 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-get-name" title="gst_encoding_profile_get_name ()">gst_encoding_profile_get_name</a>       (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);
  54 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-get-description" title="gst_encoding_profile_get_description ()">gst_encoding_profile_get_description</a>
  55                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);
  56 const <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="returnvalue">GstCaps</span></a> *     <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-get-format" title="gst_encoding_profile_get_format ()">gst_encoding_profile_get_format</a>     (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);
  57 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-get-preset" title="gst_encoding_profile_get_preset ()">gst_encoding_profile_get_preset</a>     (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);
  58 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-get-presence" title="gst_encoding_profile_get_presence ()">gst_encoding_profile_get_presence</a>   (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);
  59 const <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="returnvalue">GstCaps</span></a> *     <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-get-restriction" title="gst_encoding_profile_get_restriction ()">gst_encoding_profile_get_restriction</a>
  60                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);
  61 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-set-name" title="gst_encoding_profile_set_name ()">gst_encoding_profile_set_name</a>       (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>,
  62                                                          <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> *name</code></em>);
  63 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-set-description" title="gst_encoding_profile_set_description ()">gst_encoding_profile_set_description</a>
  64                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>,
  65                                                          <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> *description</code></em>);
  66 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-set-format" title="gst_encoding_profile_set_format ()">gst_encoding_profile_set_format</a>     (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>,
  67                                                          <em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> *format</code></em>);
  68 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-set-preset" title="gst_encoding_profile_set_preset ()">gst_encoding_profile_set_preset</a>     (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>,
  69                                                          <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> *preset</code></em>);
  70 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-set-restriction" title="gst_encoding_profile_set_restriction ()">gst_encoding_profile_set_restriction</a>
  71                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>,
  72                                                          <em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> *restriction</code></em>);
  73 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-set-presence" title="gst_encoding_profile_set_presence ()">gst_encoding_profile_set_presence</a>   (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>,
  74                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> presence</code></em>);
  75 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-is-equal" title="gst_encoding_profile_is_equal ()">gst_encoding_profile_is_equal</a>       (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *a</code></em>,
  76                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *b</code></em>);
  77 <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="returnvalue">GstCaps</span></a> *           <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-get-input-caps" title="gst_encoding_profile_get_input_caps ()">gst_encoding_profile_get_input_caps</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);
  78 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-get-type-nick" title="gst_encoding_profile_get_type_nick ()">gst_encoding_profile_get_type_nick</a>  (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);
  79
  80                     <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingContainerProfile-struct" title="GstEncodingContainerProfile">GstEncodingContainerProfile</a>;
  81 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingContainerProfile"><span class="returnvalue">GstEncodingContainerProfile</span></a> * <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-container-profile-new" title="gst_encoding_container_profile_new ()">gst_encoding_container_profile_new</a>
  82                                                         (<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> *name</code></em>,
  83                                                          <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> *description</code></em>,
  84                                                          <em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> *format</code></em>,
  85                                                          <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> *preset</code></em>);
  86 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-container-profile-add-profile" title="gst_encoding_container_profile_add_profile ()">gst_encoding_container_profile_add_profile</a>
  87                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a> *container</code></em>,
  88                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);
  89 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-container-profile-contains-profile" title="gst_encoding_container_profile_contains_profile ()">gst_encoding_container_profile_contains_profile</a>
  90                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a> *container</code></em>,
  91                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);
  92 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *       <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-container-profile-get-profiles" title="gst_encoding_container_profile_get_profiles ()">gst_encoding_container_profile_get_profiles</a>
  93                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a> *profile</code></em>);
  94
  95                     <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingAudioProfile-struct" title="GstEncodingAudioProfile">GstEncodingAudioProfile</a>;
  96 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingAudioProfile"><span class="returnvalue">GstEncodingAudioProfile</span></a> * <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-audio-profile-new" title="gst_encoding_audio_profile_new ()">gst_encoding_audio_profile_new</a>
  97                                                         (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> *format</code></em>,
  98                                                          <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> *preset</code></em>,
  99                                                          <em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> *restriction</code></em>,
 100                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> presence</code></em>);
 101
 102                     <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile-struct" title="GstEncodingVideoProfile">GstEncodingVideoProfile</a>;
 103 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile"><span class="returnvalue">GstEncodingVideoProfile</span></a> * <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-video-profile-new" title="gst_encoding_video_profile_new ()">gst_encoding_video_profile_new</a>
 104                                                         (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> *format</code></em>,
 105                                                          <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> *preset</code></em>,
 106                                                          <em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> *restriction</code></em>,
 107                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> presence</code></em>);
 108 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-video-profile-get-pass" title="gst_encoding_video_profile_get_pass ()">gst_encoding_video_profile_get_pass</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a> *prof</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="gst-plugins-base-libs-encoding-profile.html#gst-encoding-video-profile-get-variableframerate" title="gst_encoding_video_profile_get_variableframerate ()">gst_encoding_video_profile_get_variableframerate</a>
 110                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a> *prof</code></em>);
 111 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-video-profile-set-pass" title="gst_encoding_video_profile_set_pass ()">gst_encoding_video_profile_set_pass</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a> *prof</code></em>,
 112                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> pass</code></em>);
 113 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-video-profile-set-variableframerate" title="gst_encoding_video_profile_set_variableframerate ()">gst_encoding_video_profile_set_variableframerate</a>
 114                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a> *prof</code></em>,
 115                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> variableframerate</code></em>);
 116
 117 #define             <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GST-ENCODING-CATEGORY-DEVICE:CAPS" title="GST_ENCODING_CATEGORY_DEVICE">GST_ENCODING_CATEGORY_DEVICE</a>
 118 #define             <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GST-ENCODING-CATEGORY-ONLINE-SERVICE:CAPS" title="GST_ENCODING_CATEGORY_ONLINE_SERVICE">GST_ENCODING_CATEGORY_ONLINE_SERVICE</a>
 119 #define             <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GST-ENCODING-CATEGORY-STORAGE-EDITING:CAPS" title="GST_ENCODING_CATEGORY_STORAGE_EDITING">GST_ENCODING_CATEGORY_STORAGE_EDITING</a>
 120 #define             <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GST-ENCODING-CATEGORY-CAPTURE:CAPS" title="GST_ENCODING_CATEGORY_CAPTURE">GST_ENCODING_CATEGORY_CAPTURE</a>
 121                     <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget-struct" title="GstEncodingTarget">GstEncodingTarget</a>;
 122 #define             <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-target-unref" title="gst_encoding_target_unref()">gst_encoding_target_unref</a>           (target)
 123 #define             <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-target-ref" title="gst_encoding_target_ref()">gst_encoding_target_ref</a>             (target)
 124 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="returnvalue">GstEncodingTarget</span></a> * <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-target-new" title="gst_encoding_target_new ()">gst_encoding_target_new</a>             (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 125                                                          <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> *category</code></em>,
 126                                                          <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> *description</code></em>,
 127                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *profiles</code></em>);
 128 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-target-get-name" title="gst_encoding_target_get_name ()">gst_encoding_target_get_name</a>        (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>);
 129 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-target-get-category" title="gst_encoding_target_get_category ()">gst_encoding_target_get_category</a>    (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>);
 130 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-target-get-description" title="gst_encoding_target_get_description ()">gst_encoding_target_get_description</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>);
 131 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *       <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-target-get-profiles" title="gst_encoding_target_get_profiles ()">gst_encoding_target_get_profiles</a>    (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>);
 132 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="returnvalue">GstEncodingProfile</span></a> * <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-target-get-profile" title="gst_encoding_target_get_profile ()">gst_encoding_target_get_profile</a>    (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>,
 133                                                          <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> *name</code></em>);
 134 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-target-add-profile" title="gst_encoding_target_add_profile ()">gst_encoding_target_add_profile</a>     (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>,
 135                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);
 136 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-target-save" title="gst_encoding_target_save ()">gst_encoding_target_save</a>            (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>,
 137                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 138 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-target-save-to-file" title="gst_encoding_target_save_to_file ()">gst_encoding_target_save_to_file</a>    (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>,
 139                                                          <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> *filepath</code></em>,
 140                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 141 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="returnvalue">GstEncodingTarget</span></a> * <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-target-load" title="gst_encoding_target_load ()">gst_encoding_target_load</a>            (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 142                                                          <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> *category</code></em>,
 143                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 144 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="returnvalue">GstEncodingTarget</span></a> * <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-target-load-from-file" title="gst_encoding_target_load_from_file ()">gst_encoding_target_load_from_file</a>  (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filepath</code></em>,
 145                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 146 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-list-all-targets" title="gst_encoding_list_all_targets ()">gst_encoding_list_all_targets</a>       (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *categoryname</code></em>);
 147 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-list-available-categories" title="gst_encoding_list_available_categories ()">gst_encoding_list_available_categories</a>
 148                                                         (<em class="parameter"><code><span class="type">void</span></code></em>);
 149 </pre>
 150 </div>
 151 <div class="refsect1">
 152 <a name="gst-plugins-base-libs-encoding-profile.object-hierarchy"></a><h2>Object Hierarchy</h2>
 153 <pre class="synopsis">
 154   <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstMiniObject.html#GstMiniObject">GstMiniObject</a>
 155    +----GstEncodingProfile
 156          +----<a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile">GstEncodingVideoProfile</a>
 157          +----<a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingAudioProfile">GstEncodingAudioProfile</a>
 158          +----<a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingContainerProfile">GstEncodingContainerProfile</a>
 159 </pre>
 160 <pre class="synopsis">
 161   <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstMiniObject.html#GstMiniObject">GstMiniObject</a>
 162    +----<a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile">GstEncodingProfile</a>
 163          +----GstEncodingContainerProfile
 164 </pre>
 165 <pre class="synopsis">
 166   <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstMiniObject.html#GstMiniObject">GstMiniObject</a>
 167    +----<a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile">GstEncodingProfile</a>
 168          +----GstEncodingAudioProfile
 169 </pre>
 170 <pre class="synopsis">
 171   <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstMiniObject.html#GstMiniObject">GstMiniObject</a>
 172    +----<a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile">GstEncodingProfile</a>
 173          +----GstEncodingVideoProfile
 174 </pre>
 175 <pre class="synopsis">
 176   <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstMiniObject.html#GstMiniObject">GstMiniObject</a>
 177    +----GstEncodingTarget
 178 </pre>
 179 </div>
 180 <div class="refsect1">
 181 <a name="gst-plugins-base-libs-encoding-profile.description"></a><h2>Description</h2>
 182 <p>
 183 </p>
 184 <div class="refsect2">
 185 <a name="idp29241168"></a><p>
 186 Functions to create and handle encoding profiles.
 187 </p>
 188 <p>
 189 Encoding profiles describe the media types and settings one wishes to use for
 190 an encoding process. The top-level profiles are commonly
 191 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a>(s) (which contains a user-readable name and
 192 description along with which container format to use). These, in turn,
 193 reference one or more <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>(s) which indicate which encoding
 194 format should be used on each individual streams.
 195 </p>
 196 <p>
 197 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>(s) can be provided to the 'encodebin' element, which will take
 198 care of selecting and setting up the required elements to produce an output stream
 199 conforming to the specifications of the profile.
 200 </p>
 201 <p>
 202 Unlike other systems, the encoding profiles do not specify which <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html"><span class="type">GstElement</span></a> to use
 203 for the various encoding and muxing steps, but instead relies on specifying the format
 204 one wishes to use.
 205 </p>
 206 <p>
 207 Encoding profiles can be created at runtime by the application or loaded from (and saved
 208 to) file using the <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> API.
 209 </p>
 210 </div>
 211 <p>
 212 </p>
 213 <hr>
 214 <div class="refsect2">
 215 <a name="idp29248736"></a><h3>Example: Creating a profile</h3>
 216 <p>
 217 </p>
 218 <div class="informalexample">
 219   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 220     <tbody>
 221       <tr>
 222         <td class="listing_lines" align="right"><pre>1
 223 2
 224 3
 225 4
 226 5
 227 6
 228 7
 229 8
 230 9
 231 10
 232 11
 233 12
 234 13
 235 14
 236 15
 237 16
 238 17
 239 18
 240 19
 241 20
 242 21
 243 22
 244 23
 245 24
 246 25
 247 26</pre></td>
 248         <td class="listing_code"><pre class="programlisting"><span class="gtkdoc ppc">#include &lt;gst/pbutils/encoding-profile.h&gt;</span>
 249 <span class="gtkdoc opt">...</span>
 250 GstEncodingProfile <span class="gtkdoc opt">*</span>
 251 <span class="function">create_ogg_theora_profile</span><span class="gtkdoc opt">(</span><span class="gtkdoc kwb">void</span><span class="gtkdoc opt">)</span>
 252 <span class="gtkdoc opt">{</span>
 253  GstEncodingContainerProfile <span class="gtkdoc opt">*</span>prof<span class="gtkdoc opt">;</span>
 254  GstCaps <span class="gtkdoc opt">*</span>caps<span class="gtkdoc opt">;</span>
 255
 256  caps <span class="gtkdoc opt">=</span> <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#gst-caps-from-string">gst_caps_from_string</a></span><span class="gtkdoc opt">(</span><span class="string">&quot;application/ogg&quot;</span><span class="gtkdoc opt">);</span>
 257  prof <span class="gtkdoc opt">=</span> <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-libs/html/gst-plugins-base-libs-encoding-profile.html#gst-encoding-container-profile-new">gst_encoding_container_profile_new</a></span><span class="gtkdoc opt">(</span><span class="string">&quot;Ogg audio/video&quot;</span><span class="gtkdoc opt">,</span>
 258     <span class="string">&quot;Standard OGG/THEORA/VORBIS&quot;</span><span class="gtkdoc opt">,</span>
 259     caps<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">);</span>
 260  <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#gst-caps-unref">gst_caps_unref</a></span> <span class="gtkdoc opt">(</span>caps<span class="gtkdoc opt">);</span>
 261
 262  caps <span class="gtkdoc opt">=</span> <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#gst-caps-from-string">gst_caps_from_string</a></span><span class="gtkdoc opt">(</span><span class="string">&quot;video/x-theora&quot;</span><span class="gtkdoc opt">);</span>
 263  <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-libs/html/gst-plugins-base-libs-encoding-profile.html#gst-encoding-container-profile-add-profile">gst_encoding_container_profile_add_profile</a></span><span class="gtkdoc opt">(</span>prof<span class="gtkdoc opt">,</span>
 264       <span class="gtkdoc opt">(</span>GstEncodingProfile<span class="gtkdoc opt">*)</span> <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-libs/html/gst-plugins-base-libs-encoding-profile.html#gst-encoding-video-profile-new">gst_encoding_video_profile_new</a></span><span class="gtkdoc opt">(</span>caps<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">,</span> <span class="number">0</span><span class="gtkdoc opt">));</span>
 265  <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#gst-caps-unref">gst_caps_unref</a></span> <span class="gtkdoc opt">(</span>caps<span class="gtkdoc opt">);</span>
 266
 267  caps <span class="gtkdoc opt">=</span> <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#gst-caps-from-string">gst_caps_from_string</a></span><span class="gtkdoc opt">(</span><span class="string">&quot;audio/x-vorbis&quot;</span><span class="gtkdoc opt">);</span>
 268  <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-libs/html/gst-plugins-base-libs-encoding-profile.html#gst-encoding-container-profile-add-profile">gst_encoding_container_profile_add_profile</a></span><span class="gtkdoc opt">(</span>prof<span class="gtkdoc opt">,</span>
 269       <span class="gtkdoc opt">(</span>GstEncodingProfile<span class="gtkdoc opt">*)</span> <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-libs/html/gst-plugins-base-libs-encoding-profile.html#gst-encoding-audio-profile-new">gst_encoding_audio_profile_new</a></span><span class="gtkdoc opt">(</span>caps<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">,</span> <span class="number">0</span><span class="gtkdoc opt">));</span>
 270  <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#gst-caps-unref">gst_caps_unref</a></span> <span class="gtkdoc opt">(</span>caps<span class="gtkdoc opt">);</span>
 271
 272  <span class="keyword">return</span> <span class="gtkdoc opt">(</span>GstEncodingProfile<span class="gtkdoc opt">*)</span> prof<span class="gtkdoc opt">;</span>
 273 <span class="gtkdoc opt">}</span></pre></td>
 274       </tr>
 275     </tbody>
 276   </table>
 277 </div>
 278
 279 <p>
 280 </p>
 281 </div>
 282 <p>
 283 </p>
 284 <hr>
 285 <div class="refsect2">
 286 <a name="idp29251728"></a><h3>Example: Listing categories, targets and profiles</h3>
 287 <p>
 288 </p>
 289 <div class="informalexample">
 290   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 291     <tbody>
 292       <tr>
 293         <td class="listing_lines" align="right"><pre>1
 294 2
 295 3
 296 4
 297 5
 298 6
 299 7
 300 8
 301 9
 302 10
 303 11
 304 12
 305 13
 306 14
 307 15
 308 16
 309 17
 310 18
 311 19
 312 20
 313 21
 314 22
 315 23
 316 24
 317 25
 318 26
 319 27</pre></td>
 320         <td class="listing_code"><pre class="programlisting"><span class="gtkdoc ppc">#include &lt;gst/pbutils/encoding-profile.h&gt;</span>
 321 <span class="gtkdoc opt">...</span>
 322 GstEncodingProfile <span class="gtkdoc opt">*</span>prof<span class="gtkdoc opt">;</span>
 323 GList <span class="gtkdoc opt">*</span>categories<span class="gtkdoc opt">, *</span>tmpc<span class="gtkdoc opt">;</span>
 324 GList <span class="gtkdoc opt">*</span>targets<span class="gtkdoc opt">, *</span>tmpt<span class="gtkdoc opt">;</span>
 325 <span class="gtkdoc opt">...</span>
 326 categories <span class="gtkdoc opt">=</span> <span class="function">gst_encoding_target_list_available_categories</span><span class="gtkdoc opt">();</span>
 327
 328 <span class="gtkdoc opt">...</span> Show available categories to user <span class="gtkdoc opt">...</span>
 329
 330 <span class="keyword">for</span> <span class="gtkdoc opt">(</span>tmpc <span class="gtkdoc opt">=</span> categories<span class="gtkdoc opt">;</span> tmpc<span class="gtkdoc opt">;</span> tmpc <span class="gtkdoc opt">=</span> tmpc<span class="gtkdoc opt">-&gt;</span>next<span class="gtkdoc opt">) {</span>
 331   gchar <span class="gtkdoc opt">*</span>category <span class="gtkdoc opt">= (</span>gchar <span class="gtkdoc opt">*)</span> tmpc<span class="gtkdoc opt">-&gt;</span>data<span class="gtkdoc opt">;</span>
 332
 333   <span class="gtkdoc opt">...</span> <span class="keyword">and</span> we can list all targets within that category <span class="gtkdoc opt">...</span>
 334
 335   targets <span class="gtkdoc opt">=</span> <span class="function">gst_encoding_target_list_all</span> <span class="gtkdoc opt">(</span>category<span class="gtkdoc opt">);</span>
 336
 337   <span class="gtkdoc opt">...</span> <span class="keyword">and</span> show a list to our users <span class="gtkdoc opt">...</span>
 338
 339   <span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-foreach">g_list_foreach</a></span> <span class="gtkdoc opt">(</span>targets<span class="gtkdoc opt">, (</span>GFunc<span class="gtkdoc opt">)</span> gst_encoding_target_unref<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">);</span>
 340   <span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free">g_list_free</a></span> <span class="gtkdoc opt">(</span>targets<span class="gtkdoc opt">);</span>
 341 <span class="gtkdoc opt">}</span>
 342
 343 <span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-foreach">g_list_foreach</a></span> <span class="gtkdoc opt">(</span>categories<span class="gtkdoc opt">, (</span>GFunc<span class="gtkdoc opt">)</span> g_free<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">);</span>
 344 <span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free">g_list_free</a></span> <span class="gtkdoc opt">(</span>categories<span class="gtkdoc opt">);</span>
 345
 346 <span class="gtkdoc opt">...</span></pre></td>
 347       </tr>
 348     </tbody>
 349   </table>
 350 </div>
 351
 352 <p>
 353 </p>
 354 </div>
 355 <p>
 356 </p>
 357 </div>
 358 <div class="refsect1">
 359 <a name="gst-plugins-base-libs-encoding-profile.details"></a><h2>Details</h2>
 360 <div class="refsect2">
 361 <a name="GstEncodingProfile-struct"></a><h3>GstEncodingProfile</h3>
 362 <pre class="programlisting">typedef struct _GstEncodingProfile GstEncodingProfile;</pre>
 363 <p>
 364 The opaque base class object for all encoding profiles. This contains generic
 365 information like name, description, format and preset.
 366 </p>
 367 <p class="since">Since 0.10.32</p>
 368 </div>
 369 <hr>
 370 <div class="refsect2">
 371 <a name="gst-encoding-profile-unref"></a><h3>gst_encoding_profile_unref()</h3>
 372 <pre class="programlisting">#define gst_encoding_profile_unref(profile) (gst_mini_object_unref ((GstMiniObject*) profile))
 373 </pre>
 374 <p>
 375 Decreases the reference count of the <em class="parameter"><code>profile</code></em>, possibly freeing the <em class="parameter"><code>profile</code></em>.
 376 </p>
 377 <div class="variablelist"><table border="0">
 378 <col align="left" valign="top">
 379 <tbody><tr>
 380 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 381 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 382 </td>
 383 </tr></tbody>
 384 </table></div>
 385 <p class="since">Since 0.10.32</p>
 386 </div>
 387 <hr>
 388 <div class="refsect2">
 389 <a name="gst-encoding-profile-ref"></a><h3>gst_encoding_profile_ref()</h3>
 390 <pre class="programlisting">#define gst_encoding_profile_ref(profile) (gst_mini_object_ref ((GstMiniObject*) profile))
 391 </pre>
 392 <p>
 393 Increases the reference count of the <em class="parameter"><code>profile</code></em>.
 394 </p>
 395 <div class="variablelist"><table border="0">
 396 <col align="left" valign="top">
 397 <tbody><tr>
 398 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 399 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 400 </td>
 401 </tr></tbody>
 402 </table></div>
 403 <p class="since">Since 0.10.32</p>
 404 </div>
 405 <hr>
 406 <div class="refsect2">
 407 <a name="gst-encoding-profile-find"></a><h3>gst_encoding_profile_find ()</h3>
 408 <pre class="programlisting"><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="returnvalue">GstEncodingProfile</span></a> * gst_encoding_profile_find          (<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> *targetname</code></em>,
 409                                                          <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> *profilename</code></em>,
 410                                                          <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> *category</code></em>);</pre>
 411 <p>
 412 Find the <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> with the specified name and category.
 413 </p>
 414 <div class="variablelist"><table border="0">
 415 <col align="left" valign="top">
 416 <tbody>
 417 <tr>
 418 <td><p><span class="term"><em class="parameter"><code>targetname</code></em> :</span></p></td>
 419 <td>The name of the target. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 420 </td>
 421 </tr>
 422 <tr>
 423 <td><p><span class="term"><em class="parameter"><code>profilename</code></em> :</span></p></td>
 424 <td>The name of the profile. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 425 </td>
 426 </tr>
 427 <tr>
 428 <td><p><span class="term"><em class="parameter"><code>category</code></em> :</span></p></td>
 429 <td>The target category. Can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 430 </td>
 431 </tr>
 432 <tr>
 433 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 434 <td>The matching <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 435 </td>
 436 </tr>
 437 </tbody>
 438 </table></div>
 439 <p class="since">Since 0.10.32</p>
 440 </div>
 441 <hr>
 442 <div class="refsect2">
 443 <a name="gst-encoding-profile-from-discoverer"></a><h3>gst_encoding_profile_from_discoverer ()</h3>
 444 <pre class="programlisting"><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="returnvalue">GstEncodingProfile</span></a> * gst_encoding_profile_from_discoverer
 445                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstdiscoverer.html#GstDiscovererInfo"><span class="type">GstDiscovererInfo</span></a> *info</code></em>);</pre>
 446 <p>
 447 Creates a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> matching the formats from the given
 448 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>. Streams other than audio or video (eg,
 449 subtitles), are currently ignored.
 450 </p>
 451 <div class="variablelist"><table border="0">
 452 <col align="left" valign="top">
 453 <tbody>
 454 <tr>
 455 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 456 <td>The <a class="link" href="gst-plugins-base-libs-gstdiscoverer.html#GstDiscovererInfo"><span class="type">GstDiscovererInfo</span></a> to read from. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 457 </td>
 458 </tr>
 459 <tr>
 460 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 461 <td>The new <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 462 </td>
 463 </tr>
 464 </tbody>
 465 </table></div>
 466 <p class="since">Since 0.10.36</p>
 467 </div>
 468 <hr>
 469 <div class="refsect2">
 470 <a name="gst-encoding-profile-get-name"></a><h3>gst_encoding_profile_get_name ()</h3>
 471 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gst_encoding_profile_get_name       (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre>
 472 <div class="variablelist"><table border="0">
 473 <col align="left" valign="top">
 474 <tbody>
 475 <tr>
 476 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 477 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 478 </td>
 479 </tr>
 480 <tr>
 481 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 482 <td>the name of the profile, can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
 483 </tr>
 484 </tbody>
 485 </table></div>
 486 <p class="since">Since 0.10.32</p>
 487 </div>
 488 <hr>
 489 <div class="refsect2">
 490 <a name="gst-encoding-profile-get-description"></a><h3>gst_encoding_profile_get_description ()</h3>
 491 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gst_encoding_profile_get_description
 492                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre>
 493 <div class="variablelist"><table border="0">
 494 <col align="left" valign="top">
 495 <tbody>
 496 <tr>
 497 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 498 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 499 </td>
 500 </tr>
 501 <tr>
 502 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 503 <td>the description of the profile, can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
 504 </tr>
 505 </tbody>
 506 </table></div>
 507 <p class="since">Since 0.10.32</p>
 508 </div>
 509 <hr>
 510 <div class="refsect2">
 511 <a name="gst-encoding-profile-get-format"></a><h3>gst_encoding_profile_get_format ()</h3>
 512 <pre class="programlisting">const <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="returnvalue">GstCaps</span></a> *     gst_encoding_profile_get_format     (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre>
 513 <div class="variablelist"><table border="0">
 514 <col align="left" valign="top">
 515 <tbody>
 516 <tr>
 517 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 518 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 519 </td>
 520 </tr>
 521 <tr>
 522 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 523 <td>the <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> corresponding to the media format used in the profile.</td>
 524 </tr>
 525 </tbody>
 526 </table></div>
 527 <p class="since">Since 0.10.32</p>
 528 </div>
 529 <hr>
 530 <div class="refsect2">
 531 <a name="gst-encoding-profile-get-preset"></a><h3>gst_encoding_profile_get_preset ()</h3>
 532 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gst_encoding_profile_get_preset     (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre>
 533 <div class="variablelist"><table border="0">
 534 <col align="left" valign="top">
 535 <tbody>
 536 <tr>
 537 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 538 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 539 </td>
 540 </tr>
 541 <tr>
 542 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 543 <td>the name of the <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPreset.html"><span class="type">GstPreset</span></a> to be used in the profile.</td>
 544 </tr>
 545 </tbody>
 546 </table></div>
 547 <p class="since">Since 0.10.32</p>
 548 </div>
 549 <hr>
 550 <div class="refsect2">
 551 <a name="gst-encoding-profile-get-presence"></a><h3>gst_encoding_profile_get_presence ()</h3>
 552 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gst_encoding_profile_get_presence   (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre>
 553 <div class="variablelist"><table border="0">
 554 <col align="left" valign="top">
 555 <tbody>
 556 <tr>
 557 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 558 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 559 </td>
 560 </tr>
 561 <tr>
 562 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 563 <td>The number of times the profile is used in its parent
 564 container profile. If 0, it is not a mandatory stream.</td>
 565 </tr>
 566 </tbody>
 567 </table></div>
 568 <p class="since">Since 0.10.32</p>
 569 </div>
 570 <hr>
 571 <div class="refsect2">
 572 <a name="gst-encoding-profile-get-restriction"></a><h3>gst_encoding_profile_get_restriction ()</h3>
 573 <pre class="programlisting">const <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="returnvalue">GstCaps</span></a> *     gst_encoding_profile_get_restriction
 574                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre>
 575 <div class="variablelist"><table border="0">
 576 <col align="left" valign="top">
 577 <tbody>
 578 <tr>
 579 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 580 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 581 </td>
 582 </tr>
 583 <tr>
 584 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 585 <td>The restriction <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> to apply before the encoder
 586 that will be used in the profile. The fields present in restriction caps are
 587 properties of the raw stream (that is before encoding), such as height and
 588 width for video and depth and sampling rate for audio. Does not apply to
 589 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a> (since there is no corresponding raw stream).
 590 Can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
 591 </tr>
 592 </tbody>
 593 </table></div>
 594 <p class="since">Since 0.10.32</p>
 595 </div>
 596 <hr>
 597 <div class="refsect2">
 598 <a name="gst-encoding-profile-set-name"></a><h3>gst_encoding_profile_set_name ()</h3>
 599 <pre class="programlisting"><span class="returnvalue">void</span>                gst_encoding_profile_set_name       (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>,
 600                                                          <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> *name</code></em>);</pre>
 601 <p>
 602 Set <em class="parameter"><code>name</code></em> as the given name for the <em class="parameter"><code>profile</code></em>. A copy of <em class="parameter"><code>name</code></em> will be made
 603 internally.
 604 </p>
 605 <div class="variablelist"><table border="0">
 606 <col align="left" valign="top">
 607 <tbody>
 608 <tr>
 609 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 610 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 611 </td>
 612 </tr>
 613 <tr>
 614 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 615 <td>the name to set on the profile</td>
 616 </tr>
 617 </tbody>
 618 </table></div>
 619 <p class="since">Since 0.10.32</p>
 620 </div>
 621 <hr>
 622 <div class="refsect2">
 623 <a name="gst-encoding-profile-set-description"></a><h3>gst_encoding_profile_set_description ()</h3>
 624 <pre class="programlisting"><span class="returnvalue">void</span>                gst_encoding_profile_set_description
 625                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>,
 626                                                          <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> *description</code></em>);</pre>
 627 <p>
 628 Set <em class="parameter"><code>description</code></em> as the given description for the <em class="parameter"><code>profile</code></em>. A copy of <em class="parameter"><code>description</code></em> will be made
 629 internally.
 630 </p>
 631 <div class="variablelist"><table border="0">
 632 <col align="left" valign="top">
 633 <tbody>
 634 <tr>
 635 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 636 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 637 </td>
 638 </tr>
 639 <tr>
 640 <td><p><span class="term"><em class="parameter"><code>description</code></em> :</span></p></td>
 641 <td>the description to set on the profile</td>
 642 </tr>
 643 </tbody>
 644 </table></div>
 645 <p class="since">Since 0.10.32</p>
 646 </div>
 647 <hr>
 648 <div class="refsect2">
 649 <a name="gst-encoding-profile-set-format"></a><h3>gst_encoding_profile_set_format ()</h3>
 650 <pre class="programlisting"><span class="returnvalue">void</span>                gst_encoding_profile_set_format     (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>,
 651                                                          <em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> *format</code></em>);</pre>
 652 <p>
 653 Sets the media format used in the profile.
 654 </p>
 655 <div class="variablelist"><table border="0">
 656 <col align="left" valign="top">
 657 <tbody>
 658 <tr>
 659 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 660 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 661 </td>
 662 </tr>
 663 <tr>
 664 <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
 665 <td>the media format to use in the profile.</td>
 666 </tr>
 667 </tbody>
 668 </table></div>
 669 <p class="since">Since 0.10.32</p>
 670 </div>
 671 <hr>
 672 <div class="refsect2">
 673 <a name="gst-encoding-profile-set-preset"></a><h3>gst_encoding_profile_set_preset ()</h3>
 674 <pre class="programlisting"><span class="returnvalue">void</span>                gst_encoding_profile_set_preset     (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>,
 675                                                          <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> *preset</code></em>);</pre>
 676 <p>
 677 Sets the preset to use for the profile.
 678 </p>
 679 <div class="variablelist"><table border="0">
 680 <col align="left" valign="top">
 681 <tbody>
 682 <tr>
 683 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 684 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 685 </td>
 686 </tr>
 687 <tr>
 688 <td><p><span class="term"><em class="parameter"><code>preset</code></em> :</span></p></td>
 689 <td>the element preset to use</td>
 690 </tr>
 691 </tbody>
 692 </table></div>
 693 <p class="since">Since 0.10.32</p>
 694 </div>
 695 <hr>
 696 <div class="refsect2">
 697 <a name="gst-encoding-profile-set-restriction"></a><h3>gst_encoding_profile_set_restriction ()</h3>
 698 <pre class="programlisting"><span class="returnvalue">void</span>                gst_encoding_profile_set_restriction
 699                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>,
 700                                                          <em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> *restriction</code></em>);</pre>
 701 <p>
 702 Set the restriction <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> to apply before the encoder
 703 that will be used in the profile. See <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-set-restriction" title="gst_encoding_profile_set_restriction ()"><code class="function">gst_encoding_profile_set_restriction()</code></a>
 704 for more about restrictions. Does not apply to <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a>.
 705 </p>
 706 <div class="variablelist"><table border="0">
 707 <col align="left" valign="top">
 708 <tbody>
 709 <tr>
 710 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 711 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 712 </td>
 713 </tr>
 714 <tr>
 715 <td><p><span class="term"><em class="parameter"><code>restriction</code></em> :</span></p></td>
 716 <td>the restriction to apply</td>
 717 </tr>
 718 </tbody>
 719 </table></div>
 720 <p class="since">Since 0.10.32</p>
 721 </div>
 722 <hr>
 723 <div class="refsect2">
 724 <a name="gst-encoding-profile-set-presence"></a><h3>gst_encoding_profile_set_presence ()</h3>
 725 <pre class="programlisting"><span class="returnvalue">void</span>                gst_encoding_profile_set_presence   (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>,
 726                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> presence</code></em>);</pre>
 727 <p>
 728 Set the number of time the profile is used in its parent
 729 container profile. If 0, it is not a mandatory stream
 730 </p>
 731 <div class="variablelist"><table border="0">
 732 <col align="left" valign="top">
 733 <tbody>
 734 <tr>
 735 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 736 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 737 </td>
 738 </tr>
 739 <tr>
 740 <td><p><span class="term"><em class="parameter"><code>presence</code></em> :</span></p></td>
 741 <td>the number of time the profile can be used</td>
 742 </tr>
 743 </tbody>
 744 </table></div>
 745 <p class="since">Since 0.10.32</p>
 746 </div>
 747 <hr>
 748 <div class="refsect2">
 749 <a name="gst-encoding-profile-is-equal"></a><h3>gst_encoding_profile_is_equal ()</h3>
 750 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_encoding_profile_is_equal       (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *a</code></em>,
 751                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *b</code></em>);</pre>
 752 <p>
 753 Checks whether the two <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> are equal
 754 </p>
 755 <div class="variablelist"><table border="0">
 756 <col align="left" valign="top">
 757 <tbody>
 758 <tr>
 759 <td><p><span class="term"><em class="parameter"><code>a</code></em> :</span></p></td>
 760 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 761 </td>
 762 </tr>
 763 <tr>
 764 <td><p><span class="term"><em class="parameter"><code>b</code></em> :</span></p></td>
 765 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 766 </td>
 767 </tr>
 768 <tr>
 769 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 770 <td>
 771 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>a</code></em> and <em class="parameter"><code>b</code></em> are equal, else <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</td>
 772 </tr>
 773 </tbody>
 774 </table></div>
 775 <p class="since">Since 0.10.32</p>
 776 </div>
 777 <hr>
 778 <div class="refsect2">
 779 <a name="gst-encoding-profile-get-input-caps"></a><h3>gst_encoding_profile_get_input_caps ()</h3>
 780 <pre class="programlisting"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="returnvalue">GstCaps</span></a> *           gst_encoding_profile_get_input_caps (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre>
 781 <p>
 782 Computes the full output caps that this <em class="parameter"><code>profile</code></em> will be able to consume.
 783 </p>
 784 <div class="variablelist"><table border="0">
 785 <col align="left" valign="top">
 786 <tbody>
 787 <tr>
 788 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 789 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 790 </td>
 791 </tr>
 792 <tr>
 793 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 794 <td>The full caps the given <em class="parameter"><code>profile</code></em> can consume. Call <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#gst-caps-unref"><code class="function">gst_caps_unref()</code></a>
 795 when you are done with the caps.</td>
 796 </tr>
 797 </tbody>
 798 </table></div>
 799 <p class="since">Since 0.10.32</p>
 800 </div>
 801 <hr>
 802 <div class="refsect2">
 803 <a name="gst-encoding-profile-get-type-nick"></a><h3>gst_encoding_profile_get_type_nick ()</h3>
 804 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gst_encoding_profile_get_type_nick  (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre>
 805 <div class="variablelist"><table border="0">
 806 <col align="left" valign="top">
 807 <tbody>
 808 <tr>
 809 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 810 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 811 </td>
 812 </tr>
 813 <tr>
 814 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 815 <td>the human-readable name of the type of <em class="parameter"><code>profile</code></em>.</td>
 816 </tr>
 817 </tbody>
 818 </table></div>
 819 <p class="since">Since 0.10.32</p>
 820 </div>
 821 <hr>
 822 <div class="refsect2">
 823 <a name="GstEncodingContainerProfile-struct"></a><h3>GstEncodingContainerProfile</h3>
 824 <pre class="programlisting">typedef struct _GstEncodingContainerProfile GstEncodingContainerProfile;</pre>
 825 <p>
 826 Encoding profiles for containers. Keeps track of a list of <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 827 </p>
 828 <p class="since">Since 0.10.32</p>
 829 </div>
 830 <hr>
 831 <div class="refsect2">
 832 <a name="gst-encoding-container-profile-new"></a><h3>gst_encoding_container_profile_new ()</h3>
 833 <pre class="programlisting"><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingContainerProfile"><span class="returnvalue">GstEncodingContainerProfile</span></a> * gst_encoding_container_profile_new
 834                                                         (<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> *name</code></em>,
 835                                                          <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> *description</code></em>,
 836                                                          <em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> *format</code></em>,
 837                                                          <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> *preset</code></em>);</pre>
 838 <p>
 839 Creates a new <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a>.
 840 </p>
 841 <div class="variablelist"><table border="0">
 842 <col align="left" valign="top">
 843 <tbody>
 844 <tr>
 845 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 846 <td>The name of the container profile, can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 847 </td>
 848 </tr>
 849 <tr>
 850 <td><p><span class="term"><em class="parameter"><code>description</code></em> :</span></p></td>
 851 <td>The description of the container profile, can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 852 </td>
 853 </tr>
 854 <tr>
 855 <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
 856 <td>The format to use for this profile</td>
 857 </tr>
 858 <tr>
 859 <td><p><span class="term"><em class="parameter"><code>preset</code></em> :</span></p></td>
 860 <td>The preset to use for this profile</td>
 861 </tr>
 862 <tr>
 863 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 864 <td>The newly created <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a>.</td>
 865 </tr>
 866 </tbody>
 867 </table></div>
 868 <p class="since">Since 0.10.32</p>
 869 </div>
 870 <hr>
 871 <div class="refsect2">
 872 <a name="gst-encoding-container-profile-add-profile"></a><h3>gst_encoding_container_profile_add_profile ()</h3>
 873 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_encoding_container_profile_add_profile
 874                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a> *container</code></em>,
 875                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre>
 876 <p>
 877 Add a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> to the list of profiles handled by <em class="parameter"><code>container</code></em>.
 878 </p>
 879 <p>
 880 No copy of <em class="parameter"><code>profile</code></em> will be made, if you wish to use it elsewhere after this
 881 method you should increment its reference count.
 882 </p>
 883 <div class="variablelist"><table border="0">
 884 <col align="left" valign="top">
 885 <tbody>
 886 <tr>
 887 <td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
 888 <td>the <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a> to use</td>
 889 </tr>
 890 <tr>
 891 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 892 <td>the <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> to add.</td>
 893 </tr>
 894 <tr>
 895 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 896 <td>
 897 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>stream</code></em> was properly added, else <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</td>
 898 </tr>
 899 </tbody>
 900 </table></div>
 901 <p class="since">Since 0.10.32</p>
 902 </div>
 903 <hr>
 904 <div class="refsect2">
 905 <a name="gst-encoding-container-profile-contains-profile"></a><h3>gst_encoding_container_profile_contains_profile ()</h3>
 906 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_encoding_container_profile_contains_profile
 907                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a> *container</code></em>,
 908                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre>
 909 <p>
 910 Checks if <em class="parameter"><code>container</code></em> contains a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> identical to
 911 <em class="parameter"><code>profile</code></em>.
 912 </p>
 913 <div class="variablelist"><table border="0">
 914 <col align="left" valign="top">
 915 <tbody>
 916 <tr>
 917 <td><p><span class="term"><em class="parameter"><code>container</code></em> :</span></p></td>
 918 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a>
 919 </td>
 920 </tr>
 921 <tr>
 922 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
 923 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>
 924 </td>
 925 </tr>
 926 <tr>
 927 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 928 <td>
 929 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>container</code></em> contains a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> identical
 930 to <em class="parameter"><code>profile</code></em>, else <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</td>
 931 </tr>
 932 </tbody>
 933 </table></div>
 934 <p class="since">Since 0.10.32</p>
 935 </div>
 936 <hr>
 937 <div class="refsect2">
 938 <a name="gst-encoding-container-profile-get-profiles"></a><h3>gst_encoding_container_profile_get_profiles ()</h3>
 939 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *       gst_encoding_container_profile_get_profiles
 940                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a> *profile</code></em>);</pre>
 941 </div>
 942 <hr>
 943 <div class="refsect2">
 944 <a name="GstEncodingAudioProfile-struct"></a><h3>GstEncodingAudioProfile</h3>
 945 <pre class="programlisting">typedef struct _GstEncodingAudioProfile GstEncodingAudioProfile;</pre>
 946 <p>
 947 Variant of <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> for audio streams.
 948 </p>
 949 <p class="since">Since 0.10.32</p>
 950 </div>
 951 <hr>
 952 <div class="refsect2">
 953 <a name="gst-encoding-audio-profile-new"></a><h3>gst_encoding_audio_profile_new ()</h3>
 954 <pre class="programlisting"><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingAudioProfile"><span class="returnvalue">GstEncodingAudioProfile</span></a> * gst_encoding_audio_profile_new
 955                                                         (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> *format</code></em>,
 956                                                          <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> *preset</code></em>,
 957                                                          <em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> *restriction</code></em>,
 958                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> presence</code></em>);</pre>
 959 <p>
 960 Creates a new <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingAudioProfile"><span class="type">GstEncodingAudioProfile</span></a>
 961 </p>
 962 <p>
 963 All provided allocatable arguments will be internally copied, so can be
 964 safely freed/unreferenced after calling this method.
 965 </p>
 966 <div class="variablelist"><table border="0">
 967 <col align="left" valign="top">
 968 <tbody>
 969 <tr>
 970 <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
 971 <td>the <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a>
 972 </td>
 973 </tr>
 974 <tr>
 975 <td><p><span class="term"><em class="parameter"><code>preset</code></em> :</span></p></td>
 976 <td>the preset(s) to use on the encoder, can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>
 977 </td>
 978 </tr>
 979 <tr>
 980 <td><p><span class="term"><em class="parameter"><code>restriction</code></em> :</span></p></td>
 981 <td>the <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> used to restrict the input to the encoder, can be
 982 NULL. See <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-get-restriction" title="gst_encoding_profile_get_restriction ()"><code class="function">gst_encoding_profile_get_restriction()</code></a> for more details.</td>
 983 </tr>
 984 <tr>
 985 <td><p><span class="term"><em class="parameter"><code>presence</code></em> :</span></p></td>
 986 <td>the number of time this stream must be used. 0 means any number of
 987 times (including never)</td>
 988 </tr>
 989 <tr>
 990 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 991 <td>the newly created <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingAudioProfile"><span class="type">GstEncodingAudioProfile</span></a>.</td>
 992 </tr>
 993 </tbody>
 994 </table></div>
 995 <p class="since">Since 0.10.32</p>
 996 </div>
 997 <hr>
 998 <div class="refsect2">
 999 <a name="GstEncodingVideoProfile-struct"></a><h3>GstEncodingVideoProfile</h3>
1000 <pre class="programlisting">typedef struct _GstEncodingVideoProfile GstEncodingVideoProfile;</pre>
1001 <p>
1002 Variant of <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> for video streams, allows specifying the <em class="parameter"><code>pass</code></em>.
1003 </p>
1004 <p class="since">Since 0.10.32</p>
1005 </div>
1006 <hr>
1007 <div class="refsect2">
1008 <a name="gst-encoding-video-profile-new"></a><h3>gst_encoding_video_profile_new ()</h3>
1009 <pre class="programlisting"><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile"><span class="returnvalue">GstEncodingVideoProfile</span></a> * gst_encoding_video_profile_new
1010                                                         (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> *format</code></em>,
1011                                                          <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> *preset</code></em>,
1012                                                          <em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> *restriction</code></em>,
1013                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> presence</code></em>);</pre>
1014 <p>
1015 Creates a new <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a>
1016 </p>
1017 <p>
1018 All provided allocatable arguments will be internally copied, so can be
1019 safely freed/unreferenced after calling this method.
1020 </p>
1021 <p>
1022 If you wish to control the pass number (in case of multi-pass scenarios),
1023 please refer to the <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-video-profile-set-pass" title="gst_encoding_video_profile_set_pass ()"><code class="function">gst_encoding_video_profile_set_pass()</code></a> documentation.
1024 </p>
1025 <p>
1026 If you wish to use/force a constant framerate please refer to the
1027 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-video-profile-set-variableframerate" title="gst_encoding_video_profile_set_variableframerate ()"><code class="function">gst_encoding_video_profile_set_variableframerate()</code></a> documentation.
1028 </p>
1029 <div class="variablelist"><table border="0">
1030 <col align="left" valign="top">
1031 <tbody>
1032 <tr>
1033 <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
1034 <td>the <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a>
1035 </td>
1036 </tr>
1037 <tr>
1038 <td><p><span class="term"><em class="parameter"><code>preset</code></em> :</span></p></td>
1039 <td>the preset(s) to use on the encoder, can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>
1040 </td>
1041 </tr>
1042 <tr>
1043 <td><p><span class="term"><em class="parameter"><code>restriction</code></em> :</span></p></td>
1044 <td>the <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> used to restrict the input to the encoder, can be
1045 NULL. See <a class="link" href="gst-plugins-base-libs-encoding-profile.html#gst-encoding-profile-get-restriction" title="gst_encoding_profile_get_restriction ()"><code class="function">gst_encoding_profile_get_restriction()</code></a> for more details.</td>
1046 </tr>
1047 <tr>
1048 <td><p><span class="term"><em class="parameter"><code>presence</code></em> :</span></p></td>
1049 <td>the number of time this stream must be used. 0 means any number of
1050 times (including never)</td>
1051 </tr>
1052 <tr>
1053 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1054 <td>the newly created <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a>.</td>
1055 </tr>
1056 </tbody>
1057 </table></div>
1058 <p class="since">Since 0.10.32</p>
1059 </div>
1060 <hr>
1061 <div class="refsect2">
1062 <a name="gst-encoding-video-profile-get-pass"></a><h3>gst_encoding_video_profile_get_pass ()</h3>
1063 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gst_encoding_video_profile_get_pass (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a> *prof</code></em>);</pre>
1064 <div class="variablelist"><table border="0">
1065 <col align="left" valign="top">
1066 <tbody>
1067 <tr>
1068 <td><p><span class="term"><em class="parameter"><code>prof</code></em> :</span></p></td>
1069 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a>
1070 </td>
1071 </tr>
1072 <tr>
1073 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1074 <td>The pass number if this is part of a multi-pass profile. Starts at
1075 1 for multi-pass. 0 if this is not a multi-pass profile</td>
1076 </tr>
1077 </tbody>
1078 </table></div>
1079 <p class="since">Since 0.10.32</p>
1080 </div>
1081 <hr>
1082 <div class="refsect2">
1083 <a name="gst-encoding-video-profile-get-variableframerate"></a><h3>gst_encoding_video_profile_get_variableframerate ()</h3>
1084 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_encoding_video_profile_get_variableframerate
1085                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a> *prof</code></em>);</pre>
1086 <div class="variablelist"><table border="0">
1087 <col align="left" valign="top">
1088 <tbody>
1089 <tr>
1090 <td><p><span class="term"><em class="parameter"><code>prof</code></em> :</span></p></td>
1091 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a>
1092 </td>
1093 </tr>
1094 <tr>
1095 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1096 <td>Whether non-constant video framerate is allowed for encoding.</td>
1097 </tr>
1098 </tbody>
1099 </table></div>
1100 <p class="since">Since 0.10.32</p>
1101 </div>
1102 <hr>
1103 <div class="refsect2">
1104 <a name="gst-encoding-video-profile-set-pass"></a><h3>gst_encoding_video_profile_set_pass ()</h3>
1105 <pre class="programlisting"><span class="returnvalue">void</span>                gst_encoding_video_profile_set_pass (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a> *prof</code></em>,
1106                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> pass</code></em>);</pre>
1107 <p>
1108 Sets the pass number of this video profile. The first pass profile should have
1109 this value set to 1. If this video profile isn't part of a multi-pass profile,
1110 you may set it to 0 (the default value).
1111 </p>
1112 <div class="variablelist"><table border="0">
1113 <col align="left" valign="top">
1114 <tbody>
1115 <tr>
1116 <td><p><span class="term"><em class="parameter"><code>prof</code></em> :</span></p></td>
1117 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a>
1118 </td>
1119 </tr>
1120 <tr>
1121 <td><p><span class="term"><em class="parameter"><code>pass</code></em> :</span></p></td>
1122 <td>the pass number for this profile</td>
1123 </tr>
1124 </tbody>
1125 </table></div>
1126 <p class="since">Since 0.10.32</p>
1127 </div>
1128 <hr>
1129 <div class="refsect2">
1130 <a name="gst-encoding-video-profile-set-variableframerate"></a><h3>gst_encoding_video_profile_set_variableframerate ()</h3>
1131 <pre class="programlisting"><span class="returnvalue">void</span>                gst_encoding_video_profile_set_variableframerate
1132                                                         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a> *prof</code></em>,
1133                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> variableframerate</code></em>);</pre>
1134 <p>
1135 If set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then the incoming stream will be allowed to have non-constant
1136 framerate. If set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> (default value), then the incoming stream will
1137 be normalized by dropping/duplicating frames in order to produce a
1138 constance framerate.
1139 </p>
1140 <div class="variablelist"><table border="0">
1141 <col align="left" valign="top">
1142 <tbody>
1143 <tr>
1144 <td><p><span class="term"><em class="parameter"><code>prof</code></em> :</span></p></td>
1145 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a>
1146 </td>
1147 </tr>
1148 <tr>
1149 <td><p><span class="term"><em class="parameter"><code>variableframerate</code></em> :</span></p></td>
1150 <td>a boolean</td>
1151 </tr>
1152 </tbody>
1153 </table></div>
1154 <p class="since">Since 0.10.32</p>
1155 </div>
1156 <hr>
1157 <div class="refsect2">
1158 <a name="GST-ENCODING-CATEGORY-DEVICE:CAPS"></a><h3>GST_ENCODING_CATEGORY_DEVICE</h3>
1159 <pre class="programlisting">#define GST_ENCODING_CATEGORY_DEVICE                "device"
1160 </pre>
1161 <p>
1162 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> category for device-specific targets.
1163 The name of the target will usually be the constructor and model of the device,
1164 and that target will contain <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-libs/html/gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfiles</span></a> suitable for that device.
1165 </p>
1166 </div>
1167 <hr>
1168 <div class="refsect2">
1169 <a name="GST-ENCODING-CATEGORY-ONLINE-SERVICE:CAPS"></a><h3>GST_ENCODING_CATEGORY_ONLINE_SERVICE</h3>
1170 <pre class="programlisting">#define GST_ENCODING_CATEGORY_ONLINE_SERVICE "online-service"
1171 </pre>
1172 <p>
1173 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> category for online-services.
1174 The name of the target will usually be the name of the online service
1175 and that target will contain <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-libs/html/gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfiles</span></a> suitable for that online
1176 service.
1177 </p>
1178 </div>
1179 <hr>
1180 <div class="refsect2">
1181 <a name="GST-ENCODING-CATEGORY-STORAGE-EDITING:CAPS"></a><h3>GST_ENCODING_CATEGORY_STORAGE_EDITING</h3>
1182 <pre class="programlisting">#define GST_ENCODING_CATEGORY_STORAGE_EDITING   "storage-editing"
1183 </pre>
1184 <p>
1185 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> category for storage, archiving and editing targets.
1186 Those targets can be lossless and/or provide very fast random access content.
1187 The name of the target will usually be the container type or editing target,
1188 and that target will contain <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-libs/html/gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfiles</span></a> suitable for editing or
1189 storage.
1190 </p>
1191 </div>
1192 <hr>
1193 <div class="refsect2">
1194 <a name="GST-ENCODING-CATEGORY-CAPTURE:CAPS"></a><h3>GST_ENCODING_CATEGORY_CAPTURE</h3>
1195 <pre class="programlisting">#define GST_ENCODING_CATEGORY_CAPTURE               "capture"
1196 </pre>
1197 <p>
1198 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> category for recording and capture.
1199 Targets within this category are optimized for low latency encoding.
1200 </p>
1201 </div>
1202 <hr>
1203 <div class="refsect2">
1204 <a name="GstEncodingTarget-struct"></a><h3>GstEncodingTarget</h3>
1205 <pre class="programlisting">typedef struct _GstEncodingTarget GstEncodingTarget;</pre>
1206 <p>
1207 Collection of <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> for a specific target or use-case.
1208 </p>
1209 <p>
1210 When being stored/loaded, targets come from a specific category, like
1211 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GST-ENCODING-CATEGORY-DEVICE:CAPS" title="GST_ENCODING_CATEGORY_DEVICE"><span class="type">GST_ENCODING_CATEGORY_DEVICE</span></a>.
1212 </p>
1213 <p class="since">Since 0.10.32</p>
1214 </div>
1215 <hr>
1216 <div class="refsect2">
1217 <a name="gst-encoding-target-unref"></a><h3>gst_encoding_target_unref()</h3>
1218 <pre class="programlisting">#define             gst_encoding_target_unref(target)</pre>
1219 <p>
1220 Decreases the reference count of the <em class="parameter"><code>target</code></em>, possibly freeing it.
1221 </p>
1222 <div class="variablelist"><table border="0">
1223 <col align="left" valign="top">
1224 <tbody><tr>
1225 <td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
1226 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a>
1227 </td>
1228 </tr></tbody>
1229 </table></div>
1230 <p class="since">Since 0.10.32</p>
1231 </div>
1232 <hr>
1233 <div class="refsect2">
1234 <a name="gst-encoding-target-ref"></a><h3>gst_encoding_target_ref()</h3>
1235 <pre class="programlisting">#define             gst_encoding_target_ref(target)</pre>
1236 <p>
1237 Increases the reference count of the <em class="parameter"><code>target</code></em>.
1238 </p>
1239 <div class="variablelist"><table border="0">
1240 <col align="left" valign="top">
1241 <tbody><tr>
1242 <td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
1243 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a>
1244 </td>
1245 </tr></tbody>
1246 </table></div>
1247 <p class="since">Since 0.10.32</p>
1248 </div>
1249 <hr>
1250 <div class="refsect2">
1251 <a name="gst-encoding-target-new"></a><h3>gst_encoding_target_new ()</h3>
1252 <pre class="programlisting"><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="returnvalue">GstEncodingTarget</span></a> * gst_encoding_target_new             (<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> *name</code></em>,
1253                                                          <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> *category</code></em>,
1254                                                          <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> *description</code></em>,
1255                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *profiles</code></em>);</pre>
1256 <p>
1257 Creates a new <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a>.
1258 </p>
1259 <p>
1260 The name and category can only consist of lowercase ASCII letters for the
1261 first character, followed by either lowercase ASCII letters, digits or
1262 hyphens ('-').
1263 </p>
1264 <p>
1265 The <em class="parameter"><code>category</code></em> <span class="emphasis"><em>should</em></span> be one of the existing
1266 well-defined categories, like <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GST-ENCODING-CATEGORY-DEVICE:CAPS" title="GST_ENCODING_CATEGORY_DEVICE"><span class="type">GST_ENCODING_CATEGORY_DEVICE</span></a>, but it
1267 <span class="emphasis"><em>can</em></span> be a application or user specific category if
1268 needed.
1269 </p>
1270 <div class="variablelist"><table border="0">
1271 <col align="left" valign="top">
1272 <tbody>
1273 <tr>
1274 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
1275 <td>The name of the target.</td>
1276 </tr>
1277 <tr>
1278 <td><p><span class="term"><em class="parameter"><code>category</code></em> :</span></p></td>
1279 <td>The name of the category to which this <em class="parameter"><code>target</code></em>
1280 belongs. For example: <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GST-ENCODING-CATEGORY-DEVICE:CAPS" title="GST_ENCODING_CATEGORY_DEVICE"><span class="type">GST_ENCODING_CATEGORY_DEVICE</span></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1281 </td>
1282 </tr>
1283 <tr>
1284 <td><p><span class="term"><em class="parameter"><code>description</code></em> :</span></p></td>
1285 <td>A description of <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> in the
1286 current locale. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1287 </td>
1288 </tr>
1289 <tr>
1290 <td><p><span class="term"><em class="parameter"><code>profiles</code></em> :</span></p></td>
1291 <td>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of
1292 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Gst.EncodingProfile]</span>
1293 </td>
1294 </tr>
1295 <tr>
1296 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1297 <td>The newly created <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
1298 there was an error. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1299 </td>
1300 </tr>
1301 </tbody>
1302 </table></div>
1303 <p class="since">Since 0.10.32</p>
1304 </div>
1305 <hr>
1306 <div class="refsect2">
1307 <a name="gst-encoding-target-get-name"></a><h3>gst_encoding_target_get_name ()</h3>
1308 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gst_encoding_target_get_name        (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>);</pre>
1309 <div class="variablelist"><table border="0">
1310 <col align="left" valign="top">
1311 <tbody>
1312 <tr>
1313 <td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
1314 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a>
1315 </td>
1316 </tr>
1317 <tr>
1318 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1319 <td>The name of the <em class="parameter"><code>target</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1320 </td>
1321 </tr>
1322 </tbody>
1323 </table></div>
1324 <p class="since">Since 0.10.32</p>
1325 </div>
1326 <hr>
1327 <div class="refsect2">
1328 <a name="gst-encoding-target-get-category"></a><h3>gst_encoding_target_get_category ()</h3>
1329 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gst_encoding_target_get_category    (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>);</pre>
1330 <div class="variablelist"><table border="0">
1331 <col align="left" valign="top">
1332 <tbody>
1333 <tr>
1334 <td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
1335 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a>
1336 </td>
1337 </tr>
1338 <tr>
1339 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1340 <td>The category of the <em class="parameter"><code>target</code></em>. For example:
1341 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GST-ENCODING-CATEGORY-DEVICE:CAPS" title="GST_ENCODING_CATEGORY_DEVICE"><span class="type">GST_ENCODING_CATEGORY_DEVICE</span></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1342 </td>
1343 </tr>
1344 </tbody>
1345 </table></div>
1346 <p class="since">Since 0.10.32</p>
1347 </div>
1348 <hr>
1349 <div class="refsect2">
1350 <a name="gst-encoding-target-get-description"></a><h3>gst_encoding_target_get_description ()</h3>
1351 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gst_encoding_target_get_description (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>);</pre>
1352 <div class="variablelist"><table border="0">
1353 <col align="left" valign="top">
1354 <tbody>
1355 <tr>
1356 <td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
1357 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a>
1358 </td>
1359 </tr>
1360 <tr>
1361 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1362 <td>The description of the <em class="parameter"><code>target</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1363 </td>
1364 </tr>
1365 </tbody>
1366 </table></div>
1367 <p class="since">Since 0.10.32</p>
1368 </div>
1369 <hr>
1370 <div class="refsect2">
1371 <a name="gst-encoding-target-get-profiles"></a><h3>gst_encoding_target_get_profiles ()</h3>
1372 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *       gst_encoding_target_get_profiles    (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>);</pre>
1373 <div class="variablelist"><table border="0">
1374 <col align="left" valign="top">
1375 <tbody>
1376 <tr>
1377 <td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
1378 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a>
1379 </td>
1380 </tr>
1381 <tr>
1382 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1383 <td>A list of
1384 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>(s) this <em class="parameter"><code>target</code></em> handles. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Gst.EncodingProfile]</span>
1385 </td>
1386 </tr>
1387 </tbody>
1388 </table></div>
1389 <p class="since">Since 0.10.32</p>
1390 </div>
1391 <hr>
1392 <div class="refsect2">
1393 <a name="gst-encoding-target-get-profile"></a><h3>gst_encoding_target_get_profile ()</h3>
1394 <pre class="programlisting"><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="returnvalue">GstEncodingProfile</span></a> * gst_encoding_target_get_profile    (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>,
1395                                                          <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> *name</code></em>);</pre>
1396 <div class="variablelist"><table border="0">
1397 <col align="left" valign="top">
1398 <tbody>
1399 <tr>
1400 <td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
1401 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a>
1402 </td>
1403 </tr>
1404 <tr>
1405 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
1406 <td>the name of the profile to retrieve</td>
1407 </tr>
1408 <tr>
1409 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1410 <td>The matching <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1411 </td>
1412 </tr>
1413 </tbody>
1414 </table></div>
1415 <p class="since">Since 0.10.32</p>
1416 </div>
1417 <hr>
1418 <div class="refsect2">
1419 <a name="gst-encoding-target-add-profile"></a><h3>gst_encoding_target_add_profile ()</h3>
1420 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_encoding_target_add_profile     (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>,
1421                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre>
1422 <p>
1423 Adds the given <em class="parameter"><code>profile</code></em> to the <em class="parameter"><code>target</code></em>. Each added profile must have
1424 a unique name within the profile.
1425 </p>
1426 <p>
1427 The <em class="parameter"><code>target</code></em> will steal a reference to the <em class="parameter"><code>profile</code></em>. If you wish to use
1428 the profile after calling this method, you should increase its reference
1429 count.
1430 </p>
1431 <div class="variablelist"><table border="0">
1432 <col align="left" valign="top">
1433 <tbody>
1434 <tr>
1435 <td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
1436 <td>the <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> to add a profile to</td>
1437 </tr>
1438 <tr>
1439 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
1440 <td>the <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> to add. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1441 </td>
1442 </tr>
1443 <tr>
1444 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1445 <td>
1446 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the profile was added, else <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</td>
1447 </tr>
1448 </tbody>
1449 </table></div>
1450 <p class="since">Since 0.10.32</p>
1451 </div>
1452 <hr>
1453 <div class="refsect2">
1454 <a name="gst-encoding-target-save"></a><h3>gst_encoding_target_save ()</h3>
1455 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_encoding_target_save            (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>,
1456                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1457 <p>
1458 Saves the <em class="parameter"><code>target</code></em> to a default user-local directory.
1459 </p>
1460 <div class="variablelist"><table border="0">
1461 <col align="left" valign="top">
1462 <tbody>
1463 <tr>
1464 <td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
1465 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a>
1466 </td>
1467 </tr>
1468 <tr>
1469 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1470 <td>If an error occured, this field will be filled in.</td>
1471 </tr>
1472 <tr>
1473 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1474 <td>
1475 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the target was correctly saved, else <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</td>
1476 </tr>
1477 </tbody>
1478 </table></div>
1479 <p class="since">Since 0.10.32</p>
1480 </div>
1481 <hr>
1482 <div class="refsect2">
1483 <a name="gst-encoding-target-save-to-file"></a><h3>gst_encoding_target_save_to_file ()</h3>
1484 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_encoding_target_save_to_file    (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>,
1485                                                          <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> *filepath</code></em>,
1486                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1487 <p>
1488 Saves the <em class="parameter"><code>target</code></em> to the provided file location.
1489 </p>
1490 <div class="variablelist"><table border="0">
1491 <col align="left" valign="top">
1492 <tbody>
1493 <tr>
1494 <td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
1495 <td>a <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a>
1496 </td>
1497 </tr>
1498 <tr>
1499 <td><p><span class="term"><em class="parameter"><code>filepath</code></em> :</span></p></td>
1500 <td>the location to store the <em class="parameter"><code>target</code></em> at.</td>
1501 </tr>
1502 <tr>
1503 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1504 <td>If an error occured, this field will be filled in.</td>
1505 </tr>
1506 <tr>
1507 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1508 <td>
1509 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the target was correctly saved, else <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</td>
1510 </tr>
1511 </tbody>
1512 </table></div>
1513 <p class="since">Since 0.10.32</p>
1514 </div>
1515 <hr>
1516 <div class="refsect2">
1517 <a name="gst-encoding-target-load"></a><h3>gst_encoding_target_load ()</h3>
1518 <pre class="programlisting"><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="returnvalue">GstEncodingTarget</span></a> * gst_encoding_target_load            (<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> *name</code></em>,
1519                                                          <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> *category</code></em>,
1520                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1521 <p>
1522 Searches for the <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> with the given name, loads it
1523 and returns it.
1524 </p>
1525 <p>
1526 If the category name is specified only targets from that category will be
1527 searched for.
1528 </p>
1529 <div class="variablelist"><table border="0">
1530 <col align="left" valign="top">
1531 <tbody>
1532 <tr>
1533 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
1534 <td>the name of the <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> to load.</td>
1535 </tr>
1536 <tr>
1537 <td><p><span class="term"><em class="parameter"><code>category</code></em> :</span></p></td>
1538 <td>the name of the target category, like
1539 <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GST-ENCODING-CATEGORY-DEVICE:CAPS" title="GST_ENCODING_CATEGORY_DEVICE"><span class="type">GST_ENCODING_CATEGORY_DEVICE</span></a>. Can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1540 </td>
1541 </tr>
1542 <tr>
1543 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1544 <td>If an error occured, this field will be filled in.</td>
1545 </tr>
1546 <tr>
1547 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1548 <td>The <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> if available, else <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1549 </td>
1550 </tr>
1551 </tbody>
1552 </table></div>
1553 <p class="since">Since 0.10.32</p>
1554 </div>
1555 <hr>
1556 <div class="refsect2">
1557 <a name="gst-encoding-target-load-from-file"></a><h3>gst_encoding_target_load_from_file ()</h3>
1558 <pre class="programlisting"><a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="returnvalue">GstEncodingTarget</span></a> * gst_encoding_target_load_from_file  (<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> *filepath</code></em>,
1559                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1560 <p>
1561 Opens the provided file and returns the contained <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a>.
1562 </p>
1563 <div class="variablelist"><table border="0">
1564 <col align="left" valign="top">
1565 <tbody>
1566 <tr>
1567 <td><p><span class="term"><em class="parameter"><code>filepath</code></em> :</span></p></td>
1568 <td>The file location to load the <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> from</td>
1569 </tr>
1570 <tr>
1571 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1572 <td>If an error occured, this field will be filled in.</td>
1573 </tr>
1574 <tr>
1575 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1576 <td>The <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> contained in the file, else
1577 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1578 </td>
1579 </tr>
1580 </tbody>
1581 </table></div>
1582 <p class="since">Since 0.10.32</p>
1583 </div>
1584 <hr>
1585 <div class="refsect2">
1586 <a name="gst-encoding-list-all-targets"></a><h3>gst_encoding_list_all_targets ()</h3>
1587 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             gst_encoding_list_all_targets       (<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> *categoryname</code></em>);</pre>
1588 <p>
1589 List all available <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> for the specified category, or all categories
1590 if <em class="parameter"><code>categoryname</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
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>categoryname</code></em> :</span></p></td>
1597 <td>The category, for ex: <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GST-ENCODING-CATEGORY-DEVICE:CAPS" title="GST_ENCODING_CATEGORY_DEVICE"><span class="type">GST_ENCODING_CATEGORY_DEVICE</span></a>.
1598 Can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1599 </td>
1600 </tr>
1601 <tr>
1602 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1603 <td>The list of <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GstEncodingTarget]</span>
1604 </td>
1605 </tr>
1606 </tbody>
1607 </table></div>
1608 <p class="since">Since 0.10.32</p>
1609 </div>
1610 <hr>
1611 <div class="refsect2">
1612 <a name="gst-encoding-list-available-categories"></a><h3>gst_encoding_list_available_categories ()</h3>
1613 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             gst_encoding_list_available_categories
1614                                                         (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1615 <p>
1616 Lists all <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> categories present on disk.
1617 </p>
1618 <div class="variablelist"><table border="0">
1619 <col align="left" valign="top">
1620 <tbody><tr>
1621 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1622 <td>A list
1623 of <a class="link" href="gst-plugins-base-libs-encoding-profile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> categories. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> gchar*]</span>
1624 </td>
1625 </tr></tbody>
1626 </table></div>
1627 <p class="since">Since 0.10.32</p>
1628 </div>
1629 </div>
1630 </div>
1631 <div class="footer">
1632 <hr>
1633           Generated by GTK-Doc V1.18</div>
1634 </body>
1635 </html>