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>GstEncodingProfile: GStreamer Base Plugins 1.0 Library Reference Manual</title> 6<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> 7<link rel="home" href="index.html" title="GStreamer Base Plugins 1.0 Library Reference Manual"> 8<link rel="up" href="gstreamer-base-utils.html" title="Base Utils Library"> 9<link rel="prev" href="GstDiscoverer.html" title="GstDiscoverer"> 10<link rel="next" href="GstAudioVisualizer.html" title="GstAudioVisualizer"> 11<meta name="generator" content="GTK-Doc V1.28 (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="5"><tr valign="middle"> 16<td width="100%" align="left" class="shortcuts"> 17<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 18 <a href="#GstEncodingProfile.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 19 <a href="#GstEncodingProfile.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties"> <span class="dim">|</span> 20 <a href="#GstEncodingProfile.properties" class="shortcut">Properties</a></span> 21</td> 22<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> 23<td><a accesskey="u" href="gstreamer-base-utils.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> 24<td><a accesskey="p" href="GstDiscoverer.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> 25<td><a accesskey="n" href="GstAudioVisualizer.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> 26</tr></table> 27<div class="refentry"> 28<a name="GstEncodingProfile"></a><div class="titlepage"></div> 29<div class="refnamediv"><table width="100%"><tr> 30<td valign="top"> 31<h2><span class="refentrytitle"><a name="GstEncodingProfile.top_of_page"></a>GstEncodingProfile</span></h2> 32<p>GstEncodingProfile — Encoding profile library</p> 33</td> 34<td class="gallery_image" valign="top" align="right"></td> 35</tr></table></div> 36<div class="refsect1"> 37<a name="GstEncodingProfile.functions"></a><h2>Functions</h2> 38<div class="informaltable"><table class="informaltable" width="100%" border="0"> 39<colgroup> 40<col width="150px" class="functions_return"> 41<col class="functions_name"> 42</colgroup> 43<tbody> 44<tr> 45<td class="define_keyword">#define</td> 46<td class="function_name"> 47<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-unref" title="gst_encoding_profile_unref()">gst_encoding_profile_unref</a><span class="c_punctuation">()</span> 48</td> 49</tr> 50<tr> 51<td class="define_keyword">#define</td> 52<td class="function_name"> 53<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-ref" title="gst_encoding_profile_ref()">gst_encoding_profile_ref</a><span class="c_punctuation">()</span> 54</td> 55</tr> 56<tr> 57<td class="function_type"> 58<a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="returnvalue">GstEncodingProfile</span></a> * 59</td> 60<td class="function_name"> 61<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-find" title="gst_encoding_profile_find ()">gst_encoding_profile_find</a> <span class="c_punctuation">()</span> 62</td> 63</tr> 64<tr> 65<td class="function_type"> 66<a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="returnvalue">GstEncodingProfile</span></a> * 67</td> 68<td class="function_name"> 69<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-from-discoverer" title="gst_encoding_profile_from_discoverer ()">gst_encoding_profile_from_discoverer</a> <span class="c_punctuation">()</span> 70</td> 71</tr> 72<tr> 73<td class="function_type">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 74</td> 75<td class="function_name"> 76<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-get-name" title="gst_encoding_profile_get_name ()">gst_encoding_profile_get_name</a> <span class="c_punctuation">()</span> 77</td> 78</tr> 79<tr> 80<td class="function_type">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 81</td> 82<td class="function_name"> 83<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-get-description" title="gst_encoding_profile_get_description ()">gst_encoding_profile_get_description</a> <span class="c_punctuation">()</span> 84</td> 85</tr> 86<tr> 87<td class="function_type"> 88<a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="returnvalue">GstCaps</span></a> * 89</td> 90<td class="function_name"> 91<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-get-format" title="gst_encoding_profile_get_format ()">gst_encoding_profile_get_format</a> <span class="c_punctuation">()</span> 92</td> 93</tr> 94<tr> 95<td class="function_type">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 96</td> 97<td class="function_name"> 98<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-get-preset" title="gst_encoding_profile_get_preset ()">gst_encoding_profile_get_preset</a> <span class="c_punctuation">()</span> 99</td> 100</tr> 101<tr> 102<td class="function_type">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 103</td> 104<td class="function_name"> 105<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-get-preset-name" title="gst_encoding_profile_get_preset_name ()">gst_encoding_profile_get_preset_name</a> <span class="c_punctuation">()</span> 106</td> 107</tr> 108<tr> 109<td class="function_type"> 110<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> 111</td> 112<td class="function_name"> 113<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-get-presence" title="gst_encoding_profile_get_presence ()">gst_encoding_profile_get_presence</a> <span class="c_punctuation">()</span> 114</td> 115</tr> 116<tr> 117<td class="function_type"> 118<a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="returnvalue">GstCaps</span></a> * 119</td> 120<td class="function_name"> 121<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-get-restriction" title="gst_encoding_profile_get_restriction ()">gst_encoding_profile_get_restriction</a> <span class="c_punctuation">()</span> 122</td> 123</tr> 124<tr> 125<td class="function_type">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 126</td> 127<td class="function_name"> 128<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-get-file-extension" title="gst_encoding_profile_get_file_extension ()">gst_encoding_profile_get_file_extension</a> <span class="c_punctuation">()</span> 129</td> 130</tr> 131<tr> 132<td class="function_type"> 133<span class="returnvalue">void</span> 134</td> 135<td class="function_name"> 136<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-set-name" title="gst_encoding_profile_set_name ()">gst_encoding_profile_set_name</a> <span class="c_punctuation">()</span> 137</td> 138</tr> 139<tr> 140<td class="function_type"> 141<span class="returnvalue">void</span> 142</td> 143<td class="function_name"> 144<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-set-description" title="gst_encoding_profile_set_description ()">gst_encoding_profile_set_description</a> <span class="c_punctuation">()</span> 145</td> 146</tr> 147<tr> 148<td class="function_type"> 149<span class="returnvalue">void</span> 150</td> 151<td class="function_name"> 152<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-set-enabled" title="gst_encoding_profile_set_enabled ()">gst_encoding_profile_set_enabled</a> <span class="c_punctuation">()</span> 153</td> 154</tr> 155<tr> 156<td class="function_type"> 157<span class="returnvalue">void</span> 158</td> 159<td class="function_name"> 160<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-set-format" title="gst_encoding_profile_set_format ()">gst_encoding_profile_set_format</a> <span class="c_punctuation">()</span> 161</td> 162</tr> 163<tr> 164<td class="function_type"> 165<span class="returnvalue">void</span> 166</td> 167<td class="function_name"> 168<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-set-preset" title="gst_encoding_profile_set_preset ()">gst_encoding_profile_set_preset</a> <span class="c_punctuation">()</span> 169</td> 170</tr> 171<tr> 172<td class="function_type"> 173<span class="returnvalue">void</span> 174</td> 175<td class="function_name"> 176<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-set-preset-name" title="gst_encoding_profile_set_preset_name ()">gst_encoding_profile_set_preset_name</a> <span class="c_punctuation">()</span> 177</td> 178</tr> 179<tr> 180<td class="function_type"> 181<span class="returnvalue">void</span> 182</td> 183<td class="function_name"> 184<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-set-restriction" title="gst_encoding_profile_set_restriction ()">gst_encoding_profile_set_restriction</a> <span class="c_punctuation">()</span> 185</td> 186</tr> 187<tr> 188<td class="function_type"> 189<span class="returnvalue">void</span> 190</td> 191<td class="function_name"> 192<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-set-presence" title="gst_encoding_profile_set_presence ()">gst_encoding_profile_set_presence</a> <span class="c_punctuation">()</span> 193</td> 194</tr> 195<tr> 196<td class="function_type"> 197<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 198</td> 199<td class="function_name"> 200<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-is-equal" title="gst_encoding_profile_is_equal ()">gst_encoding_profile_is_equal</a> <span class="c_punctuation">()</span> 201</td> 202</tr> 203<tr> 204<td class="function_type"> 205<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 206</td> 207<td class="function_name"> 208<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-is-enabled" title="gst_encoding_profile_is_enabled ()">gst_encoding_profile_is_enabled</a> <span class="c_punctuation">()</span> 209</td> 210</tr> 211<tr> 212<td class="function_type"> 213<a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="returnvalue">GstCaps</span></a> * 214</td> 215<td class="function_name"> 216<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-get-input-caps" title="gst_encoding_profile_get_input_caps ()">gst_encoding_profile_get_input_caps</a> <span class="c_punctuation">()</span> 217</td> 218</tr> 219<tr> 220<td class="function_type">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 221</td> 222<td class="function_name"> 223<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-get-type-nick" title="gst_encoding_profile_get_type_nick ()">gst_encoding_profile_get_type_nick</a> <span class="c_punctuation">()</span> 224</td> 225</tr> 226<tr> 227<td class="function_type"> 228<a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="returnvalue">GstEncodingProfile</span></a> * 229</td> 230<td class="function_name"> 231<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-copy" title="gst_encoding_profile_copy ()">gst_encoding_profile_copy</a> <span class="c_punctuation">()</span> 232</td> 233</tr> 234<tr> 235<td class="function_type"> 236<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 237</td> 238<td class="function_name"> 239<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-get-allow-dynamic-output" title="gst_encoding_profile_get_allow_dynamic_output ()">gst_encoding_profile_get_allow_dynamic_output</a> <span class="c_punctuation">()</span> 240</td> 241</tr> 242<tr> 243<td class="function_type"> 244<span class="returnvalue">void</span> 245</td> 246<td class="function_name"> 247<a class="link" href="GstEncodingProfile.html#gst-encoding-profile-set-allow-dynamic-output" title="gst_encoding_profile_set_allow_dynamic_output ()">gst_encoding_profile_set_allow_dynamic_output</a> <span class="c_punctuation">()</span> 248</td> 249</tr> 250<tr> 251<td class="function_type"> 252<a class="link" href="GstEncodingProfile.html#GstEncodingContainerProfile"><span class="returnvalue">GstEncodingContainerProfile</span></a> * 253</td> 254<td class="function_name"> 255<a class="link" href="GstEncodingProfile.html#gst-encoding-container-profile-new" title="gst_encoding_container_profile_new ()">gst_encoding_container_profile_new</a> <span class="c_punctuation">()</span> 256</td> 257</tr> 258<tr> 259<td class="function_type"> 260<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 261</td> 262<td class="function_name"> 263<a class="link" href="GstEncodingProfile.html#gst-encoding-container-profile-add-profile" title="gst_encoding_container_profile_add_profile ()">gst_encoding_container_profile_add_profile</a> <span class="c_punctuation">()</span> 264</td> 265</tr> 266<tr> 267<td class="function_type"> 268<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 269</td> 270<td class="function_name"> 271<a class="link" href="GstEncodingProfile.html#gst-encoding-container-profile-contains-profile" title="gst_encoding_container_profile_contains_profile ()">gst_encoding_container_profile_contains_profile</a> <span class="c_punctuation">()</span> 272</td> 273</tr> 274<tr> 275<td class="function_type">const <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * 276</td> 277<td class="function_name"> 278<a class="link" href="GstEncodingProfile.html#gst-encoding-container-profile-get-profiles" title="gst_encoding_container_profile_get_profiles ()">gst_encoding_container_profile_get_profiles</a> <span class="c_punctuation">()</span> 279</td> 280</tr> 281<tr> 282<td class="function_type"> 283<a class="link" href="GstEncodingProfile.html#GstEncodingAudioProfile"><span class="returnvalue">GstEncodingAudioProfile</span></a> * 284</td> 285<td class="function_name"> 286<a class="link" href="GstEncodingProfile.html#gst-encoding-audio-profile-new" title="gst_encoding_audio_profile_new ()">gst_encoding_audio_profile_new</a> <span class="c_punctuation">()</span> 287</td> 288</tr> 289<tr> 290<td class="function_type"> 291<a class="link" href="GstEncodingProfile.html#GstEncodingVideoProfile"><span class="returnvalue">GstEncodingVideoProfile</span></a> * 292</td> 293<td class="function_name"> 294<a class="link" href="GstEncodingProfile.html#gst-encoding-video-profile-new" title="gst_encoding_video_profile_new ()">gst_encoding_video_profile_new</a> <span class="c_punctuation">()</span> 295</td> 296</tr> 297<tr> 298<td class="function_type"> 299<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> 300</td> 301<td class="function_name"> 302<a class="link" href="GstEncodingProfile.html#gst-encoding-video-profile-get-pass" title="gst_encoding_video_profile_get_pass ()">gst_encoding_video_profile_get_pass</a> <span class="c_punctuation">()</span> 303</td> 304</tr> 305<tr> 306<td class="function_type"> 307<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 308</td> 309<td class="function_name"> 310<a class="link" href="GstEncodingProfile.html#gst-encoding-video-profile-get-variableframerate" title="gst_encoding_video_profile_get_variableframerate ()">gst_encoding_video_profile_get_variableframerate</a> <span class="c_punctuation">()</span> 311</td> 312</tr> 313<tr> 314<td class="function_type"> 315<span class="returnvalue">void</span> 316</td> 317<td class="function_name"> 318<a class="link" href="GstEncodingProfile.html#gst-encoding-video-profile-set-pass" title="gst_encoding_video_profile_set_pass ()">gst_encoding_video_profile_set_pass</a> <span class="c_punctuation">()</span> 319</td> 320</tr> 321<tr> 322<td class="function_type"> 323<span class="returnvalue">void</span> 324</td> 325<td class="function_name"> 326<a class="link" href="GstEncodingProfile.html#gst-encoding-video-profile-set-variableframerate" title="gst_encoding_video_profile_set_variableframerate ()">gst_encoding_video_profile_set_variableframerate</a> <span class="c_punctuation">()</span> 327</td> 328</tr> 329<tr> 330<td class="define_keyword">#define</td> 331<td class="function_name"> 332<a class="link" href="GstEncodingProfile.html#gst-encoding-target-unref" title="gst_encoding_target_unref()">gst_encoding_target_unref</a><span class="c_punctuation">()</span> 333</td> 334</tr> 335<tr> 336<td class="define_keyword">#define</td> 337<td class="function_name"> 338<a class="link" href="GstEncodingProfile.html#gst-encoding-target-ref" title="gst_encoding_target_ref()">gst_encoding_target_ref</a><span class="c_punctuation">()</span> 339</td> 340</tr> 341<tr> 342<td class="function_type"> 343<a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="returnvalue">GstEncodingTarget</span></a> * 344</td> 345<td class="function_name"> 346<a class="link" href="GstEncodingProfile.html#gst-encoding-target-new" title="gst_encoding_target_new ()">gst_encoding_target_new</a> <span class="c_punctuation">()</span> 347</td> 348</tr> 349<tr> 350<td class="function_type">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 351</td> 352<td class="function_name"> 353<a class="link" href="GstEncodingProfile.html#gst-encoding-target-get-name" title="gst_encoding_target_get_name ()">gst_encoding_target_get_name</a> <span class="c_punctuation">()</span> 354</td> 355</tr> 356<tr> 357<td class="function_type">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 358</td> 359<td class="function_name"> 360<a class="link" href="GstEncodingProfile.html#gst-encoding-target-get-category" title="gst_encoding_target_get_category ()">gst_encoding_target_get_category</a> <span class="c_punctuation">()</span> 361</td> 362</tr> 363<tr> 364<td class="function_type">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 365</td> 366<td class="function_name"> 367<a class="link" href="GstEncodingProfile.html#gst-encoding-target-get-description" title="gst_encoding_target_get_description ()">gst_encoding_target_get_description</a> <span class="c_punctuation">()</span> 368</td> 369</tr> 370<tr> 371<td class="function_type">const <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * 372</td> 373<td class="function_name"> 374<a class="link" href="GstEncodingProfile.html#gst-encoding-target-get-profiles" title="gst_encoding_target_get_profiles ()">gst_encoding_target_get_profiles</a> <span class="c_punctuation">()</span> 375</td> 376</tr> 377<tr> 378<td class="function_type"> 379<a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="returnvalue">GstEncodingProfile</span></a> * 380</td> 381<td class="function_name"> 382<a class="link" href="GstEncodingProfile.html#gst-encoding-target-get-profile" title="gst_encoding_target_get_profile ()">gst_encoding_target_get_profile</a> <span class="c_punctuation">()</span> 383</td> 384</tr> 385<tr> 386<td class="function_type"> 387<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 388</td> 389<td class="function_name"> 390<a class="link" href="GstEncodingProfile.html#gst-encoding-target-add-profile" title="gst_encoding_target_add_profile ()">gst_encoding_target_add_profile</a> <span class="c_punctuation">()</span> 391</td> 392</tr> 393<tr> 394<td class="function_type"> 395<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 396</td> 397<td class="function_name"> 398<a class="link" href="GstEncodingProfile.html#gst-encoding-target-save" title="gst_encoding_target_save ()">gst_encoding_target_save</a> <span class="c_punctuation">()</span> 399</td> 400</tr> 401<tr> 402<td class="function_type"> 403<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 404</td> 405<td class="function_name"> 406<a class="link" href="GstEncodingProfile.html#gst-encoding-target-save-to-file" title="gst_encoding_target_save_to_file ()">gst_encoding_target_save_to_file</a> <span class="c_punctuation">()</span> 407</td> 408</tr> 409<tr> 410<td class="function_type"> 411<a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="returnvalue">GstEncodingTarget</span></a> * 412</td> 413<td class="function_name"> 414<a class="link" href="GstEncodingProfile.html#gst-encoding-target-load" title="gst_encoding_target_load ()">gst_encoding_target_load</a> <span class="c_punctuation">()</span> 415</td> 416</tr> 417<tr> 418<td class="function_type"> 419<a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="returnvalue">GstEncodingTarget</span></a> * 420</td> 421<td class="function_name"> 422<a class="link" href="GstEncodingProfile.html#gst-encoding-target-load-from-file" title="gst_encoding_target_load_from_file ()">gst_encoding_target_load_from_file</a> <span class="c_punctuation">()</span> 423</td> 424</tr> 425<tr> 426<td class="function_type"> 427<a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * 428</td> 429<td class="function_name"> 430<a class="link" href="GstEncodingProfile.html#gst-encoding-list-all-targets" title="gst_encoding_list_all_targets ()">gst_encoding_list_all_targets</a> <span class="c_punctuation">()</span> 431</td> 432</tr> 433<tr> 434<td class="function_type"> 435<a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * 436</td> 437<td class="function_name"> 438<a class="link" href="GstEncodingProfile.html#gst-encoding-list-available-categories" title="gst_encoding_list_available_categories ()">gst_encoding_list_available_categories</a> <span class="c_punctuation">()</span> 439</td> 440</tr> 441</tbody> 442</table></div> 443</div> 444<div class="refsect1"> 445<a name="GstEncodingProfile.properties"></a><h2>Properties</h2> 446<div class="informaltable"><table class="informaltable" border="0"> 447<colgroup> 448<col width="150px" class="properties_type"> 449<col width="300px" class="properties_name"> 450<col width="200px" class="properties_flags"> 451</colgroup> 452<tbody><tr> 453<td class="property_type"> 454<a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> *</td> 455<td class="property_name"><a class="link" href="GstEncodingProfile.html#GstEncodingProfile--restriction-caps" title="The “restriction-caps” property">restriction-caps</a></td> 456<td class="property_flags">Read / Write</td> 457</tr></tbody> 458</table></div> 459</div> 460<a name="GstEncodingContainerProfile"></a><a name="GstEncodingAudioProfile"></a><a name="GstEncodingVideoProfile"></a><a name="GstEncodingTarget"></a><div class="refsect1"> 461<a name="GstEncodingProfile.other"></a><h2>Types and Values</h2> 462<div class="informaltable"><table class="informaltable" width="100%" border="0"> 463<colgroup> 464<col width="150px" class="name"> 465<col class="description"> 466</colgroup> 467<tbody> 468<tr> 469<td class="datatype_keyword"> </td> 470<td class="function_name"><a class="link" href="GstEncodingProfile.html#GstEncodingProfile-struct" title="GstEncodingProfile">GstEncodingProfile</a></td> 471</tr> 472<tr> 473<td class="datatype_keyword"> </td> 474<td class="function_name"><a class="link" href="GstEncodingProfile.html#GstEncodingContainerProfile-struct" title="GstEncodingContainerProfile">GstEncodingContainerProfile</a></td> 475</tr> 476<tr> 477<td class="datatype_keyword"> </td> 478<td class="function_name"><a class="link" href="GstEncodingProfile.html#GstEncodingAudioProfile-struct" title="GstEncodingAudioProfile">GstEncodingAudioProfile</a></td> 479</tr> 480<tr> 481<td class="datatype_keyword"> </td> 482<td class="function_name"><a class="link" href="GstEncodingProfile.html#GstEncodingVideoProfile-struct" title="GstEncodingVideoProfile">GstEncodingVideoProfile</a></td> 483</tr> 484<tr> 485<td class="define_keyword">#define</td> 486<td class="function_name"><a class="link" href="GstEncodingProfile.html#GST-ENCODING-CATEGORY-DEVICE:CAPS" title="GST_ENCODING_CATEGORY_DEVICE">GST_ENCODING_CATEGORY_DEVICE</a></td> 487</tr> 488<tr> 489<td class="define_keyword">#define</td> 490<td class="function_name"><a class="link" href="GstEncodingProfile.html#GST-ENCODING-CATEGORY-ONLINE-SERVICE:CAPS" title="GST_ENCODING_CATEGORY_ONLINE_SERVICE">GST_ENCODING_CATEGORY_ONLINE_SERVICE</a></td> 491</tr> 492<tr> 493<td class="define_keyword">#define</td> 494<td class="function_name"><a class="link" href="GstEncodingProfile.html#GST-ENCODING-CATEGORY-STORAGE-EDITING:CAPS" title="GST_ENCODING_CATEGORY_STORAGE_EDITING">GST_ENCODING_CATEGORY_STORAGE_EDITING</a></td> 495</tr> 496<tr> 497<td class="define_keyword">#define</td> 498<td class="function_name"><a class="link" href="GstEncodingProfile.html#GST-ENCODING-CATEGORY-CAPTURE:CAPS" title="GST_ENCODING_CATEGORY_CAPTURE">GST_ENCODING_CATEGORY_CAPTURE</a></td> 499</tr> 500<tr> 501<td class="define_keyword">#define</td> 502<td class="function_name"><a class="link" href="GstEncodingProfile.html#GST-ENCODING-CATEGORY-FILE-EXTENSION:CAPS" title="GST_ENCODING_CATEGORY_FILE_EXTENSION">GST_ENCODING_CATEGORY_FILE_EXTENSION</a></td> 503</tr> 504<tr> 505<td class="datatype_keyword"> </td> 506<td class="function_name"><a class="link" href="GstEncodingProfile.html#GstEncodingTarget-struct" title="GstEncodingTarget">GstEncodingTarget</a></td> 507</tr> 508</tbody> 509</table></div> 510</div> 511<div class="refsect1"> 512<a name="GstEncodingProfile.object-hierarchy"></a><h2>Object Hierarchy</h2> 513<pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a> 514 <span class="lineart">├──</span> GstEncodingProfile 515 <span class="lineart">│</span> <span class="lineart">├──</span> GstEncodingVideoProfile 516 <span class="lineart">│</span> <span class="lineart">├──</span> GstEncodingAudioProfile 517 <span class="lineart">│</span> <span class="lineart">╰──</span> GstEncodingContainerProfile 518 <span class="lineart">╰──</span> GstEncodingTarget 519</pre> 520</div> 521<div class="refsect1"> 522<a name="GstEncodingProfile.includes"></a><h2>Includes</h2> 523<pre class="synopsis">#include <gst/pbutils/pbutils.h> 524</pre> 525</div> 526<div class="refsect1"> 527<a name="GstEncodingProfile.description"></a><h2>Description</h2> 528<p>Functions to create and handle encoding profiles.</p> 529<p>Encoding profiles describe the media types and settings one wishes to use 530for an encoding process. The top-level profiles are commonly 531<a class="link" href="GstEncodingProfile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a>(s) (which contains a user-readable name and 532description along with which container format to use). These, in turn, 533reference one or more <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>(s) which indicate which encoding 534format should be used on each individual streams.</p> 535<p><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>(s) can be provided to the 'encodebin' element, which 536will take care of selecting and setting up the required elements to produce 537an output stream conforming to the specifications of the profile.</p> 538<p>Unlike other systems, the encoding profiles do not specify which <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstElement.html#GstElement-struct"><span class="type">GstElement</span></a> 539to use for the various encoding and muxing steps, but instead relies on 540specifying the format one wishes to use.</p> 541<p>Encoding profiles can be created at runtime by the application or loaded 542from (and saved to) file using the <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> API.</p> 543<div class="refsect2"> 544<a name="id-1.2.14.10.12.7"></a><h3>Defining a GstEncodingProfile as a string</h3> 545<div class="refsect3"> 546<a name="id-1.2.14.10.12.7.2"></a><h4>Serialized encoding profile formats</h4> 547</div> 548<div class="refsect3"> 549<a name="id-1.2.14.10.12.7.3"></a><h4>Using encoders and muxer element factory name:</h4> 550<div class="informalexample"> 551 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 552 <tbody> 553 <tr> 554 <td class="listing_lines" align="right"><pre>1</pre></td> 555 <td class="listing_code"><pre class="programlisting">muxer_factory_name<span class="gtkdoc opt">:</span>video_encoder_factory_name<span class="gtkdoc opt">:</span>audio_encoder_factory_name</pre></td> 556 </tr> 557 </tbody> 558 </table> 559</div> 560 561<p></p> 562<p>For example to encode a stream into a WebM container, with an OGG audio 563stream and a VP8 video stream, the serialized <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> looks 564like:</p> 565<div class="informalexample"> 566 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 567 <tbody> 568 <tr> 569 <td class="listing_lines" align="right"><pre>1</pre></td> 570 <td class="listing_code"><pre class="programlisting">webmmux<span class="gtkdoc opt">:</span>vp8enc<span class="gtkdoc opt">:</span>vorbisenc</pre></td> 571 </tr> 572 </tbody> 573 </table> 574</div> 575 576<p></p> 577</div> 578<div class="refsect3"> 579<a name="id-1.2.14.10.12.7.4"></a><h4>Define the encoding profile in a generic way using caps:</h4> 580<div class="informalexample"> 581 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 582 <tbody> 583 <tr> 584 <td class="listing_lines" align="right"><pre>1</pre></td> 585 <td class="listing_code"><pre class="programlisting">muxer_source_caps<span class="gtkdoc opt">:</span>video_encoder_source_caps<span class="gtkdoc opt">:</span>audio_encoder_source_caps</pre></td> 586 </tr> 587 </tbody> 588 </table> 589</div> 590 591<p></p> 592<p>For example to encode a stream into a WebM container, with an OGG audio 593stream and a VP8 video stream, the serialized <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> looks 594like:</p> 595<div class="informalexample"> 596 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 597 <tbody> 598 <tr> 599 <td class="listing_lines" align="right"><pre>1</pre></td> 600 <td class="listing_code"><pre class="programlisting">video<span class="gtkdoc opt">/</span>webm<span class="gtkdoc opt">:</span>video<span class="gtkdoc opt">/</span>x<span class="gtkdoc opt">-</span>vp8<span class="gtkdoc opt">:</span>audio<span class="gtkdoc opt">/</span>x<span class="gtkdoc opt">-</span>vorbis</pre></td> 601 </tr> 602 </tbody> 603 </table> 604</div> 605 606<p></p> 607<p>It is possible to mix caps and element type names so you can specify a specific 608video encoder while using caps for other encoders/muxer.</p> 609</div> 610<div class="refsect3"> 611<a name="id-1.2.14.10.12.7.5"></a><h4>Advanced encoding format serialization features:</h4> 612<p>You can also set the preset name of the encoding profile using the 613caps+preset_name syntax as in:</p> 614<div class="informalexample"> 615 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 616 <tbody> 617 <tr> 618 <td class="listing_lines" align="right"><pre>1</pre></td> 619 <td class="listing_code"><pre class="programlisting">video<span class="gtkdoc opt">/</span>webm<span class="gtkdoc opt">:</span>video<span class="gtkdoc opt">/</span>x<span class="gtkdoc opt">-</span>vp8<span class="gtkdoc opt">+</span>youtube<span class="gtkdoc opt">-</span>preset<span class="gtkdoc opt">:</span>audio<span class="gtkdoc opt">/</span>x<span class="gtkdoc opt">-</span>vorbis</pre></td> 620 </tr> 621 </tbody> 622 </table> 623</div> 624 625<p></p> 626<p>Moreover, you can set the <code class="literal">presence</code> property of an 627encoding profile using the <code class="literal">|presence</code> syntax as in:</p> 628<div class="informalexample"> 629 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 630 <tbody> 631 <tr> 632 <td class="listing_lines" align="right"><pre>1</pre></td> 633 <td class="listing_code"><pre class="programlisting">video<span class="gtkdoc opt">/</span>webm<span class="gtkdoc opt">:</span>video<span class="gtkdoc opt">/</span>x<span class="gtkdoc opt">-</span>vp8<span class="gtkdoc opt">|</span><span class="number">1</span><span class="gtkdoc opt">:</span>audio<span class="gtkdoc opt">/</span>x<span class="gtkdoc opt">-</span>vorbis</pre></td> 634 </tr> 635 </tbody> 636 </table> 637</div> 638 639<p></p> 640<p>This field allows specifies the maximum number of times a 641<a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> can be used inside an encodebin. If 0, it is not a 642mandatory stream and can be used as many times as necessary.</p> 643<p>You can also use the <code class="literal">restriction_caps->encoded_format_caps</code> syntax to 644specify the restriction caps to be set on a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p> 645<p>It corresponds to the restriction <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> to apply before the encoder that 646will be used in the profile. The fields present in restriction caps are 647properties of the raw stream (that is, before encoding), such as height and 648width for video and depth and sampling rate for audio. This property does 649not make sense for muxers. See <a class="link" href="GstEncodingProfile.html#gst-encoding-profile-get-restriction" title="gst_encoding_profile_get_restriction ()"><span class="type">gst_encoding_profile_get_restriction</span></a> for 650more details.</p> 651<p>To force a video stream to be encoded with a Full HD resolution (using WebM 652as the container format, VP8 as the video codec and Vorbis as the audio 653codec), you should use:</p> 654<div class="informalexample"> 655 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 656 <tbody> 657 <tr> 658 <td class="listing_lines" align="right"><pre>1</pre></td> 659 <td class="listing_code"><pre class="programlisting"><span class="string">"video/webm:video/x-raw,width=1920,height=1080->video/x-vp8:audio/x-vorbis"</span></pre></td> 660 </tr> 661 </tbody> 662 </table> 663</div> 664 665<p></p> 666<div class="blockquote"><blockquote class="blockquote"><p>NOTE: Make sure to enclose into quotes to avoid '>' to be reinterpreted by 667the shell.</p></blockquote></div> 668<p>In the case you are using encoder types, the following is also possible:</p> 669<div class="informalexample"> 670 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 671 <tbody> 672 <tr> 673 <td class="listing_lines" align="right"><pre>1</pre></td> 674 <td class="listing_code"><pre class="programlisting"><span class="string">"matroskamux:x264enc,width=1920,height=1080:audio/x-vorbis"</span></pre></td> 675 </tr> 676 </tbody> 677 </table> 678</div> 679 680<p></p> 681</div> 682<div class="refsect3"> 683<a name="id-1.2.14.10.12.7.6"></a><h4>Some serialized encoding formats examples:</h4> 684<p>MP3 audio and H264 in MP4:</p> 685<div class="informalexample"> 686 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 687 <tbody> 688 <tr> 689 <td class="listing_lines" align="right"><pre>1</pre></td> 690 <td class="listing_code"><pre class="programlisting">video<span class="gtkdoc opt">/</span>quicktime<span class="gtkdoc opt">,</span>variant<span class="gtkdoc opt">=</span>iso<span class="gtkdoc opt">:</span>video<span class="gtkdoc opt">/</span>x<span class="gtkdoc opt">-</span>h264<span class="gtkdoc opt">:</span>audio<span class="gtkdoc opt">/</span>mpeg<span class="gtkdoc opt">,</span>mpegversion<span class="gtkdoc opt">=</span><span class="number">1</span><span class="gtkdoc opt">,</span>layer<span class="gtkdoc opt">=</span><span class="number">3</span></pre></td> 691 </tr> 692 </tbody> 693 </table> 694</div> 695 696<p></p> 697<p>Vorbis and theora in OGG:</p> 698<div class="informalexample"> 699 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 700 <tbody> 701 <tr> 702 <td class="listing_lines" align="right"><pre>1</pre></td> 703 <td class="listing_code"><pre class="programlisting">application<span class="gtkdoc opt">/</span>ogg<span class="gtkdoc opt">:</span>video<span class="gtkdoc opt">/</span>x<span class="gtkdoc opt">-</span>theora<span class="gtkdoc opt">:</span>audio<span class="gtkdoc opt">/</span>x<span class="gtkdoc opt">-</span>vorbis</pre></td> 704 </tr> 705 </tbody> 706 </table> 707</div> 708 709<p></p> 710<p>AC3 and H264 in MPEG-TS:</p> 711<div class="informalexample"> 712 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 713 <tbody> 714 <tr> 715 <td class="listing_lines" align="right"><pre>1</pre></td> 716 <td class="listing_code"><pre class="programlisting">video<span class="gtkdoc opt">/</span>mpegts<span class="gtkdoc opt">:</span>video<span class="gtkdoc opt">/</span>x<span class="gtkdoc opt">-</span>h264<span class="gtkdoc opt">:</span>audio<span class="gtkdoc opt">/</span>x<span class="gtkdoc opt">-</span>ac3</pre></td> 717 </tr> 718 </tbody> 719 </table> 720</div> 721 722<p></p> 723</div> 724<div class="refsect3"> 725<a name="id-1.2.14.10.12.7.7"></a><h4>Loading a profile from encoding targets</h4> 726<p>Anywhere where you have to use a string to define a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>, 727you can use load it from a <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> using the following syntaxes:</p> 728<div class="informalexample"> 729 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 730 <tbody> 731 <tr> 732 <td class="listing_lines" align="right"><pre>1</pre></td> 733 <td class="listing_code"><pre class="programlisting">target_name<span class="gtkdoc opt">[/</span>profilename<span class="gtkdoc opt">/</span>category<span class="gtkdoc opt">]</span></pre></td> 734 </tr> 735 </tbody> 736 </table> 737</div> 738 739<p></p> 740<p>or</p> 741<div class="informalexample"> 742 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 743 <tbody> 744 <tr> 745 <td class="listing_lines" align="right"><pre>1</pre></td> 746 <td class="listing_code"><pre class="programlisting"><span class="gtkdoc opt">/</span>path<span class="gtkdoc opt">/</span>to<span class="gtkdoc opt">/</span>target<span class="gtkdoc opt">.</span>gep<span class="gtkdoc opt">:</span>profilename</pre></td> 747 </tr> 748 </tbody> 749 </table> 750</div> 751 752<p></p> 753</div> 754</div> 755<hr> 756<div class="refsect2"> 757<a name="id-1.2.14.10.12.8"></a><h3>Example: Creating a profile</h3> 758<div class="informalexample"> 759 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 760 <tbody> 761 <tr> 762 <td class="listing_lines" align="right"><pre>1 7632 7643 7654 7665 7676 7687 7698 7709 77110 77211 77312 77413 77514 77615 77716 77817 77918 78019 78120 78221 78322 78423 78524 78625 78726</pre></td> 788 <td class="listing_code"><pre class="programlisting"><span class="gtkdoc ppc">#include <gst/pbutils/encoding-profile.h></span> 789<span class="gtkdoc opt">...</span> 790GstEncodingProfile <span class="gtkdoc opt">*</span> 791<span class="function">create_ogg_theora_profile</span><span class="gtkdoc opt">(</span><span class="gtkdoc kwb">void</span><span class="gtkdoc opt">)</span> 792<span class="gtkdoc opt">{</span> 793 GstEncodingContainerProfile <span class="gtkdoc opt">*</span>prof<span class="gtkdoc opt">;</span> 794 GstCaps <span class="gtkdoc opt">*</span>caps<span class="gtkdoc opt">;</span> 795 796 caps <span class="gtkdoc opt">=</span> <span class="function"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#gst-caps-from-string">gst_caps_from_string</a></span><span class="gtkdoc opt">(</span><span class="string">"application/ogg"</span><span class="gtkdoc opt">);</span> 797 prof <span class="gtkdoc opt">=</span> <span class="function"><a href="GstEncodingProfile.html#gst-encoding-container-profile-new">gst_encoding_container_profile_new</a></span><span class="gtkdoc opt">(</span><span class="string">"Ogg audio/video"</span><span class="gtkdoc opt">,</span> 798 <span class="string">"Standard OGG/THEORA/VORBIS"</span><span class="gtkdoc opt">,</span> 799 caps<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">);</span> 800 <span class="function"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#gst-caps-unref">gst_caps_unref</a></span> <span class="gtkdoc opt">(</span>caps<span class="gtkdoc opt">);</span> 801 802 caps <span class="gtkdoc opt">=</span> <span class="function"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#gst-caps-from-string">gst_caps_from_string</a></span><span class="gtkdoc opt">(</span><span class="string">"video/x-theora"</span><span class="gtkdoc opt">);</span> 803 <span class="function"><a href="GstEncodingProfile.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> 804 <span class="gtkdoc opt">(</span>GstEncodingProfile<span class="gtkdoc opt">*)</span> <span class="function"><a href="GstEncodingProfile.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> 805 <span class="function"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#gst-caps-unref">gst_caps_unref</a></span> <span class="gtkdoc opt">(</span>caps<span class="gtkdoc opt">);</span> 806 807 caps <span class="gtkdoc opt">=</span> <span class="function"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#gst-caps-from-string">gst_caps_from_string</a></span><span class="gtkdoc opt">(</span><span class="string">"audio/x-vorbis"</span><span class="gtkdoc opt">);</span> 808 <span class="function"><a href="GstEncodingProfile.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> 809 <span class="gtkdoc opt">(</span>GstEncodingProfile<span class="gtkdoc opt">*)</span> <span class="function"><a href="GstEncodingProfile.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> 810 <span class="function"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#gst-caps-unref">gst_caps_unref</a></span> <span class="gtkdoc opt">(</span>caps<span class="gtkdoc opt">);</span> 811 812 <span class="keyword">return</span> <span class="gtkdoc opt">(</span>GstEncodingProfile<span class="gtkdoc opt">*)</span> prof<span class="gtkdoc opt">;</span> 813<span class="gtkdoc opt">}</span></pre></td> 814 </tr> 815 </tbody> 816 </table> 817</div> 818 819<p></p> 820</div> 821<hr> 822<div class="refsect2"> 823<a name="id-1.2.14.10.12.9"></a><h3>Example: Using an encoder preset with a profile</h3> 824<div class="informalexample"> 825 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 826 <tbody> 827 <tr> 828 <td class="listing_lines" align="right"><pre>1 8292 8303 8314 8325 8336 8347 8358 8369 83710 83811 83912 84013 84114 84215 84316 84417 84518 84619 84720 84821 84922 85023 85124 85225 85326 85427 85528 85629 85730 85831 85932 86033 86134 86235 86336</pre></td> 864 <td class="listing_code"><pre class="programlisting"><span class="gtkdoc ppc">#include <gst/pbutils/encoding-profile.h></span> 865<span class="gtkdoc opt">...</span> 866GstEncodingProfile <span class="gtkdoc opt">*</span> 867<span class="function">create_ogg_theora_profile</span><span class="gtkdoc opt">(</span><span class="gtkdoc kwb">void</span><span class="gtkdoc opt">)</span> 868<span class="gtkdoc opt">{</span> 869 GstEncodingVideoProfile <span class="gtkdoc opt">*</span>v<span class="gtkdoc opt">;</span> 870 GstEncodingAudioProfile <span class="gtkdoc opt">*</span>a<span class="gtkdoc opt">;</span> 871 GstEncodingContainerProfile <span class="gtkdoc opt">*</span>prof<span class="gtkdoc opt">;</span> 872 GstCaps <span class="gtkdoc opt">*</span>caps<span class="gtkdoc opt">;</span> 873 GstPreset <span class="gtkdoc opt">*</span>preset<span class="gtkdoc opt">;</span> 874 875 caps <span class="gtkdoc opt">=</span> <span class="function"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#gst-caps-from-string">gst_caps_from_string</a></span> <span class="gtkdoc opt">(</span><span class="string">"application/ogg"</span><span class="gtkdoc opt">);</span> 876 prof <span class="gtkdoc opt">=</span> <span class="function"><a href="GstEncodingProfile.html#gst-encoding-container-profile-new">gst_encoding_container_profile_new</a></span> <span class="gtkdoc opt">(</span><span class="string">"Ogg audio/video"</span><span class="gtkdoc opt">,</span> 877 <span class="string">"Standard OGG/THEORA/VORBIS"</span><span class="gtkdoc opt">,</span> 878 caps<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">);</span> 879 <span class="function"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#gst-caps-unref">gst_caps_unref</a></span> <span class="gtkdoc opt">(</span>caps<span class="gtkdoc opt">);</span> 880 881 preset <span class="gtkdoc opt">=</span> <span class="function">GST_PRESET</span> <span class="gtkdoc opt">(</span><span class="function"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstElementFactory.html#gst-element-factory-make">gst_element_factory_make</a></span> <span class="gtkdoc opt">(</span><span class="string">"theoraenc"</span><span class="gtkdoc opt">,</span> <span class="string">"theorapreset"</span><span class="gtkdoc opt">));</span> 882 <span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-set">g_object_set</a></span> <span class="gtkdoc opt">(</span>preset<span class="gtkdoc opt">,</span> <span class="string">"bitrate"</span><span class="gtkdoc opt">,</span> <span class="number">1000</span><span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">);</span> 883 <span class="gtkdoc slc">// The preset will be saved on the filesystem,</span> 884 <span class="gtkdoc slc">// so try to use a descriptive name</span> 885 <span class="function"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstPreset.html#gst-preset-save-preset">gst_preset_save_preset</a></span> <span class="gtkdoc opt">(</span>preset<span class="gtkdoc opt">,</span> <span class="string">"theora_bitrate_preset"</span><span class="gtkdoc opt">);</span> 886 <span class="function"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstObject.html#gst-object-unref">gst_object_unref</a></span> <span class="gtkdoc opt">(</span>preset<span class="gtkdoc opt">);</span> 887 888 caps <span class="gtkdoc opt">=</span> <span class="function"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#gst-caps-from-string">gst_caps_from_string</a></span> <span class="gtkdoc opt">(</span><span class="string">"video/x-theora"</span><span class="gtkdoc opt">);</span> 889 v <span class="gtkdoc opt">=</span> <span class="function"><a href="GstEncodingProfile.html#gst-encoding-video-profile-new">gst_encoding_video_profile_new</a></span> <span class="gtkdoc opt">(</span>caps<span class="gtkdoc opt">,</span> <span class="string">"theorapreset"</span><span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">,</span> <span class="number">0</span><span class="gtkdoc opt">);</span> 890 <span class="function"><a href="GstEncodingProfile.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>GstEncodingProfile<span class="gtkdoc opt">*)</span> v<span class="gtkdoc opt">);</span> 891 <span class="function"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#gst-caps-unref">gst_caps_unref</a></span> <span class="gtkdoc opt">(</span>caps<span class="gtkdoc opt">);</span> 892 893 caps <span class="gtkdoc opt">=</span> <span class="function"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#gst-caps-from-string">gst_caps_from_string</a></span> <span class="gtkdoc opt">(</span><span class="string">"audio/x-vorbis"</span><span class="gtkdoc opt">);</span> 894 a <span class="gtkdoc opt">=</span> <span class="function"><a href="GstEncodingProfile.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> 895 <span class="function"><a href="GstEncodingProfile.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>GstEncodingProfile<span class="gtkdoc opt">*)</span> a<span class="gtkdoc opt">);</span> 896 <span class="function"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#gst-caps-unref">gst_caps_unref</a></span> <span class="gtkdoc opt">(</span>caps<span class="gtkdoc opt">);</span> 897 898 <span class="keyword">return</span> <span class="gtkdoc opt">(</span>GstEncodingProfile<span class="gtkdoc opt">*)</span> prof<span class="gtkdoc opt">;</span> 899<span class="gtkdoc opt">}</span></pre></td> 900 </tr> 901 </tbody> 902 </table> 903</div> 904 905<p></p> 906</div> 907<hr> 908<div class="refsect2"> 909<a name="id-1.2.14.10.12.10"></a><h3>Example: Listing categories, targets and profiles</h3> 910<div class="informalexample"> 911 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 912 <tbody> 913 <tr> 914 <td class="listing_lines" align="right"><pre>1 9152 9163 9174 9185 9196 9207 9218 9229 92310 92411 92512 92613 92714 92815 92916 93017 93118 93219 93320 93421 93522 93623 93724 93825 93926 94027</pre></td> 941 <td class="listing_code"><pre class="programlisting"><span class="gtkdoc ppc">#include <gst/pbutils/encoding-profile.h></span> 942<span class="gtkdoc opt">...</span> 943GstEncodingProfile <span class="gtkdoc opt">*</span>prof<span class="gtkdoc opt">;</span> 944GList <span class="gtkdoc opt">*</span>categories<span class="gtkdoc opt">, *</span>tmpc<span class="gtkdoc opt">;</span> 945GList <span class="gtkdoc opt">*</span>targets<span class="gtkdoc opt">, *</span>tmpt<span class="gtkdoc opt">;</span> 946<span class="gtkdoc opt">...</span> 947categories <span class="gtkdoc opt">=</span> <span class="function"><a href="GstEncodingProfile.html#gst-encoding-list-available-categories">gst_encoding_list_available_categories</a></span> <span class="gtkdoc opt">();</span> 948 949<span class="gtkdoc opt">...</span> Show available categories to user <span class="gtkdoc opt">...</span> 950 951<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">-></span>next<span class="gtkdoc opt">) {</span> 952 gchar <span class="gtkdoc opt">*</span>category <span class="gtkdoc opt">= (</span>gchar <span class="gtkdoc opt">*)</span> tmpc<span class="gtkdoc opt">-></span>data<span class="gtkdoc opt">;</span> 953 954 <span class="gtkdoc opt">...</span> <span class="keyword">and</span> we can list all targets within that category <span class="gtkdoc opt">...</span> 955 956 targets <span class="gtkdoc opt">=</span> <span class="function"><a href="GstEncodingProfile.html#gst-encoding-list-all-targets">gst_encoding_list_all_targets</a></span> <span class="gtkdoc opt">(</span>category<span class="gtkdoc opt">);</span> 957 958 <span class="gtkdoc opt">...</span> <span class="keyword">and</span> show a list to our users <span class="gtkdoc opt">...</span> 959 960 <span class="function"><a href="/usr/share/gtk-doc/html/glib/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> 961 <span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#g-list-free">g_list_free</a></span> <span class="gtkdoc opt">(</span>targets<span class="gtkdoc opt">);</span> 962<span class="gtkdoc opt">}</span> 963 964<span class="function"><a href="/usr/share/gtk-doc/html/glib/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> 965<span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#g-list-free">g_list_free</a></span> <span class="gtkdoc opt">(</span>categories<span class="gtkdoc opt">);</span> 966 967<span class="gtkdoc opt">...</span></pre></td> 968 </tr> 969 </tbody> 970 </table> 971</div> 972 973<p></p> 974</div> 975<hr> 976<div class="refsect2"> 977<a name="id-1.2.14.10.12.11"></a><h3>Encoding Target</h3> 978<p>On top of the notion of profiles, we implement the notion of EncodingTarget. 979Encoding Targets are basically a higher level of abstraction to define formats 980for specific target types. Those can define several GstEncodingProfiles with 981different names, for example one for transcoding in full HD, another one for 982low res, etc.. which are defined in the same encoding target.</p> 983<p>Basically if you wan to encode a stream to send it to, say, youtube you should 984have a Youtube encoding target defined in the "online-service" category.</p> 985<div class="refsect3"> 986<a name="id-1.2.14.10.12.11.4"></a><h4>Encoding target serialization format</h4> 987<p>Encoding targets are serialized in a KeyFile like files.</p> 988<div class="informalexample"> 989 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 990 <tbody> 991 <tr> 992 <td class="listing_lines" align="right"><pre>1 9932 9943 9954 9965 9976 9987 9998 10009 100110 100211 100312 100413 100514 100615 100716 100817 100918 101019 101120</pre></td> 1012 <td class="listing_code"><pre class="programlisting"><span class="gtkdoc opt">[</span>GStreamer Encoding Target<span class="gtkdoc opt">]</span> 1013name <span class="gtkdoc opt">: <</span>name<span class="gtkdoc opt">></span> 1014category <span class="gtkdoc opt">: <</span>category<span class="gtkdoc opt">></span> 1015\description <span class="gtkdoc opt">: <</span>description<span class="gtkdoc opt">></span> <span class="gtkdoc ppc">#translatable</span> 1016 1017<span class="gtkdoc opt">[</span>profile<span class="gtkdoc opt">-<</span>profile1name<span class="gtkdoc opt">>]</span> 1018name <span class="gtkdoc opt">: <</span>name<span class="gtkdoc opt">></span> 1019\description <span class="gtkdoc opt">: <</span>description<span class="gtkdoc opt">></span> <span class="gtkdoc ppc">#optional</span> 1020format <span class="gtkdoc opt">: <</span>format<span class="gtkdoc opt">></span> 1021preset <span class="gtkdoc opt">: <</span>preset<span class="gtkdoc opt">></span> 1022 1023<span class="gtkdoc opt">[</span>streamprofile<span class="gtkdoc opt">-<</span>id<span class="gtkdoc opt">>]</span> 1024parent <span class="gtkdoc opt">: <</span>encodingprofile<span class="gtkdoc opt">.</span>name<span class="gtkdoc opt">>[,<</span>encodingprofile<span class="gtkdoc opt">.</span>name<span class="gtkdoc opt">>..]</span> 1025<span class="gtkdoc esc">\t</span>ype <span class="gtkdoc opt">: <</span>type<span class="gtkdoc opt">></span> <span class="gtkdoc ppc">#</span> <span class="gtkdoc pps">"audio"</span><span class="gtkdoc ppc">,</span> <span class="gtkdoc pps">"video"</span><span class="gtkdoc ppc">,</span> <span class="gtkdoc pps">"text"</span><span class="gtkdoc ppc"></span> 1026format <span class="gtkdoc opt">: <</span>format<span class="gtkdoc opt">></span> 1027preset <span class="gtkdoc opt">: <</span>preset<span class="gtkdoc opt">></span> 1028restriction <span class="gtkdoc opt">: <</span>restriction<span class="gtkdoc opt">></span> 1029presence <span class="gtkdoc opt">: <</span>presence<span class="gtkdoc opt">></span> 1030pass <span class="gtkdoc opt">: <</span>pass<span class="gtkdoc opt">></span> 1031variableframerate <span class="gtkdoc opt">: <</span>variableframerate<span class="gtkdoc opt">></span></pre></td> 1032 </tr> 1033 </tbody> 1034 </table> 1035</div> 1036 1037<p></p> 1038</div> 1039</div> 1040<hr> 1041<div class="refsect2"> 1042<a name="id-1.2.14.10.12.12"></a><h3>Location of encoding target files</h3> 1043<p>$GST_DATADIR/gstreamer-GST_API_VERSION/encoding-profile 1044$HOME/gstreamer-GST_API_VERSION/encoding-profile</p> 1045<p>There also is a GST_ENCODING_TARGET_PATH environment variable 1046defining a list of folder containing encoding target files.</p> 1047<div class="refsect3"> 1048<a name="id-1.2.14.10.12.12.4"></a><h4>Naming convention</h4> 1049<div class="informalexample"> 1050 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 1051 <tbody> 1052 <tr> 1053 <td class="listing_lines" align="right"><pre>1</pre></td> 1054 <td class="listing_code"><pre class="programlisting">$<span class="gtkdoc opt">(</span>target<span class="gtkdoc opt">.</span>category<span class="gtkdoc opt">)/</span>$<span class="gtkdoc opt">(</span>target<span class="gtkdoc opt">.</span>name<span class="gtkdoc opt">).</span>gep</pre></td> 1055 </tr> 1056 </tbody> 1057 </table> 1058</div> 1059 1060<p></p> 1061</div> 1062</div> 1063<hr> 1064<div class="refsect2"> 1065<a name="id-1.2.14.10.12.13"></a><h3>Naming restrictions:</h3> 1066<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 1067<li class="listitem"><p>lowercase ASCII letter for the first character</p></li> 1068<li class="listitem"><p>Same for all other characters + numerics + hyphens</p></li> 1069</ul></div> 1070</div> 1071</div> 1072<div class="refsect1"> 1073<a name="GstEncodingProfile.functions_details"></a><h2>Functions</h2> 1074<div class="refsect2"> 1075<a name="gst-encoding-profile-unref"></a><h3>gst_encoding_profile_unref()</h3> 1076<pre class="programlisting">#define gst_encoding_profile_unref(profile) (g_object_unref ((GObject*) profile)) 1077</pre> 1078<p>Decreases the reference count of the <em class="parameter"><code>profile</code></em> 1079, possibly freeing the <em class="parameter"><code>profile</code></em> 1080.</p> 1081<div class="refsect3"> 1082<a name="gst-encoding-profile-unref.parameters"></a><h4>Parameters</h4> 1083<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1084<colgroup> 1085<col width="150px" class="parameters_name"> 1086<col class="parameters_description"> 1087<col width="200px" class="parameters_annotations"> 1088</colgroup> 1089<tbody><tr> 1090<td class="parameter_name"><p>profile</p></td> 1091<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1092<td class="parameter_annotations"> </td> 1093</tr></tbody> 1094</table></div> 1095</div> 1096</div> 1097<hr> 1098<div class="refsect2"> 1099<a name="gst-encoding-profile-ref"></a><h3>gst_encoding_profile_ref()</h3> 1100<pre class="programlisting">#define gst_encoding_profile_ref(profile) (g_object_ref ((GObject*) profile)) 1101</pre> 1102<p>Increases the reference count of the <em class="parameter"><code>profile</code></em> 1103.</p> 1104<div class="refsect3"> 1105<a name="gst-encoding-profile-ref.parameters"></a><h4>Parameters</h4> 1106<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1107<colgroup> 1108<col width="150px" class="parameters_name"> 1109<col class="parameters_description"> 1110<col width="200px" class="parameters_annotations"> 1111</colgroup> 1112<tbody><tr> 1113<td class="parameter_name"><p>profile</p></td> 1114<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1115<td class="parameter_annotations"> </td> 1116</tr></tbody> 1117</table></div> 1118</div> 1119</div> 1120<hr> 1121<div class="refsect2"> 1122<a name="gst-encoding-profile-find"></a><h3>gst_encoding_profile_find ()</h3> 1123<pre class="programlisting"><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="returnvalue">GstEncodingProfile</span></a> * 1124gst_encoding_profile_find (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *targetname</code></em>, 1125 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *profilename</code></em>, 1126 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *category</code></em>);</pre> 1127<p>Find the <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> with the specified name and category.</p> 1128<div class="refsect3"> 1129<a name="gst-encoding-profile-find.parameters"></a><h4>Parameters</h4> 1130<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1131<colgroup> 1132<col width="150px" class="parameters_name"> 1133<col class="parameters_description"> 1134<col width="200px" class="parameters_annotations"> 1135</colgroup> 1136<tbody> 1137<tr> 1138<td class="parameter_name"><p>targetname</p></td> 1139<td class="parameter_description"><p>The name of the target. </p></td> 1140<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 1141</tr> 1142<tr> 1143<td class="parameter_name"><p>profilename</p></td> 1144<td class="parameter_description"><p>The name of the profile, if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> 1145provided, it will default to the encoding profile called <code class="literal">default</code>. </p></td> 1146<td class="parameter_annotations"><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></td> 1147</tr> 1148<tr> 1149<td class="parameter_name"><p>category</p></td> 1150<td class="parameter_description"><p>The target category. Can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 1151<td class="parameter_annotations"><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></td> 1152</tr> 1153</tbody> 1154</table></div> 1155</div> 1156<div class="refsect3"> 1157<a name="gst-encoding-profile-find.returns"></a><h4>Returns</h4> 1158<p>The matching <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p> 1159<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> 1160</div> 1161</div> 1162<hr> 1163<div class="refsect2"> 1164<a name="gst-encoding-profile-from-discoverer"></a><h3>gst_encoding_profile_from_discoverer ()</h3> 1165<pre class="programlisting"><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="returnvalue">GstEncodingProfile</span></a> * 1166gst_encoding_profile_from_discoverer (<em class="parameter"><code><a class="link" href="GstDiscoverer.html#GstDiscovererInfo"><span class="type">GstDiscovererInfo</span></a> *info</code></em>);</pre> 1167<p>Creates a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> matching the formats from the given 1168<a class="link" href="GstDiscoverer.html#GstDiscovererInfo"><span class="type">GstDiscovererInfo</span></a>. Streams other than audio or video (eg, 1169subtitles), are currently ignored.</p> 1170<div class="refsect3"> 1171<a name="gst-encoding-profile-from-discoverer.parameters"></a><h4>Parameters</h4> 1172<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1173<colgroup> 1174<col width="150px" class="parameters_name"> 1175<col class="parameters_description"> 1176<col width="200px" class="parameters_annotations"> 1177</colgroup> 1178<tbody><tr> 1179<td class="parameter_name"><p>info</p></td> 1180<td class="parameter_description"><p>The <a class="link" href="GstDiscoverer.html#GstDiscovererInfo"><span class="type">GstDiscovererInfo</span></a> to read from. </p></td> 1181<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 1182</tr></tbody> 1183</table></div> 1184</div> 1185<div class="refsect3"> 1186<a name="gst-encoding-profile-from-discoverer.returns"></a><h4>Returns</h4> 1187<p>The new <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p> 1188<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> 1189</div> 1190</div> 1191<hr> 1192<div class="refsect2"> 1193<a name="gst-encoding-profile-get-name"></a><h3>gst_encoding_profile_get_name ()</h3> 1194<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 1195gst_encoding_profile_get_name (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre> 1196<div class="refsect3"> 1197<a name="gst-encoding-profile-get-name.parameters"></a><h4>Parameters</h4> 1198<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1199<colgroup> 1200<col width="150px" class="parameters_name"> 1201<col class="parameters_description"> 1202<col width="200px" class="parameters_annotations"> 1203</colgroup> 1204<tbody><tr> 1205<td class="parameter_name"><p>profile</p></td> 1206<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1207<td class="parameter_annotations"> </td> 1208</tr></tbody> 1209</table></div> 1210</div> 1211<div class="refsect3"> 1212<a name="gst-encoding-profile-get-name.returns"></a><h4>Returns</h4> 1213<p> the name of the profile, can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p> 1214</div> 1215</div> 1216<hr> 1217<div class="refsect2"> 1218<a name="gst-encoding-profile-get-description"></a><h3>gst_encoding_profile_get_description ()</h3> 1219<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 1220gst_encoding_profile_get_description (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre> 1221<div class="refsect3"> 1222<a name="gst-encoding-profile-get-description.parameters"></a><h4>Parameters</h4> 1223<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1224<colgroup> 1225<col width="150px" class="parameters_name"> 1226<col class="parameters_description"> 1227<col width="200px" class="parameters_annotations"> 1228</colgroup> 1229<tbody><tr> 1230<td class="parameter_name"><p>profile</p></td> 1231<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1232<td class="parameter_annotations"> </td> 1233</tr></tbody> 1234</table></div> 1235</div> 1236<div class="refsect3"> 1237<a name="gst-encoding-profile-get-description.returns"></a><h4>Returns</h4> 1238<p> the description of the profile, can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p> 1239</div> 1240</div> 1241<hr> 1242<div class="refsect2"> 1243<a name="gst-encoding-profile-get-format"></a><h3>gst_encoding_profile_get_format ()</h3> 1244<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="returnvalue">GstCaps</span></a> * 1245gst_encoding_profile_get_format (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre> 1246<div class="refsect3"> 1247<a name="gst-encoding-profile-get-format.parameters"></a><h4>Parameters</h4> 1248<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1249<colgroup> 1250<col width="150px" class="parameters_name"> 1251<col class="parameters_description"> 1252<col width="200px" class="parameters_annotations"> 1253</colgroup> 1254<tbody><tr> 1255<td class="parameter_name"><p>profile</p></td> 1256<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1257<td class="parameter_annotations"> </td> 1258</tr></tbody> 1259</table></div> 1260</div> 1261<div class="refsect3"> 1262<a name="gst-encoding-profile-get-format.returns"></a><h4>Returns</h4> 1263<p>the <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> corresponding to the media format used 1264in the profile. Unref after usage. </p> 1265<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> 1266</div> 1267</div> 1268<hr> 1269<div class="refsect2"> 1270<a name="gst-encoding-profile-get-preset"></a><h3>gst_encoding_profile_get_preset ()</h3> 1271<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 1272gst_encoding_profile_get_preset (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre> 1273<div class="refsect3"> 1274<a name="gst-encoding-profile-get-preset.parameters"></a><h4>Parameters</h4> 1275<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1276<colgroup> 1277<col width="150px" class="parameters_name"> 1278<col class="parameters_description"> 1279<col width="200px" class="parameters_annotations"> 1280</colgroup> 1281<tbody><tr> 1282<td class="parameter_name"><p>profile</p></td> 1283<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1284<td class="parameter_annotations"> </td> 1285</tr></tbody> 1286</table></div> 1287</div> 1288<div class="refsect3"> 1289<a name="gst-encoding-profile-get-preset.returns"></a><h4>Returns</h4> 1290<p> the name of the <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstPreset.html#GstPreset-struct"><span class="type">GstPreset</span></a> to be used in the profile. 1291This is the name that has been set when saving the preset.</p> 1292</div> 1293</div> 1294<hr> 1295<div class="refsect2"> 1296<a name="gst-encoding-profile-get-preset-name"></a><h3>gst_encoding_profile_get_preset_name ()</h3> 1297<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 1298gst_encoding_profile_get_preset_name (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre> 1299<div class="refsect3"> 1300<a name="gst-encoding-profile-get-preset-name.parameters"></a><h4>Parameters</h4> 1301<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1302<colgroup> 1303<col width="150px" class="parameters_name"> 1304<col class="parameters_description"> 1305<col width="200px" class="parameters_annotations"> 1306</colgroup> 1307<tbody><tr> 1308<td class="parameter_name"><p>profile</p></td> 1309<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1310<td class="parameter_annotations"> </td> 1311</tr></tbody> 1312</table></div> 1313</div> 1314<div class="refsect3"> 1315<a name="gst-encoding-profile-get-preset-name.returns"></a><h4>Returns</h4> 1316<p> the name of the <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstPreset.html#GstPreset-struct"><span class="type">GstPreset</span></a> factory to be used in the profile.</p> 1317</div> 1318</div> 1319<hr> 1320<div class="refsect2"> 1321<a name="gst-encoding-profile-get-presence"></a><h3>gst_encoding_profile_get_presence ()</h3> 1322<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> 1323gst_encoding_profile_get_presence (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre> 1324<div class="refsect3"> 1325<a name="gst-encoding-profile-get-presence.parameters"></a><h4>Parameters</h4> 1326<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1327<colgroup> 1328<col width="150px" class="parameters_name"> 1329<col class="parameters_description"> 1330<col width="200px" class="parameters_annotations"> 1331</colgroup> 1332<tbody><tr> 1333<td class="parameter_name"><p>profile</p></td> 1334<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1335<td class="parameter_annotations"> </td> 1336</tr></tbody> 1337</table></div> 1338</div> 1339<div class="refsect3"> 1340<a name="gst-encoding-profile-get-presence.returns"></a><h4>Returns</h4> 1341<p> The number of times the profile is used in its parent 1342container profile. If 0, it is not a mandatory stream.</p> 1343</div> 1344</div> 1345<hr> 1346<div class="refsect2"> 1347<a name="gst-encoding-profile-get-restriction"></a><h3>gst_encoding_profile_get_restriction ()</h3> 1348<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="returnvalue">GstCaps</span></a> * 1349gst_encoding_profile_get_restriction (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre> 1350<div class="refsect3"> 1351<a name="gst-encoding-profile-get-restriction.parameters"></a><h4>Parameters</h4> 1352<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1353<colgroup> 1354<col width="150px" class="parameters_name"> 1355<col class="parameters_description"> 1356<col width="200px" class="parameters_annotations"> 1357</colgroup> 1358<tbody><tr> 1359<td class="parameter_name"><p>profile</p></td> 1360<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1361<td class="parameter_annotations"> </td> 1362</tr></tbody> 1363</table></div> 1364</div> 1365<div class="refsect3"> 1366<a name="gst-encoding-profile-get-restriction.returns"></a><h4>Returns</h4> 1367<p>The restriction <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> to apply before the encoder 1368that will be used in the profile. The fields present in restriction caps are 1369properties of the raw stream (that is before encoding), such as height and 1370width for video and depth and sampling rate for audio. Does not apply to 1371<a class="link" href="GstEncodingProfile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a> (since there is no corresponding raw stream). 1372Can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Unref after usage. </p> 1373<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> 1374</div> 1375</div> 1376<hr> 1377<div class="refsect2"> 1378<a name="gst-encoding-profile-get-file-extension"></a><h3>gst_encoding_profile_get_file_extension ()</h3> 1379<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 1380gst_encoding_profile_get_file_extension 1381 (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre> 1382<div class="refsect3"> 1383<a name="gst-encoding-profile-get-file-extension.parameters"></a><h4>Parameters</h4> 1384<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1385<colgroup> 1386<col width="150px" class="parameters_name"> 1387<col class="parameters_description"> 1388<col width="200px" class="parameters_annotations"> 1389</colgroup> 1390<tbody><tr> 1391<td class="parameter_name"><p>profile</p></td> 1392<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1393<td class="parameter_annotations"> </td> 1394</tr></tbody> 1395</table></div> 1396</div> 1397<div class="refsect3"> 1398<a name="gst-encoding-profile-get-file-extension.returns"></a><h4>Returns</h4> 1399<p> a suitable file extension for <em class="parameter"><code>profile</code></em> 1400, or NULL.</p> 1401</div> 1402</div> 1403<hr> 1404<div class="refsect2"> 1405<a name="gst-encoding-profile-set-name"></a><h3>gst_encoding_profile_set_name ()</h3> 1406<pre class="programlisting"><span class="returnvalue">void</span> 1407gst_encoding_profile_set_name (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>, 1408 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre> 1409<p>Set <em class="parameter"><code>name</code></em> 1410 as the given name for the <em class="parameter"><code>profile</code></em> 1411. A copy of <em class="parameter"><code>name</code></em> 1412 will be made 1413internally.</p> 1414<div class="refsect3"> 1415<a name="gst-encoding-profile-set-name.parameters"></a><h4>Parameters</h4> 1416<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1417<colgroup> 1418<col width="150px" class="parameters_name"> 1419<col class="parameters_description"> 1420<col width="200px" class="parameters_annotations"> 1421</colgroup> 1422<tbody> 1423<tr> 1424<td class="parameter_name"><p>profile</p></td> 1425<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1426<td class="parameter_annotations"> </td> 1427</tr> 1428<tr> 1429<td class="parameter_name"><p>name</p></td> 1430<td class="parameter_description"><p>the name to set on the profile. </p></td> 1431<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> 1432</tr> 1433</tbody> 1434</table></div> 1435</div> 1436</div> 1437<hr> 1438<div class="refsect2"> 1439<a name="gst-encoding-profile-set-description"></a><h3>gst_encoding_profile_set_description ()</h3> 1440<pre class="programlisting"><span class="returnvalue">void</span> 1441gst_encoding_profile_set_description (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>, 1442 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *description</code></em>);</pre> 1443<p>Set <em class="parameter"><code>description</code></em> 1444 as the given description for the <em class="parameter"><code>profile</code></em> 1445. A copy of 1446<em class="parameter"><code>description</code></em> 1447 will be made internally.</p> 1448<div class="refsect3"> 1449<a name="gst-encoding-profile-set-description.parameters"></a><h4>Parameters</h4> 1450<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1451<colgroup> 1452<col width="150px" class="parameters_name"> 1453<col class="parameters_description"> 1454<col width="200px" class="parameters_annotations"> 1455</colgroup> 1456<tbody> 1457<tr> 1458<td class="parameter_name"><p>profile</p></td> 1459<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1460<td class="parameter_annotations"> </td> 1461</tr> 1462<tr> 1463<td class="parameter_name"><p>description</p></td> 1464<td class="parameter_description"><p>the description to set on the profile. </p></td> 1465<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> 1466</tr> 1467</tbody> 1468</table></div> 1469</div> 1470</div> 1471<hr> 1472<div class="refsect2"> 1473<a name="gst-encoding-profile-set-enabled"></a><h3>gst_encoding_profile_set_enabled ()</h3> 1474<pre class="programlisting"><span class="returnvalue">void</span> 1475gst_encoding_profile_set_enabled (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>, 1476 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enabled</code></em>);</pre> 1477<p>Set whether the profile should be used or not.</p> 1478<div class="refsect3"> 1479<a name="gst-encoding-profile-set-enabled.parameters"></a><h4>Parameters</h4> 1480<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1481<colgroup> 1482<col width="150px" class="parameters_name"> 1483<col class="parameters_description"> 1484<col width="200px" class="parameters_annotations"> 1485</colgroup> 1486<tbody> 1487<tr> 1488<td class="parameter_name"><p>profile</p></td> 1489<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1490<td class="parameter_annotations"> </td> 1491</tr> 1492<tr> 1493<td class="parameter_name"><p>enabled</p></td> 1494<td class="parameter_description"><p><a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to disable <span class="type">profile</span>, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to enable it</p></td> 1495<td class="parameter_annotations"> </td> 1496</tr> 1497</tbody> 1498</table></div> 1499</div> 1500<p class="since">Since: <a class="link" href="ix10.html#api-index-1.6">1.6</a></p> 1501</div> 1502<hr> 1503<div class="refsect2"> 1504<a name="gst-encoding-profile-set-format"></a><h3>gst_encoding_profile_set_format ()</h3> 1505<pre class="programlisting"><span class="returnvalue">void</span> 1506gst_encoding_profile_set_format (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>, 1507 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> *format</code></em>);</pre> 1508<p>Sets the media format used in the profile.</p> 1509<div class="refsect3"> 1510<a name="gst-encoding-profile-set-format.parameters"></a><h4>Parameters</h4> 1511<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1512<colgroup> 1513<col width="150px" class="parameters_name"> 1514<col class="parameters_description"> 1515<col width="200px" class="parameters_annotations"> 1516</colgroup> 1517<tbody> 1518<tr> 1519<td class="parameter_name"><p>profile</p></td> 1520<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1521<td class="parameter_annotations"> </td> 1522</tr> 1523<tr> 1524<td class="parameter_name"><p>format</p></td> 1525<td class="parameter_description"><p>the media format to use in the profile. </p></td> 1526<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 1527</tr> 1528</tbody> 1529</table></div> 1530</div> 1531</div> 1532<hr> 1533<div class="refsect2"> 1534<a name="gst-encoding-profile-set-preset"></a><h3>gst_encoding_profile_set_preset ()</h3> 1535<pre class="programlisting"><span class="returnvalue">void</span> 1536gst_encoding_profile_set_preset (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>, 1537 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *preset</code></em>);</pre> 1538<p>Sets the name of the <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstElement.html#GstElement-struct"><span class="type">GstElement</span></a> that implements the <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstPreset.html#GstPreset-struct"><span class="type">GstPreset</span></a> interface 1539to use for the profile. 1540This is the name that has been set when saving the preset.</p> 1541<div class="refsect3"> 1542<a name="gst-encoding-profile-set-preset.parameters"></a><h4>Parameters</h4> 1543<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1544<colgroup> 1545<col width="150px" class="parameters_name"> 1546<col class="parameters_description"> 1547<col width="200px" class="parameters_annotations"> 1548</colgroup> 1549<tbody> 1550<tr> 1551<td class="parameter_name"><p>profile</p></td> 1552<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1553<td class="parameter_annotations"> </td> 1554</tr> 1555<tr> 1556<td class="parameter_name"><p>preset</p></td> 1557<td class="parameter_description"><p>the element preset to use. </p></td> 1558<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td> 1559</tr> 1560</tbody> 1561</table></div> 1562</div> 1563</div> 1564<hr> 1565<div class="refsect2"> 1566<a name="gst-encoding-profile-set-preset-name"></a><h3>gst_encoding_profile_set_preset_name ()</h3> 1567<pre class="programlisting"><span class="returnvalue">void</span> 1568gst_encoding_profile_set_preset_name (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>, 1569 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *preset_name</code></em>);</pre> 1570<p>Sets the name of the <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstPreset.html#GstPreset-struct"><span class="type">GstPreset</span></a>'s factory to be used in the profile.</p> 1571<div class="refsect3"> 1572<a name="gst-encoding-profile-set-preset-name.parameters"></a><h4>Parameters</h4> 1573<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1574<colgroup> 1575<col width="150px" class="parameters_name"> 1576<col class="parameters_description"> 1577<col width="200px" class="parameters_annotations"> 1578</colgroup> 1579<tbody> 1580<tr> 1581<td class="parameter_name"><p>profile</p></td> 1582<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1583<td class="parameter_annotations"> </td> 1584</tr> 1585<tr> 1586<td class="parameter_name"><p>preset_name</p></td> 1587<td class="parameter_description"><p>The name of the preset to use in this <em class="parameter"><code>profile</code></em> 1588. </p></td> 1589<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> 1590</tr> 1591</tbody> 1592</table></div> 1593</div> 1594</div> 1595<hr> 1596<div class="refsect2"> 1597<a name="gst-encoding-profile-set-restriction"></a><h3>gst_encoding_profile_set_restriction ()</h3> 1598<pre class="programlisting"><span class="returnvalue">void</span> 1599gst_encoding_profile_set_restriction (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>, 1600 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> *restriction</code></em>);</pre> 1601<p>Set the restriction <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> to apply before the encoder 1602that will be used in the profile. See <a class="link" href="GstEncodingProfile.html#gst-encoding-profile-get-restriction" title="gst_encoding_profile_get_restriction ()"><code class="function">gst_encoding_profile_get_restriction()</code></a> 1603for more about restrictions. Does not apply to <a class="link" href="GstEncodingProfile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a>.</p> 1604<div class="refsect3"> 1605<a name="gst-encoding-profile-set-restriction.parameters"></a><h4>Parameters</h4> 1606<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1607<colgroup> 1608<col width="150px" class="parameters_name"> 1609<col class="parameters_description"> 1610<col width="200px" class="parameters_annotations"> 1611</colgroup> 1612<tbody> 1613<tr> 1614<td class="parameter_name"><p>profile</p></td> 1615<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1616<td class="parameter_annotations"> </td> 1617</tr> 1618<tr> 1619<td class="parameter_name"><p>restriction</p></td> 1620<td class="parameter_description"><p>the restriction to apply. </p></td> 1621<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td> 1622</tr> 1623</tbody> 1624</table></div> 1625</div> 1626</div> 1627<hr> 1628<div class="refsect2"> 1629<a name="gst-encoding-profile-set-presence"></a><h3>gst_encoding_profile_set_presence ()</h3> 1630<pre class="programlisting"><span class="returnvalue">void</span> 1631gst_encoding_profile_set_presence (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>, 1632 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> presence</code></em>);</pre> 1633<p>Set the number of time the profile is used in its parent 1634container profile. If 0, it is not a mandatory stream</p> 1635<div class="refsect3"> 1636<a name="gst-encoding-profile-set-presence.parameters"></a><h4>Parameters</h4> 1637<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1638<colgroup> 1639<col width="150px" class="parameters_name"> 1640<col class="parameters_description"> 1641<col width="200px" class="parameters_annotations"> 1642</colgroup> 1643<tbody> 1644<tr> 1645<td class="parameter_name"><p>profile</p></td> 1646<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1647<td class="parameter_annotations"> </td> 1648</tr> 1649<tr> 1650<td class="parameter_name"><p>presence</p></td> 1651<td class="parameter_description"><p>the number of time the profile can be used</p></td> 1652<td class="parameter_annotations"> </td> 1653</tr> 1654</tbody> 1655</table></div> 1656</div> 1657</div> 1658<hr> 1659<div class="refsect2"> 1660<a name="gst-encoding-profile-is-equal"></a><h3>gst_encoding_profile_is_equal ()</h3> 1661<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 1662gst_encoding_profile_is_equal (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *a</code></em>, 1663 <em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *b</code></em>);</pre> 1664<p>Checks whether the two <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> are equal</p> 1665<div class="refsect3"> 1666<a name="gst-encoding-profile-is-equal.parameters"></a><h4>Parameters</h4> 1667<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1668<colgroup> 1669<col width="150px" class="parameters_name"> 1670<col class="parameters_description"> 1671<col width="200px" class="parameters_annotations"> 1672</colgroup> 1673<tbody> 1674<tr> 1675<td class="parameter_name"><p>a</p></td> 1676<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1677<td class="parameter_annotations"> </td> 1678</tr> 1679<tr> 1680<td class="parameter_name"><p>b</p></td> 1681<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1682<td class="parameter_annotations"> </td> 1683</tr> 1684</tbody> 1685</table></div> 1686</div> 1687<div class="refsect3"> 1688<a name="gst-encoding-profile-is-equal.returns"></a><h4>Returns</h4> 1689<p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>a</code></em> 1690and <em class="parameter"><code>b</code></em> 1691are equal, else <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p> 1692</div> 1693</div> 1694<hr> 1695<div class="refsect2"> 1696<a name="gst-encoding-profile-is-enabled"></a><h3>gst_encoding_profile_is_enabled ()</h3> 1697<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 1698gst_encoding_profile_is_enabled (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre> 1699</div> 1700<hr> 1701<div class="refsect2"> 1702<a name="gst-encoding-profile-get-input-caps"></a><h3>gst_encoding_profile_get_input_caps ()</h3> 1703<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="returnvalue">GstCaps</span></a> * 1704gst_encoding_profile_get_input_caps (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre> 1705<p>Computes the full output caps that this <em class="parameter"><code>profile</code></em> 1706 will be able to consume.</p> 1707<div class="refsect3"> 1708<a name="gst-encoding-profile-get-input-caps.parameters"></a><h4>Parameters</h4> 1709<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1710<colgroup> 1711<col width="150px" class="parameters_name"> 1712<col class="parameters_description"> 1713<col width="200px" class="parameters_annotations"> 1714</colgroup> 1715<tbody><tr> 1716<td class="parameter_name"><p>profile</p></td> 1717<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1718<td class="parameter_annotations"> </td> 1719</tr></tbody> 1720</table></div> 1721</div> 1722<div class="refsect3"> 1723<a name="gst-encoding-profile-get-input-caps.returns"></a><h4>Returns</h4> 1724<p>The full caps the given <em class="parameter"><code>profile</code></em> 1725can consume. Call 1726<a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#gst-caps-unref"><code class="function">gst_caps_unref()</code></a> when you are done with the caps. </p> 1727<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> 1728</div> 1729</div> 1730<hr> 1731<div class="refsect2"> 1732<a name="gst-encoding-profile-get-type-nick"></a><h3>gst_encoding_profile_get_type_nick ()</h3> 1733<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 1734gst_encoding_profile_get_type_nick (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre> 1735<div class="refsect3"> 1736<a name="gst-encoding-profile-get-type-nick.parameters"></a><h4>Parameters</h4> 1737<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1738<colgroup> 1739<col width="150px" class="parameters_name"> 1740<col class="parameters_description"> 1741<col width="200px" class="parameters_annotations"> 1742</colgroup> 1743<tbody><tr> 1744<td class="parameter_name"><p>profile</p></td> 1745<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1746<td class="parameter_annotations"> </td> 1747</tr></tbody> 1748</table></div> 1749</div> 1750<div class="refsect3"> 1751<a name="gst-encoding-profile-get-type-nick.returns"></a><h4>Returns</h4> 1752<p> the human-readable name of the type of <em class="parameter"><code>profile</code></em> 1753.</p> 1754</div> 1755</div> 1756<hr> 1757<div class="refsect2"> 1758<a name="gst-encoding-profile-copy"></a><h3>gst_encoding_profile_copy ()</h3> 1759<pre class="programlisting"><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="returnvalue">GstEncodingProfile</span></a> * 1760gst_encoding_profile_copy (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *self</code></em>);</pre> 1761<p>Makes a deep copy of <em class="parameter"><code>self</code></em> 1762</p> 1763<div class="refsect3"> 1764<a name="gst-encoding-profile-copy.parameters"></a><h4>Parameters</h4> 1765<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1766<colgroup> 1767<col width="150px" class="parameters_name"> 1768<col class="parameters_description"> 1769<col width="200px" class="parameters_annotations"> 1770</colgroup> 1771<tbody><tr> 1772<td class="parameter_name"><p>self</p></td> 1773<td class="parameter_description"><p>The <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> to copy</p></td> 1774<td class="parameter_annotations"> </td> 1775</tr></tbody> 1776</table></div> 1777</div> 1778<div class="refsect3"> 1779<a name="gst-encoding-profile-copy.returns"></a><h4>Returns</h4> 1780<p>The copy of <em class="parameter"><code>self</code></em> 1781. </p> 1782<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> 1783</div> 1784<p class="since">Since: <a class="link" href="ix05.html#api-index-1.12">1.12</a></p> 1785</div> 1786<hr> 1787<div class="refsect2"> 1788<a name="gst-encoding-profile-get-allow-dynamic-output"></a><h3>gst_encoding_profile_get_allow_dynamic_output ()</h3> 1789<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 1790gst_encoding_profile_get_allow_dynamic_output 1791 (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre> 1792<p>Get whether the format that has been negotiated in at some point can be renegotiated 1793later during the encoding.</p> 1794<div class="refsect3"> 1795<a name="gst-encoding-profile-get-allow-dynamic-output.parameters"></a><h4>Parameters</h4> 1796<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1797<colgroup> 1798<col width="150px" class="parameters_name"> 1799<col class="parameters_description"> 1800<col width="200px" class="parameters_annotations"> 1801</colgroup> 1802<tbody><tr> 1803<td class="parameter_name"><p>profile</p></td> 1804<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1805<td class="parameter_annotations"> </td> 1806</tr></tbody> 1807</table></div> 1808</div> 1809</div> 1810<hr> 1811<div class="refsect2"> 1812<a name="gst-encoding-profile-set-allow-dynamic-output"></a><h3>gst_encoding_profile_set_allow_dynamic_output ()</h3> 1813<pre class="programlisting"><span class="returnvalue">void</span> 1814gst_encoding_profile_set_allow_dynamic_output 1815 (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>, 1816 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> allow_dynamic_output</code></em>);</pre> 1817<p>Sets whether the format that has been negotiated in at some point can be renegotiated 1818later during the encoding.</p> 1819<div class="refsect3"> 1820<a name="gst-encoding-profile-set-allow-dynamic-output.parameters"></a><h4>Parameters</h4> 1821<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1822<colgroup> 1823<col width="150px" class="parameters_name"> 1824<col class="parameters_description"> 1825<col width="200px" class="parameters_annotations"> 1826</colgroup> 1827<tbody> 1828<tr> 1829<td class="parameter_name"><p>profile</p></td> 1830<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1831<td class="parameter_annotations"> </td> 1832</tr> 1833<tr> 1834<td class="parameter_name"><p>allow_dynamic_output</p></td> 1835<td class="parameter_description"><p>Whether the format that has been negotiated first can be renegotiated 1836during the encoding</p></td> 1837<td class="parameter_annotations"> </td> 1838</tr> 1839</tbody> 1840</table></div> 1841</div> 1842</div> 1843<hr> 1844<div class="refsect2"> 1845<a name="gst-encoding-container-profile-new"></a><h3>gst_encoding_container_profile_new ()</h3> 1846<pre class="programlisting"><a class="link" href="GstEncodingProfile.html#GstEncodingContainerProfile"><span class="returnvalue">GstEncodingContainerProfile</span></a> * 1847gst_encoding_container_profile_new (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>, 1848 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *description</code></em>, 1849 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> *format</code></em>, 1850 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *preset</code></em>);</pre> 1851<p>Creates a new <a class="link" href="GstEncodingProfile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a>.</p> 1852<div class="refsect3"> 1853<a name="gst-encoding-container-profile-new.parameters"></a><h4>Parameters</h4> 1854<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1855<colgroup> 1856<col width="150px" class="parameters_name"> 1857<col class="parameters_description"> 1858<col width="200px" class="parameters_annotations"> 1859</colgroup> 1860<tbody> 1861<tr> 1862<td class="parameter_name"><p>name</p></td> 1863<td class="parameter_description"><p>The name of the container profile, can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 1864<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> 1865</tr> 1866<tr> 1867<td class="parameter_name"><p>description</p></td> 1868<td class="parameter_description"><p>The description of the container profile, 1869can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 1870<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> 1871</tr> 1872<tr> 1873<td class="parameter_name"><p>format</p></td> 1874<td class="parameter_description"><p>The format to use for this profile. </p></td> 1875<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 1876</tr> 1877<tr> 1878<td class="parameter_name"><p>preset</p></td> 1879<td class="parameter_description"><p>The preset to use for this profile. </p></td> 1880<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> 1881</tr> 1882</tbody> 1883</table></div> 1884</div> 1885<div class="refsect3"> 1886<a name="gst-encoding-container-profile-new.returns"></a><h4>Returns</h4> 1887<p> The newly created <a class="link" href="GstEncodingProfile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a>.</p> 1888</div> 1889</div> 1890<hr> 1891<div class="refsect2"> 1892<a name="gst-encoding-container-profile-add-profile"></a><h3>gst_encoding_container_profile_add_profile ()</h3> 1893<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 1894gst_encoding_container_profile_add_profile 1895 (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a> *container</code></em>, 1896 <em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre> 1897<p>Add a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> to the list of profiles handled by <em class="parameter"><code>container</code></em> 1898.</p> 1899<p>No copy of <em class="parameter"><code>profile</code></em> 1900 will be made, if you wish to use it elsewhere after this 1901method you should increment its reference count.</p> 1902<div class="refsect3"> 1903<a name="gst-encoding-container-profile-add-profile.parameters"></a><h4>Parameters</h4> 1904<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1905<colgroup> 1906<col width="150px" class="parameters_name"> 1907<col class="parameters_description"> 1908<col width="200px" class="parameters_annotations"> 1909</colgroup> 1910<tbody> 1911<tr> 1912<td class="parameter_name"><p>container</p></td> 1913<td class="parameter_description"><p>the <a class="link" href="GstEncodingProfile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a> to use</p></td> 1914<td class="parameter_annotations"> </td> 1915</tr> 1916<tr> 1917<td class="parameter_name"><p>profile</p></td> 1918<td class="parameter_description"><p>the <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> to add. </p></td> 1919<td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td> 1920</tr> 1921</tbody> 1922</table></div> 1923</div> 1924<div class="refsect3"> 1925<a name="gst-encoding-container-profile-add-profile.returns"></a><h4>Returns</h4> 1926<p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>stream</code></em> 1927was properly added, else <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p> 1928</div> 1929</div> 1930<hr> 1931<div class="refsect2"> 1932<a name="gst-encoding-container-profile-contains-profile"></a><h3>gst_encoding_container_profile_contains_profile ()</h3> 1933<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 1934gst_encoding_container_profile_contains_profile 1935 (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a> *container</code></em>, 1936 <em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre> 1937<p>Checks if <em class="parameter"><code>container</code></em> 1938 contains a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> identical to 1939<em class="parameter"><code>profile</code></em> 1940.</p> 1941<div class="refsect3"> 1942<a name="gst-encoding-container-profile-contains-profile.parameters"></a><h4>Parameters</h4> 1943<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1944<colgroup> 1945<col width="150px" class="parameters_name"> 1946<col class="parameters_description"> 1947<col width="200px" class="parameters_annotations"> 1948</colgroup> 1949<tbody> 1950<tr> 1951<td class="parameter_name"><p>container</p></td> 1952<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a></p></td> 1953<td class="parameter_annotations"> </td> 1954</tr> 1955<tr> 1956<td class="parameter_name"><p>profile</p></td> 1957<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p></td> 1958<td class="parameter_annotations"> </td> 1959</tr> 1960</tbody> 1961</table></div> 1962</div> 1963<div class="refsect3"> 1964<a name="gst-encoding-container-profile-contains-profile.returns"></a><h4>Returns</h4> 1965<p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>container</code></em> 1966contains a <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> identical 1967to <em class="parameter"><code>profile</code></em> 1968, else <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p> 1969</div> 1970</div> 1971<hr> 1972<div class="refsect2"> 1973<a name="gst-encoding-container-profile-get-profiles"></a><h3>gst_encoding_container_profile_get_profiles ()</h3> 1974<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * 1975gst_encoding_container_profile_get_profiles 1976 (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a> *profile</code></em>);</pre> 1977<div class="refsect3"> 1978<a name="gst-encoding-container-profile-get-profiles.parameters"></a><h4>Parameters</h4> 1979<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1980<colgroup> 1981<col width="150px" class="parameters_name"> 1982<col class="parameters_description"> 1983<col width="200px" class="parameters_annotations"> 1984</colgroup> 1985<tbody><tr> 1986<td class="parameter_name"><p>profile</p></td> 1987<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html#GstEncodingContainerProfile"><span class="type">GstEncodingContainerProfile</span></a></p></td> 1988<td class="parameter_annotations"> </td> 1989</tr></tbody> 1990</table></div> 1991</div> 1992<div class="refsect3"> 1993<a name="gst-encoding-container-profile-get-profiles.returns"></a><h4>Returns</h4> 1994<p>the list of contained <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>. </p> 1995<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GstPbutils.EncodingProfile][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> 1996</div> 1997</div> 1998<hr> 1999<div class="refsect2"> 2000<a name="gst-encoding-audio-profile-new"></a><h3>gst_encoding_audio_profile_new ()</h3> 2001<pre class="programlisting"><a class="link" href="GstEncodingProfile.html#GstEncodingAudioProfile"><span class="returnvalue">GstEncodingAudioProfile</span></a> * 2002gst_encoding_audio_profile_new (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> *format</code></em>, 2003 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *preset</code></em>, 2004 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> *restriction</code></em>, 2005 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> presence</code></em>);</pre> 2006<p>Creates a new <a class="link" href="GstEncodingProfile.html#GstEncodingAudioProfile"><span class="type">GstEncodingAudioProfile</span></a></p> 2007<p>All provided allocatable arguments will be internally copied, so can be 2008safely freed/unreferenced after calling this method.</p> 2009<div class="refsect3"> 2010<a name="gst-encoding-audio-profile-new.parameters"></a><h4>Parameters</h4> 2011<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2012<colgroup> 2013<col width="150px" class="parameters_name"> 2014<col class="parameters_description"> 2015<col width="200px" class="parameters_annotations"> 2016</colgroup> 2017<tbody> 2018<tr> 2019<td class="parameter_name"><p>format</p></td> 2020<td class="parameter_description"><p>the <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a>. </p></td> 2021<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 2022</tr> 2023<tr> 2024<td class="parameter_name"><p>preset</p></td> 2025<td class="parameter_description"><p>the preset(s) to use on the encoder, can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 2026<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> 2027</tr> 2028<tr> 2029<td class="parameter_name"><p>restriction</p></td> 2030<td class="parameter_description"><p>the <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> used to restrict the input to the encoder, can be 2031NULL. See <a class="link" href="GstEncodingProfile.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. </p></td> 2032<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> 2033</tr> 2034<tr> 2035<td class="parameter_name"><p>presence</p></td> 2036<td class="parameter_description"><p>the number of time this stream must be used. 0 means any number of 2037times (including never)</p></td> 2038<td class="parameter_annotations"> </td> 2039</tr> 2040</tbody> 2041</table></div> 2042</div> 2043<div class="refsect3"> 2044<a name="gst-encoding-audio-profile-new.returns"></a><h4>Returns</h4> 2045<p> the newly created <a class="link" href="GstEncodingProfile.html#GstEncodingAudioProfile"><span class="type">GstEncodingAudioProfile</span></a>.</p> 2046</div> 2047</div> 2048<hr> 2049<div class="refsect2"> 2050<a name="gst-encoding-video-profile-new"></a><h3>gst_encoding_video_profile_new ()</h3> 2051<pre class="programlisting"><a class="link" href="GstEncodingProfile.html#GstEncodingVideoProfile"><span class="returnvalue">GstEncodingVideoProfile</span></a> * 2052gst_encoding_video_profile_new (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> *format</code></em>, 2053 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *preset</code></em>, 2054 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> *restriction</code></em>, 2055 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> presence</code></em>);</pre> 2056<p>Creates a new <a class="link" href="GstEncodingProfile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a></p> 2057<p>All provided allocatable arguments will be internally copied, so can be 2058safely freed/unreferenced after calling this method.</p> 2059<p>If you wish to control the pass number (in case of multi-pass scenarios), 2060please refer to the <a class="link" href="GstEncodingProfile.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.</p> 2061<p>If you wish to use/force a constant framerate please refer to the 2062<a class="link" href="GstEncodingProfile.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.</p> 2063<div class="refsect3"> 2064<a name="gst-encoding-video-profile-new.parameters"></a><h4>Parameters</h4> 2065<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2066<colgroup> 2067<col width="150px" class="parameters_name"> 2068<col class="parameters_description"> 2069<col width="200px" class="parameters_annotations"> 2070</colgroup> 2071<tbody> 2072<tr> 2073<td class="parameter_name"><p>format</p></td> 2074<td class="parameter_description"><p>the <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a>. </p></td> 2075<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 2076</tr> 2077<tr> 2078<td class="parameter_name"><p>preset</p></td> 2079<td class="parameter_description"><p>the preset(s) to use on the encoder, can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 2080<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> 2081</tr> 2082<tr> 2083<td class="parameter_name"><p>restriction</p></td> 2084<td class="parameter_description"><p>the <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> used to restrict the input to the encoder, can be 2085NULL. See <a class="link" href="GstEncodingProfile.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. </p></td> 2086<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> 2087</tr> 2088<tr> 2089<td class="parameter_name"><p>presence</p></td> 2090<td class="parameter_description"><p>the number of time this stream must be used. 0 means any number of 2091times (including never)</p></td> 2092<td class="parameter_annotations"> </td> 2093</tr> 2094</tbody> 2095</table></div> 2096</div> 2097<div class="refsect3"> 2098<a name="gst-encoding-video-profile-new.returns"></a><h4>Returns</h4> 2099<p> the newly created <a class="link" href="GstEncodingProfile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a>.</p> 2100</div> 2101</div> 2102<hr> 2103<div class="refsect2"> 2104<a name="gst-encoding-video-profile-get-pass"></a><h3>gst_encoding_video_profile_get_pass ()</h3> 2105<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> 2106gst_encoding_video_profile_get_pass (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a> *prof</code></em>);</pre> 2107<p>Get the pass number if this is part of a multi-pass profile.</p> 2108<div class="refsect3"> 2109<a name="gst-encoding-video-profile-get-pass.parameters"></a><h4>Parameters</h4> 2110<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2111<colgroup> 2112<col width="150px" class="parameters_name"> 2113<col class="parameters_description"> 2114<col width="200px" class="parameters_annotations"> 2115</colgroup> 2116<tbody><tr> 2117<td class="parameter_name"><p>prof</p></td> 2118<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a></p></td> 2119<td class="parameter_annotations"> </td> 2120</tr></tbody> 2121</table></div> 2122</div> 2123<div class="refsect3"> 2124<a name="gst-encoding-video-profile-get-pass.returns"></a><h4>Returns</h4> 2125<p> The pass number. Starts at 1 for multi-pass. 0 if this is 2126not a multi-pass profile</p> 2127</div> 2128</div> 2129<hr> 2130<div class="refsect2"> 2131<a name="gst-encoding-video-profile-get-variableframerate"></a><h3>gst_encoding_video_profile_get_variableframerate ()</h3> 2132<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 2133gst_encoding_video_profile_get_variableframerate 2134 (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a> *prof</code></em>);</pre> 2135<div class="refsect3"> 2136<a name="gst-encoding-video-profile-get-variableframerate.parameters"></a><h4>Parameters</h4> 2137<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2138<colgroup> 2139<col width="150px" class="parameters_name"> 2140<col class="parameters_description"> 2141<col width="200px" class="parameters_annotations"> 2142</colgroup> 2143<tbody><tr> 2144<td class="parameter_name"><p>prof</p></td> 2145<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a></p></td> 2146<td class="parameter_annotations"> </td> 2147</tr></tbody> 2148</table></div> 2149</div> 2150<div class="refsect3"> 2151<a name="gst-encoding-video-profile-get-variableframerate.returns"></a><h4>Returns</h4> 2152<p> Whether non-constant video framerate is allowed for encoding.</p> 2153</div> 2154</div> 2155<hr> 2156<div class="refsect2"> 2157<a name="gst-encoding-video-profile-set-pass"></a><h3>gst_encoding_video_profile_set_pass ()</h3> 2158<pre class="programlisting"><span class="returnvalue">void</span> 2159gst_encoding_video_profile_set_pass (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a> *prof</code></em>, 2160 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> pass</code></em>);</pre> 2161<p>Sets the pass number of this video profile. The first pass profile should have 2162this value set to 1. If this video profile isn't part of a multi-pass profile, 2163you may set it to 0 (the default value).</p> 2164<div class="refsect3"> 2165<a name="gst-encoding-video-profile-set-pass.parameters"></a><h4>Parameters</h4> 2166<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2167<colgroup> 2168<col width="150px" class="parameters_name"> 2169<col class="parameters_description"> 2170<col width="200px" class="parameters_annotations"> 2171</colgroup> 2172<tbody> 2173<tr> 2174<td class="parameter_name"><p>prof</p></td> 2175<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a></p></td> 2176<td class="parameter_annotations"> </td> 2177</tr> 2178<tr> 2179<td class="parameter_name"><p>pass</p></td> 2180<td class="parameter_description"><p>the pass number for this profile</p></td> 2181<td class="parameter_annotations"> </td> 2182</tr> 2183</tbody> 2184</table></div> 2185</div> 2186</div> 2187<hr> 2188<div class="refsect2"> 2189<a name="gst-encoding-video-profile-set-variableframerate"></a><h3>gst_encoding_video_profile_set_variableframerate ()</h3> 2190<pre class="programlisting"><span class="returnvalue">void</span> 2191gst_encoding_video_profile_set_variableframerate 2192 (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a> *prof</code></em>, 2193 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> variableframerate</code></em>);</pre> 2194<p>If set to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then the incoming stream will be allowed to have non-constant 2195framerate. If set to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> (default value), then the incoming stream will 2196be normalized by dropping/duplicating frames in order to produce a 2197constance framerate.</p> 2198<div class="refsect3"> 2199<a name="gst-encoding-video-profile-set-variableframerate.parameters"></a><h4>Parameters</h4> 2200<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2201<colgroup> 2202<col width="150px" class="parameters_name"> 2203<col class="parameters_description"> 2204<col width="200px" class="parameters_annotations"> 2205</colgroup> 2206<tbody> 2207<tr> 2208<td class="parameter_name"><p>prof</p></td> 2209<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html#GstEncodingVideoProfile"><span class="type">GstEncodingVideoProfile</span></a></p></td> 2210<td class="parameter_annotations"> </td> 2211</tr> 2212<tr> 2213<td class="parameter_name"><p>variableframerate</p></td> 2214<td class="parameter_description"><p>a boolean</p></td> 2215<td class="parameter_annotations"> </td> 2216</tr> 2217</tbody> 2218</table></div> 2219</div> 2220</div> 2221<hr> 2222<div class="refsect2"> 2223<a name="gst-encoding-target-unref"></a><h3>gst_encoding_target_unref()</h3> 2224<pre class="programlisting">#define gst_encoding_target_unref(target)</pre> 2225<p>Decreases the reference count of the <em class="parameter"><code>target</code></em> 2226, possibly freeing it.</p> 2227<div class="refsect3"> 2228<a name="gst-encoding-target-unref.parameters"></a><h4>Parameters</h4> 2229<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2230<colgroup> 2231<col width="150px" class="parameters_name"> 2232<col class="parameters_description"> 2233<col width="200px" class="parameters_annotations"> 2234</colgroup> 2235<tbody><tr> 2236<td class="parameter_name"><p>target</p></td> 2237<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a></p></td> 2238<td class="parameter_annotations"> </td> 2239</tr></tbody> 2240</table></div> 2241</div> 2242</div> 2243<hr> 2244<div class="refsect2"> 2245<a name="gst-encoding-target-ref"></a><h3>gst_encoding_target_ref()</h3> 2246<pre class="programlisting">#define gst_encoding_target_ref(target)</pre> 2247<p>Increases the reference count of the <em class="parameter"><code>target</code></em> 2248.</p> 2249<div class="refsect3"> 2250<a name="gst-encoding-target-ref.parameters"></a><h4>Parameters</h4> 2251<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2252<colgroup> 2253<col width="150px" class="parameters_name"> 2254<col class="parameters_description"> 2255<col width="200px" class="parameters_annotations"> 2256</colgroup> 2257<tbody><tr> 2258<td class="parameter_name"><p>target</p></td> 2259<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a></p></td> 2260<td class="parameter_annotations"> </td> 2261</tr></tbody> 2262</table></div> 2263</div> 2264</div> 2265<hr> 2266<div class="refsect2"> 2267<a name="gst-encoding-target-new"></a><h3>gst_encoding_target_new ()</h3> 2268<pre class="programlisting"><a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="returnvalue">GstEncodingTarget</span></a> * 2269gst_encoding_target_new (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>, 2270 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *category</code></em>, 2271 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *description</code></em>, 2272 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *profiles</code></em>);</pre> 2273<p>Creates a new <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a>.</p> 2274<p>The name and category can only consist of lowercase ASCII letters for the 2275first character, followed by either lowercase ASCII letters, digits or 2276hyphens ('-').</p> 2277<p>The <em class="parameter"><code>category</code></em> 2278 <span class="emphasis"><em>should</em></span> be one of the existing 2279well-defined categories, like <a class="link" href="GstEncodingProfile.html#GST-ENCODING-CATEGORY-DEVICE:CAPS" title="GST_ENCODING_CATEGORY_DEVICE"><span class="type">GST_ENCODING_CATEGORY_DEVICE</span></a>, but it 2280<span class="emphasis"><em>can</em></span> be a application or user specific category if 2281needed.</p> 2282<div class="refsect3"> 2283<a name="gst-encoding-target-new.parameters"></a><h4>Parameters</h4> 2284<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2285<colgroup> 2286<col width="150px" class="parameters_name"> 2287<col class="parameters_description"> 2288<col width="200px" class="parameters_annotations"> 2289</colgroup> 2290<tbody> 2291<tr> 2292<td class="parameter_name"><p>name</p></td> 2293<td class="parameter_description"><p>The name of the target.</p></td> 2294<td class="parameter_annotations"> </td> 2295</tr> 2296<tr> 2297<td class="parameter_name"><p>category</p></td> 2298<td class="parameter_description"><p>The name of the category to which this <em class="parameter"><code>target</code></em> 2299belongs. For example: <a class="link" href="GstEncodingProfile.html#GST-ENCODING-CATEGORY-DEVICE:CAPS" title="GST_ENCODING_CATEGORY_DEVICE"><span class="type">GST_ENCODING_CATEGORY_DEVICE</span></a>. </p></td> 2300<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 2301</tr> 2302<tr> 2303<td class="parameter_name"><p>description</p></td> 2304<td class="parameter_description"><p>A description of <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> in the 2305current locale. </p></td> 2306<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 2307</tr> 2308<tr> 2309<td class="parameter_name"><p>profiles</p></td> 2310<td class="parameter_description"><p>A <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of 2311<a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>. </p></td> 2312<td class="parameter_annotations"><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> GstPbutils.EncodingProfile]</span></td> 2313</tr> 2314</tbody> 2315</table></div> 2316</div> 2317<div class="refsect3"> 2318<a name="gst-encoding-target-new.returns"></a><h4>Returns</h4> 2319<p>The newly created <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if 2320there was an error. </p> 2321<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> 2322</div> 2323</div> 2324<hr> 2325<div class="refsect2"> 2326<a name="gst-encoding-target-get-name"></a><h3>gst_encoding_target_get_name ()</h3> 2327<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 2328gst_encoding_target_get_name (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>);</pre> 2329<div class="refsect3"> 2330<a name="gst-encoding-target-get-name.parameters"></a><h4>Parameters</h4> 2331<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2332<colgroup> 2333<col width="150px" class="parameters_name"> 2334<col class="parameters_description"> 2335<col width="200px" class="parameters_annotations"> 2336</colgroup> 2337<tbody><tr> 2338<td class="parameter_name"><p>target</p></td> 2339<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a></p></td> 2340<td class="parameter_annotations"> </td> 2341</tr></tbody> 2342</table></div> 2343</div> 2344<div class="refsect3"> 2345<a name="gst-encoding-target-get-name.returns"></a><h4>Returns</h4> 2346<p>The name of the <em class="parameter"><code>target</code></em> 2347. </p> 2348<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> 2349</div> 2350</div> 2351<hr> 2352<div class="refsect2"> 2353<a name="gst-encoding-target-get-category"></a><h3>gst_encoding_target_get_category ()</h3> 2354<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 2355gst_encoding_target_get_category (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>);</pre> 2356<div class="refsect3"> 2357<a name="gst-encoding-target-get-category.parameters"></a><h4>Parameters</h4> 2358<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2359<colgroup> 2360<col width="150px" class="parameters_name"> 2361<col class="parameters_description"> 2362<col width="200px" class="parameters_annotations"> 2363</colgroup> 2364<tbody><tr> 2365<td class="parameter_name"><p>target</p></td> 2366<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a></p></td> 2367<td class="parameter_annotations"> </td> 2368</tr></tbody> 2369</table></div> 2370</div> 2371<div class="refsect3"> 2372<a name="gst-encoding-target-get-category.returns"></a><h4>Returns</h4> 2373<p>The category of the <em class="parameter"><code>target</code></em> 2374. For example: 2375<a class="link" href="GstEncodingProfile.html#GST-ENCODING-CATEGORY-DEVICE:CAPS" title="GST_ENCODING_CATEGORY_DEVICE"><span class="type">GST_ENCODING_CATEGORY_DEVICE</span></a>. </p> 2376<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> 2377</div> 2378</div> 2379<hr> 2380<div class="refsect2"> 2381<a name="gst-encoding-target-get-description"></a><h3>gst_encoding_target_get_description ()</h3> 2382<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 2383gst_encoding_target_get_description (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>);</pre> 2384<div class="refsect3"> 2385<a name="gst-encoding-target-get-description.parameters"></a><h4>Parameters</h4> 2386<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2387<colgroup> 2388<col width="150px" class="parameters_name"> 2389<col class="parameters_description"> 2390<col width="200px" class="parameters_annotations"> 2391</colgroup> 2392<tbody><tr> 2393<td class="parameter_name"><p>target</p></td> 2394<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a></p></td> 2395<td class="parameter_annotations"> </td> 2396</tr></tbody> 2397</table></div> 2398</div> 2399<div class="refsect3"> 2400<a name="gst-encoding-target-get-description.returns"></a><h4>Returns</h4> 2401<p>The description of the <em class="parameter"><code>target</code></em> 2402. </p> 2403<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> 2404</div> 2405</div> 2406<hr> 2407<div class="refsect2"> 2408<a name="gst-encoding-target-get-profiles"></a><h3>gst_encoding_target_get_profiles ()</h3> 2409<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * 2410gst_encoding_target_get_profiles (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>);</pre> 2411<div class="refsect3"> 2412<a name="gst-encoding-target-get-profiles.parameters"></a><h4>Parameters</h4> 2413<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2414<colgroup> 2415<col width="150px" class="parameters_name"> 2416<col class="parameters_description"> 2417<col width="200px" class="parameters_annotations"> 2418</colgroup> 2419<tbody><tr> 2420<td class="parameter_name"><p>target</p></td> 2421<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a></p></td> 2422<td class="parameter_annotations"> </td> 2423</tr></tbody> 2424</table></div> 2425</div> 2426<div class="refsect3"> 2427<a name="gst-encoding-target-get-profiles.returns"></a><h4>Returns</h4> 2428<p>A list of 2429<a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>(s) this <em class="parameter"><code>target</code></em> 2430handles. </p> 2431<p><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> GstPbutils.EncodingProfile]</span></p> 2432</div> 2433</div> 2434<hr> 2435<div class="refsect2"> 2436<a name="gst-encoding-target-get-profile"></a><h3>gst_encoding_target_get_profile ()</h3> 2437<pre class="programlisting"><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="returnvalue">GstEncodingProfile</span></a> * 2438gst_encoding_target_get_profile (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>, 2439 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre> 2440<div class="refsect3"> 2441<a name="gst-encoding-target-get-profile.parameters"></a><h4>Parameters</h4> 2442<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2443<colgroup> 2444<col width="150px" class="parameters_name"> 2445<col class="parameters_description"> 2446<col width="200px" class="parameters_annotations"> 2447</colgroup> 2448<tbody> 2449<tr> 2450<td class="parameter_name"><p>target</p></td> 2451<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a></p></td> 2452<td class="parameter_annotations"> </td> 2453</tr> 2454<tr> 2455<td class="parameter_name"><p>name</p></td> 2456<td class="parameter_description"><p>the name of the profile to retrieve</p></td> 2457<td class="parameter_annotations"> </td> 2458</tr> 2459</tbody> 2460</table></div> 2461</div> 2462<div class="refsect3"> 2463<a name="gst-encoding-target-get-profile.returns"></a><h4>Returns</h4> 2464<p>The matching <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p> 2465<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> 2466</div> 2467</div> 2468<hr> 2469<div class="refsect2"> 2470<a name="gst-encoding-target-add-profile"></a><h3>gst_encoding_target_add_profile ()</h3> 2471<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 2472gst_encoding_target_add_profile (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>, 2473 <em class="parameter"><code><a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> *profile</code></em>);</pre> 2474<p>Adds the given <em class="parameter"><code>profile</code></em> 2475 to the <em class="parameter"><code>target</code></em> 2476. Each added profile must have 2477a unique name within the profile.</p> 2478<p>The <em class="parameter"><code>target</code></em> 2479 will steal a reference to the <em class="parameter"><code>profile</code></em> 2480. If you wish to use 2481the profile after calling this method, you should increase its reference 2482count.</p> 2483<div class="refsect3"> 2484<a name="gst-encoding-target-add-profile.parameters"></a><h4>Parameters</h4> 2485<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2486<colgroup> 2487<col width="150px" class="parameters_name"> 2488<col class="parameters_description"> 2489<col width="200px" class="parameters_annotations"> 2490</colgroup> 2491<tbody> 2492<tr> 2493<td class="parameter_name"><p>target</p></td> 2494<td class="parameter_description"><p>the <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> to add a profile to</p></td> 2495<td class="parameter_annotations"> </td> 2496</tr> 2497<tr> 2498<td class="parameter_name"><p>profile</p></td> 2499<td class="parameter_description"><p>the <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> to add. </p></td> 2500<td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td> 2501</tr> 2502</tbody> 2503</table></div> 2504</div> 2505<div class="refsect3"> 2506<a name="gst-encoding-target-add-profile.returns"></a><h4>Returns</h4> 2507<p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the profile was added, else <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p> 2508</div> 2509</div> 2510<hr> 2511<div class="refsect2"> 2512<a name="gst-encoding-target-save"></a><h3>gst_encoding_target_save ()</h3> 2513<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 2514gst_encoding_target_save (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>, 2515 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> 2516<p>Saves the <em class="parameter"><code>target</code></em> 2517 to a default user-local directory.</p> 2518<div class="refsect3"> 2519<a name="gst-encoding-target-save.parameters"></a><h4>Parameters</h4> 2520<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2521<colgroup> 2522<col width="150px" class="parameters_name"> 2523<col class="parameters_description"> 2524<col width="200px" class="parameters_annotations"> 2525</colgroup> 2526<tbody> 2527<tr> 2528<td class="parameter_name"><p>target</p></td> 2529<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a></p></td> 2530<td class="parameter_annotations"> </td> 2531</tr> 2532<tr> 2533<td class="parameter_name"><p>error</p></td> 2534<td class="parameter_description"><p>If an error occured, this field will be filled in.</p></td> 2535<td class="parameter_annotations"> </td> 2536</tr> 2537</tbody> 2538</table></div> 2539</div> 2540<div class="refsect3"> 2541<a name="gst-encoding-target-save.returns"></a><h4>Returns</h4> 2542<p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the target was correctly saved, else <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p> 2543</div> 2544</div> 2545<hr> 2546<div class="refsect2"> 2547<a name="gst-encoding-target-save-to-file"></a><h3>gst_encoding_target_save_to_file ()</h3> 2548<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 2549gst_encoding_target_save_to_file (<em class="parameter"><code><a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> *target</code></em>, 2550 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filepath</code></em>, 2551 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> 2552<p>Saves the <em class="parameter"><code>target</code></em> 2553 to the provided file location.</p> 2554<div class="refsect3"> 2555<a name="gst-encoding-target-save-to-file.parameters"></a><h4>Parameters</h4> 2556<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2557<colgroup> 2558<col width="150px" class="parameters_name"> 2559<col class="parameters_description"> 2560<col width="200px" class="parameters_annotations"> 2561</colgroup> 2562<tbody> 2563<tr> 2564<td class="parameter_name"><p>target</p></td> 2565<td class="parameter_description"><p>a <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a></p></td> 2566<td class="parameter_annotations"> </td> 2567</tr> 2568<tr> 2569<td class="parameter_name"><p>filepath</p></td> 2570<td class="parameter_description"><p>the location to store the <em class="parameter"><code>target</code></em> 2571at. </p></td> 2572<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td> 2573</tr> 2574<tr> 2575<td class="parameter_name"><p>error</p></td> 2576<td class="parameter_description"><p>If an error occured, this field will be filled in.</p></td> 2577<td class="parameter_annotations"> </td> 2578</tr> 2579</tbody> 2580</table></div> 2581</div> 2582<div class="refsect3"> 2583<a name="gst-encoding-target-save-to-file.returns"></a><h4>Returns</h4> 2584<p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the target was correctly saved, else <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p> 2585</div> 2586</div> 2587<hr> 2588<div class="refsect2"> 2589<a name="gst-encoding-target-load"></a><h3>gst_encoding_target_load ()</h3> 2590<pre class="programlisting"><a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="returnvalue">GstEncodingTarget</span></a> * 2591gst_encoding_target_load (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>, 2592 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *category</code></em>, 2593 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> 2594<p>Searches for the <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> with the given name, loads it 2595and returns it.</p> 2596<p>If the category name is specified only targets from that category will be 2597searched for.</p> 2598<div class="refsect3"> 2599<a name="gst-encoding-target-load.parameters"></a><h4>Parameters</h4> 2600<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2601<colgroup> 2602<col width="150px" class="parameters_name"> 2603<col class="parameters_description"> 2604<col width="200px" class="parameters_annotations"> 2605</colgroup> 2606<tbody> 2607<tr> 2608<td class="parameter_name"><p>name</p></td> 2609<td class="parameter_description"><p>the name of the <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> to load (automatically 2610converted to lower case internally as capital letters are not 2611valid for target names).</p></td> 2612<td class="parameter_annotations"> </td> 2613</tr> 2614<tr> 2615<td class="parameter_name"><p>category</p></td> 2616<td class="parameter_description"><p>the name of the target category, like 2617<a class="link" href="GstEncodingProfile.html#GST-ENCODING-CATEGORY-DEVICE:CAPS" title="GST_ENCODING_CATEGORY_DEVICE"><span class="type">GST_ENCODING_CATEGORY_DEVICE</span></a>. Can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 2618<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> 2619</tr> 2620<tr> 2621<td class="parameter_name"><p>error</p></td> 2622<td class="parameter_description"><p>If an error occured, this field will be filled in.</p></td> 2623<td class="parameter_annotations"> </td> 2624</tr> 2625</tbody> 2626</table></div> 2627</div> 2628<div class="refsect3"> 2629<a name="gst-encoding-target-load.returns"></a><h4>Returns</h4> 2630<p>The <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> if available, else <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p> 2631<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> 2632</div> 2633</div> 2634<hr> 2635<div class="refsect2"> 2636<a name="gst-encoding-target-load-from-file"></a><h3>gst_encoding_target_load_from_file ()</h3> 2637<pre class="programlisting"><a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="returnvalue">GstEncodingTarget</span></a> * 2638gst_encoding_target_load_from_file (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filepath</code></em>, 2639 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> 2640<p>Opens the provided file and returns the contained <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a>.</p> 2641<div class="refsect3"> 2642<a name="gst-encoding-target-load-from-file.parameters"></a><h4>Parameters</h4> 2643<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2644<colgroup> 2645<col width="150px" class="parameters_name"> 2646<col class="parameters_description"> 2647<col width="200px" class="parameters_annotations"> 2648</colgroup> 2649<tbody> 2650<tr> 2651<td class="parameter_name"><p>filepath</p></td> 2652<td class="parameter_description"><p>The file location to load the <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> from. </p></td> 2653<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td> 2654</tr> 2655<tr> 2656<td class="parameter_name"><p>error</p></td> 2657<td class="parameter_description"><p>If an error occured, this field will be filled in.</p></td> 2658<td class="parameter_annotations"> </td> 2659</tr> 2660</tbody> 2661</table></div> 2662</div> 2663<div class="refsect3"> 2664<a name="gst-encoding-target-load-from-file.returns"></a><h4>Returns</h4> 2665<p>The <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> contained in the file, else 2666<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p> 2667<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> 2668</div> 2669</div> 2670<hr> 2671<div class="refsect2"> 2672<a name="gst-encoding-list-all-targets"></a><h3>gst_encoding_list_all_targets ()</h3> 2673<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * 2674gst_encoding_list_all_targets (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *categoryname</code></em>);</pre> 2675<p>List all available <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> for the specified category, or all categories 2676if <em class="parameter"><code>categoryname</code></em> 2677 is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p> 2678<div class="refsect3"> 2679<a name="gst-encoding-list-all-targets.parameters"></a><h4>Parameters</h4> 2680<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2681<colgroup> 2682<col width="150px" class="parameters_name"> 2683<col class="parameters_description"> 2684<col width="200px" class="parameters_annotations"> 2685</colgroup> 2686<tbody><tr> 2687<td class="parameter_name"><p>categoryname</p></td> 2688<td class="parameter_description"><p>The category, for ex: <a class="link" href="GstEncodingProfile.html#GST-ENCODING-CATEGORY-DEVICE:CAPS" title="GST_ENCODING_CATEGORY_DEVICE"><span class="type">GST_ENCODING_CATEGORY_DEVICE</span></a>. 2689Can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 2690<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> 2691</tr></tbody> 2692</table></div> 2693</div> 2694<div class="refsect3"> 2695<a name="gst-encoding-list-all-targets.returns"></a><h4>Returns</h4> 2696<p>The list of <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a>. </p> 2697<p><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></p> 2698</div> 2699</div> 2700<hr> 2701<div class="refsect2"> 2702<a name="gst-encoding-list-available-categories"></a><h3>gst_encoding_list_available_categories ()</h3> 2703<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * 2704gst_encoding_list_available_categories 2705 (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> 2706<p>Lists all <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> categories present on disk.</p> 2707<div class="refsect3"> 2708<a name="gst-encoding-list-available-categories.returns"></a><h4>Returns</h4> 2709<p>A list 2710of <a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> categories. </p> 2711<p><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></p> 2712</div> 2713</div> 2714</div> 2715<div class="refsect1"> 2716<a name="GstEncodingProfile.other_details"></a><h2>Types and Values</h2> 2717<div class="refsect2"> 2718<a name="GstEncodingProfile-struct"></a><h3>GstEncodingProfile</h3> 2719<pre class="programlisting">typedef struct _GstEncodingProfile GstEncodingProfile;</pre> 2720<p>The opaque base class object for all encoding profiles. This contains generic 2721information like name, description, format and preset.</p> 2722</div> 2723<hr> 2724<div class="refsect2"> 2725<a name="GstEncodingContainerProfile-struct"></a><h3>GstEncodingContainerProfile</h3> 2726<pre class="programlisting">typedef struct _GstEncodingContainerProfile GstEncodingContainerProfile;</pre> 2727<p>Encoding profiles for containers. Keeps track of a list of <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a></p> 2728</div> 2729<hr> 2730<div class="refsect2"> 2731<a name="GstEncodingAudioProfile-struct"></a><h3>GstEncodingAudioProfile</h3> 2732<pre class="programlisting">typedef struct _GstEncodingAudioProfile GstEncodingAudioProfile;</pre> 2733<p>Variant of <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> for audio streams.</p> 2734</div> 2735<hr> 2736<div class="refsect2"> 2737<a name="GstEncodingVideoProfile-struct"></a><h3>GstEncodingVideoProfile</h3> 2738<pre class="programlisting">typedef struct _GstEncodingVideoProfile GstEncodingVideoProfile;</pre> 2739<p>Variant of <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> for video streams, allows specifying the <em class="parameter"><code>pass</code></em> 2740.</p> 2741</div> 2742<hr> 2743<div class="refsect2"> 2744<a name="GST-ENCODING-CATEGORY-DEVICE:CAPS"></a><h3>GST_ENCODING_CATEGORY_DEVICE</h3> 2745<pre class="programlisting">#define GST_ENCODING_CATEGORY_DEVICE "device" 2746</pre> 2747<p><a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> category for device-specific targets. 2748The name of the target will usually be the constructor and model of the device, 2749and that target will contain <a href="GstEncodingProfile.html#GstEncodingProfile-struct"><span class="type">GstEncodingProfiles</span></a> suitable for that device.</p> 2750</div> 2751<hr> 2752<div class="refsect2"> 2753<a name="GST-ENCODING-CATEGORY-ONLINE-SERVICE:CAPS"></a><h3>GST_ENCODING_CATEGORY_ONLINE_SERVICE</h3> 2754<pre class="programlisting">#define GST_ENCODING_CATEGORY_ONLINE_SERVICE "online-service" 2755</pre> 2756<p><a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> category for online-services. 2757The name of the target will usually be the name of the online service 2758and that target will contain <a href="GstEncodingProfile.html#GstEncodingProfile-struct"><span class="type">GstEncodingProfiles</span></a> suitable for that online 2759service.</p> 2760</div> 2761<hr> 2762<div class="refsect2"> 2763<a name="GST-ENCODING-CATEGORY-STORAGE-EDITING:CAPS"></a><h3>GST_ENCODING_CATEGORY_STORAGE_EDITING</h3> 2764<pre class="programlisting">#define GST_ENCODING_CATEGORY_STORAGE_EDITING "storage-editing" 2765</pre> 2766<p><a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> category for storage, archiving and editing targets. 2767Those targets can be lossless and/or provide very fast random access content. 2768The name of the target will usually be the container type or editing target, 2769and that target will contain <a href="GstEncodingProfile.html#GstEncodingProfile-struct"><span class="type">GstEncodingProfiles</span></a> suitable for editing or 2770storage.</p> 2771</div> 2772<hr> 2773<div class="refsect2"> 2774<a name="GST-ENCODING-CATEGORY-CAPTURE:CAPS"></a><h3>GST_ENCODING_CATEGORY_CAPTURE</h3> 2775<pre class="programlisting">#define GST_ENCODING_CATEGORY_CAPTURE "capture" 2776</pre> 2777<p><a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> category for recording and capture. 2778Targets within this category are optimized for low latency encoding.</p> 2779</div> 2780<hr> 2781<div class="refsect2"> 2782<a name="GST-ENCODING-CATEGORY-FILE-EXTENSION:CAPS"></a><h3>GST_ENCODING_CATEGORY_FILE_EXTENSION</h3> 2783<pre class="programlisting">#define GST_ENCODING_CATEGORY_FILE_EXTENSION "file-extension" 2784</pre> 2785<p><a class="link" href="GstEncodingProfile.html#GstEncodingTarget"><span class="type">GstEncodingTarget</span></a> category for file extensions. 2786The name of the target will be the name of the file extensions possible 2787for a particular target. Those targets are defining like 'default' formats 2788usually used for a particular file extension.</p> 2789</div> 2790<hr> 2791<div class="refsect2"> 2792<a name="GstEncodingTarget-struct"></a><h3>GstEncodingTarget</h3> 2793<pre class="programlisting">typedef struct _GstEncodingTarget GstEncodingTarget;</pre> 2794<p>Collection of <a class="link" href="GstEncodingProfile.html" title="GstEncodingProfile"><span class="type">GstEncodingProfile</span></a> for a specific target or use-case.</p> 2795<p>When being stored/loaded, targets come from a specific category, like 2796<a class="link" href="GstEncodingProfile.html#GST-ENCODING-CATEGORY-DEVICE:CAPS" title="GST_ENCODING_CATEGORY_DEVICE"><span class="type">GST_ENCODING_CATEGORY_DEVICE</span></a>.</p> 2797</div> 2798</div> 2799<div class="refsect1"> 2800<a name="GstEncodingProfile.property-details"></a><h2>Property Details</h2> 2801<div class="refsect2"> 2802<a name="GstEncodingProfile--restriction-caps"></a><h3>The <code class="literal">“restriction-caps”</code> property</h3> 2803<pre class="programlisting"> “restriction-caps” <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> *</pre> 2804<p>The restriction caps to use.</p> 2805<p>Flags: Read / Write</p> 2806</div> 2807</div> 2808</div> 2809<div class="footer"> 2810<hr>Generated by GTK-Doc V1.28</div> 2811</body> 2812</html>
