<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.8"/>
<title>libquicktime: Codec registry</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">libquicktime
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.8 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#groups">Modules</a> |
<a href="#nested-classes">Data Structures</a> |
<a href="#define-members">Macros</a> |
<a href="#enum-members">Enumerations</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">Codec registry</div> </div>
</div><!--header-->
<div class="contents">
<p>Informations about installed codecs.
<a href="#details">More...</a></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="groups"></a>
Modules</h2></td></tr>
<tr class="memitem:group__codec__parameters"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__parameters.html">Structures describing codec parameters</a></td></tr>
<tr class="memdesc:group__codec__parameters"><td class="mdescLeft"> </td><td class="mdescRight">Informations about supported codec parameters. <br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="nested-classes"></a>
Data Structures</h2></td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structlqt__image__size__t.html">lqt_image_size_t</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">Image size. <a href="structlqt__image__size__t.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_s</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">Structure describing a codec. <a href="structlqt__codec__info__s.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="define-members"></a>
Macros</h2></td></tr>
<tr class="memitem:ga7af605e801f00ea391bc27c488cc7b51"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#ga7af605e801f00ea391bc27c488cc7b51">LQT_CODEC_OBSOLETE</a>   (1<<24)</td></tr>
<tr class="memdesc:ga7af605e801f00ea391bc27c488cc7b51"><td class="mdescLeft"> </td><td class="mdescRight">compatibility flags contain this for obsolete/unmaintained codecs <a href="#ga7af605e801f00ea391bc27c488cc7b51">More...</a><br /></td></tr>
<tr class="separator:ga7af605e801f00ea391bc27c488cc7b51"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr class="memitem:ga666566f33a14f9ce02726a890cd27f48"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#ga666566f33a14f9ce02726a890cd27f48">lqt_codec_type</a> { <br />
  <b>LQT_CODEC_AUDIO</b>,
<br />
  <b>LQT_CODEC_VIDEO</b>
<br />
}</td></tr>
<tr class="memdesc:ga666566f33a14f9ce02726a890cd27f48"><td class="mdescLeft"> </td><td class="mdescRight">Type of a codec (Audio or video) <a href="group__codec__registry.html#ga666566f33a14f9ce02726a890cd27f48">More...</a><br /></td></tr>
<tr class="separator:ga666566f33a14f9ce02726a890cd27f48"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gada2743712a049fc81026ac1112deaa39"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#gada2743712a049fc81026ac1112deaa39">lqt_codec_direction</a> { <br />
  <b>LQT_DIRECTION_ENCODE</b>,
<br />
  <b>LQT_DIRECTION_DECODE</b>,
<br />
  <b>LQT_DIRECTION_BOTH</b>
<br />
}</td></tr>
<tr class="memdesc:gada2743712a049fc81026ac1112deaa39"><td class="mdescLeft"> </td><td class="mdescRight">Direction of the codec. <a href="group__codec__registry.html#gada2743712a049fc81026ac1112deaa39">More...</a><br /></td></tr>
<tr class="separator:gada2743712a049fc81026ac1112deaa39"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:gab86c4ef4616e2176309ebface1eecbe3"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#gab86c4ef4616e2176309ebface1eecbe3">lqt_registry_init</a> ()</td></tr>
<tr class="memdesc:gab86c4ef4616e2176309ebface1eecbe3"><td class="mdescLeft"> </td><td class="mdescRight">Initialize the codec registry. <a href="#gab86c4ef4616e2176309ebface1eecbe3">More...</a><br /></td></tr>
<tr class="separator:gab86c4ef4616e2176309ebface1eecbe3"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gafb60ef8e2e4b294f8078d611c0a94ea1"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#gafb60ef8e2e4b294f8078d611c0a94ea1">lqt_registry_destroy</a> ()</td></tr>
<tr class="memdesc:gafb60ef8e2e4b294f8078d611c0a94ea1"><td class="mdescLeft"> </td><td class="mdescRight">Destroy the codec registry. <a href="#gafb60ef8e2e4b294f8078d611c0a94ea1">More...</a><br /></td></tr>
<tr class="separator:gafb60ef8e2e4b294f8078d611c0a94ea1"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga879d475760fefb270ed4c269aeff062e"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#ga879d475760fefb270ed4c269aeff062e">lqt_get_num_audio_codecs</a> ()</td></tr>
<tr class="memdesc:ga879d475760fefb270ed4c269aeff062e"><td class="mdescLeft"> </td><td class="mdescRight">Return the number of installed audio codecs. <a href="#ga879d475760fefb270ed4c269aeff062e">More...</a><br /></td></tr>
<tr class="separator:ga879d475760fefb270ed4c269aeff062e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga5f5d0fa3bd907c3aa8d73de107b0b996"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#ga5f5d0fa3bd907c3aa8d73de107b0b996">lqt_get_num_video_codecs</a> ()</td></tr>
<tr class="memdesc:ga5f5d0fa3bd907c3aa8d73de107b0b996"><td class="mdescLeft"> </td><td class="mdescRight">Return the number of installed video codecs. <a href="#ga5f5d0fa3bd907c3aa8d73de107b0b996">More...</a><br /></td></tr>
<tr class="separator:ga5f5d0fa3bd907c3aa8d73de107b0b996"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga843999c035fcd2c74182bf3d7b1904fd"><td class="memItemLeft" align="right" valign="top">const <a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#ga843999c035fcd2c74182bf3d7b1904fd">lqt_get_audio_codec_info</a> (int index)</td></tr>
<tr class="memdesc:ga843999c035fcd2c74182bf3d7b1904fd"><td class="mdescLeft"> </td><td class="mdescRight">Return an audio codec. <a href="#ga843999c035fcd2c74182bf3d7b1904fd">More...</a><br /></td></tr>
<tr class="separator:ga843999c035fcd2c74182bf3d7b1904fd"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga2e581dd55e2169cc63bae170aa534084"><td class="memItemLeft" align="right" valign="top">const <a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#ga2e581dd55e2169cc63bae170aa534084">lqt_get_video_codec_info</a> (int index)</td></tr>
<tr class="memdesc:ga2e581dd55e2169cc63bae170aa534084"><td class="mdescLeft"> </td><td class="mdescRight">Return a video codec. <a href="#ga2e581dd55e2169cc63bae170aa534084">More...</a><br /></td></tr>
<tr class="separator:ga2e581dd55e2169cc63bae170aa534084"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6b43c181a536ff01922aceb7cfa37945"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> ** </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#ga6b43c181a536ff01922aceb7cfa37945">lqt_query_registry</a> (int audio, int video, int encode, int decode)</td></tr>
<tr class="memdesc:ga6b43c181a536ff01922aceb7cfa37945"><td class="mdescLeft"> </td><td class="mdescRight">Return an array of any combination of audio/video en/decoders. <a href="#ga6b43c181a536ff01922aceb7cfa37945">More...</a><br /></td></tr>
<tr class="separator:ga6b43c181a536ff01922aceb7cfa37945"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga89dfa3661a32eb2f3ce334adae5542f1"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> ** </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#ga89dfa3661a32eb2f3ce334adae5542f1">lqt_find_audio_codec</a> (char *fourcc, int encode)</td></tr>
<tr class="memdesc:ga89dfa3661a32eb2f3ce334adae5542f1"><td class="mdescLeft"> </td><td class="mdescRight">Find an audio codec for a given fourcc. <a href="#ga89dfa3661a32eb2f3ce334adae5542f1">More...</a><br /></td></tr>
<tr class="separator:ga89dfa3661a32eb2f3ce334adae5542f1"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab0358e74db1111c6f5ff54cec5379231"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> ** </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#gab0358e74db1111c6f5ff54cec5379231">lqt_find_audio_codec_by_wav_id</a> (int wav_id, int encode)</td></tr>
<tr class="memdesc:gab0358e74db1111c6f5ff54cec5379231"><td class="mdescLeft"> </td><td class="mdescRight">Find an audio codec for a given WAV ID. <a href="#gab0358e74db1111c6f5ff54cec5379231">More...</a><br /></td></tr>
<tr class="separator:gab0358e74db1111c6f5ff54cec5379231"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf50af3cea023ae052004ad0d0bc52ba5"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> ** </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#gaf50af3cea023ae052004ad0d0bc52ba5">lqt_find_video_codec</a> (char *fourcc, int encode)</td></tr>
<tr class="memdesc:gaf50af3cea023ae052004ad0d0bc52ba5"><td class="mdescLeft"> </td><td class="mdescRight">Find a video codec for a given fourcc. <a href="#gaf50af3cea023ae052004ad0d0bc52ba5">More...</a><br /></td></tr>
<tr class="separator:gaf50af3cea023ae052004ad0d0bc52ba5"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gafd72985ee968f9c483c5d396da20df5c"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> ** </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#gafd72985ee968f9c483c5d396da20df5c">lqt_find_audio_codec_by_name</a> (const char *name)</td></tr>
<tr class="memdesc:gafd72985ee968f9c483c5d396da20df5c"><td class="mdescLeft"> </td><td class="mdescRight">Find an audio codec by its name. <a href="#gafd72985ee968f9c483c5d396da20df5c">More...</a><br /></td></tr>
<tr class="separator:gafd72985ee968f9c483c5d396da20df5c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gabeabc9ef2ce0774c00217f67466b93d6"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> ** </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#gabeabc9ef2ce0774c00217f67466b93d6">lqt_find_video_codec_by_name</a> (const char *name)</td></tr>
<tr class="memdesc:gabeabc9ef2ce0774c00217f67466b93d6"><td class="mdescLeft"> </td><td class="mdescRight">Find a video codec by its name. <a href="#gabeabc9ef2ce0774c00217f67466b93d6">More...</a><br /></td></tr>
<tr class="separator:gabeabc9ef2ce0774c00217f67466b93d6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga8c72d41f05a9ea5900c2d92639fab107"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> ** </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#ga8c72d41f05a9ea5900c2d92639fab107">lqt_audio_codec_from_file</a> (<a class="el" href="group__general.html#gaef65e7300455a3b25eafc7485ec2efa4">quicktime_t</a> *file, int track)</td></tr>
<tr class="memdesc:ga8c72d41f05a9ea5900c2d92639fab107"><td class="mdescLeft"> </td><td class="mdescRight">Get an audio codec from an open file. <a href="#ga8c72d41f05a9ea5900c2d92639fab107">More...</a><br /></td></tr>
<tr class="separator:ga8c72d41f05a9ea5900c2d92639fab107"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gada83efef8795f398f2436c14776c1e98"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> ** </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#gada83efef8795f398f2436c14776c1e98">lqt_video_codec_from_file</a> (<a class="el" href="group__general.html#gaef65e7300455a3b25eafc7485ec2efa4">quicktime_t</a> *file, int track)</td></tr>
<tr class="memdesc:gada83efef8795f398f2436c14776c1e98"><td class="mdescLeft"> </td><td class="mdescRight">Get a video codec from an open file. <a href="#gada83efef8795f398f2436c14776c1e98">More...</a><br /></td></tr>
<tr class="separator:gada83efef8795f398f2436c14776c1e98"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6141bf49151d80de0e4483cbb30d2307"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#ga6141bf49151d80de0e4483cbb30d2307">lqt_destroy_codec_info</a> (<a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> **info)</td></tr>
<tr class="memdesc:ga6141bf49151d80de0e4483cbb30d2307"><td class="mdescLeft"> </td><td class="mdescRight">Destroy a codec info array. <a href="#ga6141bf49151d80de0e4483cbb30d2307">More...</a><br /></td></tr>
<tr class="separator:ga6141bf49151d80de0e4483cbb30d2307"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gac0f93373530d9cd4be395fe4c9a27d6e"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#gac0f93373530d9cd4be395fe4c9a27d6e">lqt_reorder_audio_codecs</a> (<a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> **codec_info)</td></tr>
<tr class="memdesc:gac0f93373530d9cd4be395fe4c9a27d6e"><td class="mdescLeft"> </td><td class="mdescRight">Reorder audio codecs. <a href="#gac0f93373530d9cd4be395fe4c9a27d6e">More...</a><br /></td></tr>
<tr class="separator:gac0f93373530d9cd4be395fe4c9a27d6e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf59f82c40f0daf2c067286b9edf9e5ba"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#gaf59f82c40f0daf2c067286b9edf9e5ba">lqt_reorder_video_codecs</a> (<a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> **codec_info)</td></tr>
<tr class="memdesc:gaf59f82c40f0daf2c067286b9edf9e5ba"><td class="mdescLeft"> </td><td class="mdescRight">Reorder video codecs. <a href="#gaf59f82c40f0daf2c067286b9edf9e5ba">More...</a><br /></td></tr>
<tr class="separator:gaf59f82c40f0daf2c067286b9edf9e5ba"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga61c8f13425967adb60d2bfeae90abcff"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#ga61c8f13425967adb60d2bfeae90abcff">lqt_set_default_parameter</a> (<a class="el" href="group__codec__registry.html#ga666566f33a14f9ce02726a890cd27f48">lqt_codec_type</a> type, int encode, const char *codec_name, const char *parameter_name, <a class="el" href="unionlqt__parameter__value__t.html">lqt_parameter_value_t</a> *val)</td></tr>
<tr class="memdesc:ga61c8f13425967adb60d2bfeae90abcff"><td class="mdescLeft"> </td><td class="mdescRight">Change a default value for a codec parameter. <a href="#ga61c8f13425967adb60d2bfeae90abcff">More...</a><br /></td></tr>
<tr class="separator:ga61c8f13425967adb60d2bfeae90abcff"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga62de262c4d2ecea6ffe3bb5cad324026"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#ga62de262c4d2ecea6ffe3bb5cad324026">lqt_restore_default_parameters</a> (<a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> *codec_info, int encode, int decode)</td></tr>
<tr class="memdesc:ga62de262c4d2ecea6ffe3bb5cad324026"><td class="mdescLeft"> </td><td class="mdescRight">Restore a default parameter from the codec module. <a href="#ga62de262c4d2ecea6ffe3bb5cad324026">More...</a><br /></td></tr>
<tr class="separator:ga62de262c4d2ecea6ffe3bb5cad324026"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga9f3ff979c01a06f6d9752c4a2e28d4a1"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codec__registry.html#ga9f3ff979c01a06f6d9752c4a2e28d4a1">lqt_dump_codec_info</a> (const <a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> *info)</td></tr>
<tr class="memdesc:ga9f3ff979c01a06f6d9752c4a2e28d4a1"><td class="mdescLeft"> </td><td class="mdescRight">Dump a codec info to stderr. <a href="#ga9f3ff979c01a06f6d9752c4a2e28d4a1">More...</a><br /></td></tr>
<tr class="separator:ga9f3ff979c01a06f6d9752c4a2e28d4a1"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<p>Informations about installed codecs. </p>
<p>One of the goals when forking libquicktime was to have a modular structure. Codecs were moved to plugins and were compiled according to the dependencies found by the configure script. As a result, a mechanism became necessary for finding informations about available codecs at runtime, their properties, supported parameters etc.</p>
<p>The codec parameters are defined in a way that GUI configuration dialogs can be built at runtime. An example for this is the libquicktime_config utility.</p>
<p>Libquicktime saves data of the codecs in the file .libquicktime_codecs in your home directory. This saves the long time needed for opening each codec module to see what's inside. The codec registry can be configured with the libquicktime_config program. </p>
<h2 class="groupheader">Macro Definition Documentation</h2>
<a class="anchor" id="ga7af605e801f00ea391bc27c488cc7b51"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define LQT_CODEC_OBSOLETE   (1<<24)</td>
</tr>
</table>
</div><div class="memdoc">
<p>compatibility flags contain this for obsolete/unmaintained codecs </p>
</div>
</div>
<h2 class="groupheader">Enumeration Type Documentation</h2>
<a class="anchor" id="ga666566f33a14f9ce02726a890cd27f48"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="group__codec__registry.html#ga666566f33a14f9ce02726a890cd27f48">lqt_codec_type</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Type of a codec (Audio or video) </p>
</div>
</div>
<a class="anchor" id="gada2743712a049fc81026ac1112deaa39"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="group__codec__registry.html#gada2743712a049fc81026ac1112deaa39">lqt_codec_direction</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Direction of the codec. </p>
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a class="anchor" id="gab86c4ef4616e2176309ebface1eecbe3"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_registry_init </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Initialize the codec registry. </p>
<p>Under normal circumstances, you never need to call this function, since the registry is always initialized on demand. </p>
</div>
</div>
<a class="anchor" id="gafb60ef8e2e4b294f8078d611c0a94ea1"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_registry_destroy </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Destroy the codec registry. </p>
<p>This frees memory for the whole codec database. It is normally called automatically, but you will need to call it exclicitely, if you want to reinitialize the codec registry at runtime </p>
</div>
</div>
<a class="anchor" id="ga879d475760fefb270ed4c269aeff062e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int lqt_get_num_audio_codecs </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Return the number of installed audio codecs. </p>
<dl class="section return"><dt>Returns</dt><dd>Number of installed audio codecs</dd></dl>
<p>This function is obsolete, use <a class="el" href="group__codec__registry.html#ga6b43c181a536ff01922aceb7cfa37945">lqt_query_registry</a> instead </p>
</div>
</div>
<a class="anchor" id="ga5f5d0fa3bd907c3aa8d73de107b0b996"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int lqt_get_num_video_codecs </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Return the number of installed video codecs. </p>
<dl class="section return"><dt>Returns</dt><dd>Number of installed video codecs</dd></dl>
<p>This function is obsolete, use <a class="el" href="group__codec__registry.html#ga6b43c181a536ff01922aceb7cfa37945">lqt_query_registry</a> instead </p>
</div>
</div>
<a class="anchor" id="ga843999c035fcd2c74182bf3d7b1904fd"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a>* lqt_get_audio_codec_info </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>index</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Return an audio codec. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">index</td><td>Index of the codec </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Pointer to the codec info in the internal database</dd></dl>
<p>This function is obsolete, use <a class="el" href="group__codec__registry.html#ga6b43c181a536ff01922aceb7cfa37945">lqt_query_registry</a> instead </p>
</div>
</div>
<a class="anchor" id="ga2e581dd55e2169cc63bae170aa534084"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a>* lqt_get_video_codec_info </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>index</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Return a video codec. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">index</td><td>Index of the codec </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Pointer to the codec info in the internal database</dd></dl>
<p>This function is obsolete, use <a class="el" href="group__codec__registry.html#ga6b43c181a536ff01922aceb7cfa37945">lqt_query_registry</a> instead </p>
</div>
</div>
<a class="anchor" id="ga6b43c181a536ff01922aceb7cfa37945"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a>** lqt_query_registry </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>audio</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>video</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>encode</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>decode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Return an array of any combination of audio/video en/decoders. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">audio</td><td>Set this to 1 if you want audio codecs to be returned </td></tr>
<tr><td class="paramname">video</td><td>Set this to 1 if you want video codecs to be returned </td></tr>
<tr><td class="paramname">encode</td><td>Set this to 1 if you want encoders to be returned </td></tr>
<tr><td class="paramname">decode</td><td>Set this to 1 if you want decoders to be returned </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A NULL terminated array of codec infos.</dd></dl>
<p>This function copies the codec infos. Use <a class="el" href="group__codec__registry.html#ga6141bf49151d80de0e4483cbb30d2307">lqt_destroy_codec_info</a> to free the returned array. </p>
</div>
</div>
<a class="anchor" id="ga89dfa3661a32eb2f3ce334adae5542f1"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a>** lqt_find_audio_codec </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"><em>fourcc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>encode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find an audio codec for a given fourcc. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">fourcc</td><td>A four character code </td></tr>
<tr><td class="paramname">encode</td><td>Set to 1 to return encoders, 0 to return decoders </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A NULL terminated array containing one codec info if the codec was found</dd></dl>
<p>This function copies the codec info. Use <a class="el" href="group__codec__registry.html#ga6141bf49151d80de0e4483cbb30d2307">lqt_destroy_codec_info</a> to free the returned array. </p>
</div>
</div>
<a class="anchor" id="gab0358e74db1111c6f5ff54cec5379231"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a>** lqt_find_audio_codec_by_wav_id </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>wav_id</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>encode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find an audio codec for a given WAV ID. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">wav_id</td><td>A 16 bit audio codec ID as found in WAV and AVI files </td></tr>
<tr><td class="paramname">encode</td><td>Set to 1 to return encoders, 0 to return decoders </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A NULL terminated array containing one codec info if the codec was found</dd></dl>
<p>This function copies the codec info. Use <a class="el" href="group__codec__registry.html#ga6141bf49151d80de0e4483cbb30d2307">lqt_destroy_codec_info</a> to free the returned array. </p>
</div>
</div>
<a class="anchor" id="gaf50af3cea023ae052004ad0d0bc52ba5"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a>** lqt_find_video_codec </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"><em>fourcc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>encode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find a video codec for a given fourcc. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">fourcc</td><td>A four character code </td></tr>
<tr><td class="paramname">encode</td><td>Set to 1 to return encoders, 0 to return decoders </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A NULL terminated array containing one codec info if the codec was found</dd></dl>
<p>This function copies the codec info. Use <a class="el" href="group__codec__registry.html#ga6141bf49151d80de0e4483cbb30d2307">lqt_destroy_codec_info</a> to free the returned array. </p>
</div>
</div>
<a class="anchor" id="gafd72985ee968f9c483c5d396da20df5c"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a>** lqt_find_audio_codec_by_name </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>name</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find an audio codec by its name. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>Short name of the codec (see <a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_s</a>) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A NULL terminated array containing one codec info if the codec was found</dd></dl>
<p>This function copies the codec info. Use <a class="el" href="group__codec__registry.html#ga6141bf49151d80de0e4483cbb30d2307">lqt_destroy_codec_info</a> to free the returned array. </p>
</div>
</div>
<a class="anchor" id="gabeabc9ef2ce0774c00217f67466b93d6"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a>** lqt_find_video_codec_by_name </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>name</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find a video codec by its name. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>Short name of the codec (see <a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_s</a>) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A NULL terminated array containing one codec info if the codec was found</dd></dl>
<p>This function copies the codec info. Use <a class="el" href="group__codec__registry.html#ga6141bf49151d80de0e4483cbb30d2307">lqt_destroy_codec_info</a> to free the returned array. </p>
</div>
</div>
<a class="anchor" id="ga8c72d41f05a9ea5900c2d92639fab107"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a>** lqt_audio_codec_from_file </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__general.html#gaef65e7300455a3b25eafc7485ec2efa4">quicktime_t</a> * </td>
<td class="paramname"><em>file</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>track</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get an audio codec from an open file. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">file</td><td>A quicktime handle </td></tr>
<tr><td class="paramname">track</td><td>Index if the track (starting with 0) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A NULL terminated array containing one codec info if the codec was found</dd></dl>
<p>This function copies the codec info. Use <a class="el" href="group__codec__registry.html#ga6141bf49151d80de0e4483cbb30d2307">lqt_destroy_codec_info</a> to free the returned array. </p>
</div>
</div>
<a class="anchor" id="gada83efef8795f398f2436c14776c1e98"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a>** lqt_video_codec_from_file </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__general.html#gaef65e7300455a3b25eafc7485ec2efa4">quicktime_t</a> * </td>
<td class="paramname"><em>file</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>track</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get a video codec from an open file. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">file</td><td>A quicktime handle </td></tr>
<tr><td class="paramname">track</td><td>Index if the track (starting with 0) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A NULL terminated array containing one codec info if the codec was found</dd></dl>
<p>This function copies the codec info. Use <a class="el" href="group__codec__registry.html#ga6141bf49151d80de0e4483cbb30d2307">lqt_destroy_codec_info</a> to free the returned array. </p>
</div>
</div>
<a class="anchor" id="ga6141bf49151d80de0e4483cbb30d2307"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_destroy_codec_info </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> ** </td>
<td class="paramname"><em>info</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Destroy a codec info array. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">info</td><td>A NULL terminated array of codec infos returned by one of the query functions.</td></tr>
</table>
</dd>
</dl>
<p>Destroys a NULL terminared codec info structure returned by any of the query functions and frees all associated memory. </p>
</div>
</div>
<a class="anchor" id="gac0f93373530d9cd4be395fe4c9a27d6e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_reorder_audio_codecs </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> ** </td>
<td class="paramname"><em>codec_info</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Reorder audio codecs. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">codec_info</td><td>A NULL terminated array of codec infos</td></tr>
</table>
</dd>
</dl>
<p>The codec order is important if there is more than one codec available for a given fourcc. In this case, the first one will be used. You can simply call <a class="el" href="group__codec__registry.html#ga6b43c181a536ff01922aceb7cfa37945">lqt_query_registry</a> for getting audio codecs, reorder the returned array and pass this to the functions below. </p>
</div>
</div>
<a class="anchor" id="gaf59f82c40f0daf2c067286b9edf9e5ba"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_reorder_video_codecs </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> ** </td>
<td class="paramname"><em>codec_info</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Reorder video codecs. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">codec_info</td><td>A NULL terminated array of codec infos</td></tr>
</table>
</dd>
</dl>
<p>The codec order is important if there is more than one codec available for a given fourcc. In this case, the first one will be used. You can simply call <a class="el" href="group__codec__registry.html#ga6b43c181a536ff01922aceb7cfa37945">lqt_query_registry</a> for getting video codecs, reorder the returned array and pass this to the functions below. </p>
</div>
</div>
<a class="anchor" id="ga61c8f13425967adb60d2bfeae90abcff"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_set_default_parameter </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__codec__registry.html#ga666566f33a14f9ce02726a890cd27f48">lqt_codec_type</a> </td>
<td class="paramname"><em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>encode</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>codec_name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>parameter_name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="unionlqt__parameter__value__t.html">lqt_parameter_value_t</a> * </td>
<td class="paramname"><em>val</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Change a default value for a codec parameter. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">type</td><td>The type of the codec (audio or video) </td></tr>
<tr><td class="paramname">encode</td><td>1 for encode parameter, 0 for decode parameter </td></tr>
<tr><td class="paramname">codec_name</td><td>The short name of the codec </td></tr>
<tr><td class="paramname">parameter_name</td><td>The short name of the parameter to change </td></tr>
<tr><td class="paramname">val</td><td>The new value for the parameter</td></tr>
</table>
</dd>
</dl>
<p>This stores a new default parameter value in the codec registry. It will become the new default for all files, you open after. This will also be saved in $HOME/.libquicktime_config. </p>
</div>
</div>
<a class="anchor" id="ga62de262c4d2ecea6ffe3bb5cad324026"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_restore_default_parameters </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> * </td>
<td class="paramname"><em>codec_info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>encode</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>decode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Restore a default parameter from the codec module. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">codec_info</td><td>A codec info referring to the codec </td></tr>
<tr><td class="paramname">encode</td><td>Set this to 1 to restore encoding parameters, 0 else </td></tr>
<tr><td class="paramname">decode</td><td>Set this to 1 to restore decoding parameters, 0 else</td></tr>
</table>
</dd>
</dl>
<p>This will revert previous calls to <a class="el" href="group__codec__registry.html#ga61c8f13425967adb60d2bfeae90abcff">lqt_set_default_parameter</a> by loading the module and getting the hardcoded values. </p>
</div>
</div>
<a class="anchor" id="ga9f3ff979c01a06f6d9752c4a2e28d4a1"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_dump_codec_info </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="structlqt__codec__info__s.html">lqt_codec_info_t</a> * </td>
<td class="paramname"><em>info</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Dump a codec info to stderr. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">info</td><td>A codec info</td></tr>
</table>
</dd>
</dl>
<p>Dump a human readable description of the codec info to stderr. For testing and debugging only. </p>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Fri Nov 14 2014 10:17:40 for libquicktime by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.8
</small></address>
</body>
</html>
distrib
>
Mageia
>
5
>
i586
>
media
>
core-release
>
by-pkgid
>
5454ba28c7567121ad5a74a4d6d1333a
>
files
>
53
