<!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: Video</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="#enum-members">Enumerations</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">Video</div> </div>
</div><!--header-->
<div class="contents">
<p>Video related definitions and functions.
<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__video__decode"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video__decode.html">Video decoding</a></td></tr>
<tr class="memdesc:group__video__decode"><td class="mdescLeft"> </td><td class="mdescRight">Video related definitions and functions (reading) <br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:group__video__encode"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video__encode.html">Video encoding</a></td></tr>
<tr class="memdesc:group__video__encode"><td class="mdescLeft"> </td><td class="mdescRight">Video related definitions and functions (writing) <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="enum-members"></a>
Enumerations</h2></td></tr>
<tr class="memitem:ga58950c90660f8709fa724f19afe83c7b"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video.html#ga58950c90660f8709fa724f19afe83c7b">lqt_interlace_mode_t</a> { <br />
  <a class="el" href="group__video.html#gga58950c90660f8709fa724f19afe83c7bacb07470be4c1d9e75f43793cd435410e">LQT_INTERLACE_NONE</a> = 0,
<br />
  <a class="el" href="group__video.html#gga58950c90660f8709fa724f19afe83c7ba9d808f083652c8e6315f65ace4f8cf58">LQT_INTERLACE_TOP_FIRST</a>,
<br />
  <a class="el" href="group__video.html#gga58950c90660f8709fa724f19afe83c7bae623d0817d9164618ad8a2018c39983a">LQT_INTERLACE_BOTTOM_FIRST</a>
<br />
}</td></tr>
<tr class="memdesc:ga58950c90660f8709fa724f19afe83c7b"><td class="mdescLeft"> </td><td class="mdescRight">interlace modes <a href="group__video.html#ga58950c90660f8709fa724f19afe83c7b">More...</a><br /></td></tr>
<tr class="separator:ga58950c90660f8709fa724f19afe83c7b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga29e261e843838c4509b4223e7a825516"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video.html#ga29e261e843838c4509b4223e7a825516">lqt_chroma_placement_t</a> { <br />
  <a class="el" href="group__video.html#gga29e261e843838c4509b4223e7a825516a1dde2930c75c1a7cc3863c052bc389cb">LQT_CHROMA_PLACEMENT_DEFAULT</a> = 0,
<br />
  <a class="el" href="group__video.html#gga29e261e843838c4509b4223e7a825516aef405c345a902ae3cc3e20e24381ecae">LQT_CHROMA_PLACEMENT_MPEG2</a>,
<br />
  <a class="el" href="group__video.html#gga29e261e843838c4509b4223e7a825516a1af8a6f7e0f074ba22e8625d0f3d0696">LQT_CHROMA_PLACEMENT_DVPAL</a>
<br />
}</td></tr>
<tr class="memdesc:ga29e261e843838c4509b4223e7a825516"><td class="mdescLeft"> </td><td class="mdescRight">Chroma placement. <a href="group__video.html#ga29e261e843838c4509b4223e7a825516">More...</a><br /></td></tr>
<tr class="separator:ga29e261e843838c4509b4223e7a825516"><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:gaf44128ec17fe3c167c36ac6491be6dff"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video.html#gaf44128ec17fe3c167c36ac6491be6dff">quicktime_set_cmodel</a> (<a class="el" href="group__general.html#gaef65e7300455a3b25eafc7485ec2efa4">quicktime_t</a> *file, int colormodel)</td></tr>
<tr class="memdesc:gaf44128ec17fe3c167c36ac6491be6dff"><td class="mdescLeft"> </td><td class="mdescRight">Set the colormodel for en-/decoding. <a href="#gaf44128ec17fe3c167c36ac6491be6dff">More...</a><br /></td></tr>
<tr class="separator:gaf44128ec17fe3c167c36ac6491be6dff"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga57604576bcdf178afb9023bc194dc12f"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video.html#ga57604576bcdf178afb9023bc194dc12f">quicktime_set_row_span</a> (<a class="el" href="group__general.html#gaef65e7300455a3b25eafc7485ec2efa4">quicktime_t</a> *file, int row_span)</td></tr>
<tr class="memdesc:ga57604576bcdf178afb9023bc194dc12f"><td class="mdescLeft"> </td><td class="mdescRight">Set the row_span for en-/decoding. <a href="#ga57604576bcdf178afb9023bc194dc12f">More...</a><br /></td></tr>
<tr class="separator:ga57604576bcdf178afb9023bc194dc12f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga80672f881bf783060c467c5e4054e8da"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video.html#ga80672f881bf783060c467c5e4054e8da">lqt_set_video_parameter</a> (<a class="el" href="group__general.html#gaef65e7300455a3b25eafc7485ec2efa4">quicktime_t</a> *file, int track, const char *key, const void *value)</td></tr>
<tr class="memdesc:ga80672f881bf783060c467c5e4054e8da"><td class="mdescLeft"> </td><td class="mdescRight">Set a codec parameter for a video track. <a href="#ga80672f881bf783060c467c5e4054e8da">More...</a><br /></td></tr>
<tr class="separator:ga80672f881bf783060c467c5e4054e8da"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga5b74e970a99330005d1250102b8452a9"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video.html#ga5b74e970a99330005d1250102b8452a9">lqt_interlace_mode_to_string</a> (<a class="el" href="group__video.html#ga58950c90660f8709fa724f19afe83c7b">lqt_interlace_mode_t</a> mode)</td></tr>
<tr class="memdesc:ga5b74e970a99330005d1250102b8452a9"><td class="mdescLeft"> </td><td class="mdescRight">Convert an interlace mode to a human readable string. <a href="#ga5b74e970a99330005d1250102b8452a9">More...</a><br /></td></tr>
<tr class="separator:ga5b74e970a99330005d1250102b8452a9"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6b4afa2a6c0c13ba4887b1f9bde3c175"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video.html#ga6b4afa2a6c0c13ba4887b1f9bde3c175">lqt_chroma_placement_to_string</a> (<a class="el" href="group__video.html#ga29e261e843838c4509b4223e7a825516">lqt_chroma_placement_t</a> chroma_placement)</td></tr>
<tr class="memdesc:ga6b4afa2a6c0c13ba4887b1f9bde3c175"><td class="mdescLeft"> </td><td class="mdescRight">Convert a chroma placement to a human readable string. <a href="#ga6b4afa2a6c0c13ba4887b1f9bde3c175">More...</a><br /></td></tr>
<tr class="separator:ga6b4afa2a6c0c13ba4887b1f9bde3c175"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga128d549ba1e29083ab61f3425ae6350d"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video.html#ga128d549ba1e29083ab61f3425ae6350d">lqt_get_best_colormodel</a> (<a class="el" href="group__general.html#gaef65e7300455a3b25eafc7485ec2efa4">quicktime_t</a> *file, int track, int *supported)</td></tr>
<tr class="memdesc:ga128d549ba1e29083ab61f3425ae6350d"><td class="mdescLeft"> </td><td class="mdescRight">Get the best colormodel out of a list of supported colormodels. <a href="#ga128d549ba1e29083ab61f3425ae6350d">More...</a><br /></td></tr>
<tr class="separator:ga128d549ba1e29083ab61f3425ae6350d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga7053978f505b771b36fc27892721d032"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video.html#ga7053978f505b771b36fc27892721d032">lqt_get_cmodel</a> (<a class="el" href="group__general.html#gaef65e7300455a3b25eafc7485ec2efa4">quicktime_t</a> *file, int track)</td></tr>
<tr class="memdesc:ga7053978f505b771b36fc27892721d032"><td class="mdescLeft"> </td><td class="mdescRight">Get the colormodel, which will be valid for the next en-/decode call. <a href="#ga7053978f505b771b36fc27892721d032">More...</a><br /></td></tr>
<tr class="separator:ga7053978f505b771b36fc27892721d032"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga57ce679a75a23aac4009bfb1cbf3a2fa"><td class="memItemLeft" align="right" valign="top">uint8_t ** </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video.html#ga57ce679a75a23aac4009bfb1cbf3a2fa">lqt_rows_alloc</a> (int width, int height, int colormodel, int *rowspan, int *rowspan_uv)</td></tr>
<tr class="memdesc:ga57ce679a75a23aac4009bfb1cbf3a2fa"><td class="mdescLeft"> </td><td class="mdescRight">Allocate a frame buffer for use with libquicktime. <a href="#ga57ce679a75a23aac4009bfb1cbf3a2fa">More...</a><br /></td></tr>
<tr class="separator:ga57ce679a75a23aac4009bfb1cbf3a2fa"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaae1a660f8ca20b7c44194aaf591f190d"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video.html#gaae1a660f8ca20b7c44194aaf591f190d">lqt_rows_copy</a> (uint8_t **out_rows, uint8_t **in_rows, int width, int height, int in_rowspan, int in_rowspan_uv, int out_rowspan, int out_rowspan_uv, int colormodel)</td></tr>
<tr class="memdesc:gaae1a660f8ca20b7c44194aaf591f190d"><td class="mdescLeft"> </td><td class="mdescRight">Copy a video frame. <a href="#gaae1a660f8ca20b7c44194aaf591f190d">More...</a><br /></td></tr>
<tr class="separator:gaae1a660f8ca20b7c44194aaf591f190d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaedcd9eba19c17deff86dea3eb38af92d"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video.html#gaedcd9eba19c17deff86dea3eb38af92d">lqt_rows_copy_sub</a> (uint8_t **out_rows, uint8_t **in_rows, int width, int height, int in_rowspan, int in_rowspan_uv, int out_rowspan, int out_rowspan_uv, int colormodel, int src_x, int src_y, int dst_x, int dst_y)</td></tr>
<tr class="memdesc:gaedcd9eba19c17deff86dea3eb38af92d"><td class="mdescLeft"> </td><td class="mdescRight">Copy a subrectangle video frame. <a href="#gaedcd9eba19c17deff86dea3eb38af92d">More...</a><br /></td></tr>
<tr class="separator:gaedcd9eba19c17deff86dea3eb38af92d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga1a11529f6335f3e93191ee296ff8a640"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video.html#ga1a11529f6335f3e93191ee296ff8a640">lqt_rows_clear</a> (uint8_t **rows, int width, int height, int rowspan, int rowspan_uv, int colormodel)</td></tr>
<tr class="memdesc:ga1a11529f6335f3e93191ee296ff8a640"><td class="mdescLeft"> </td><td class="mdescRight">Clear a video frame. <a href="#ga1a11529f6335f3e93191ee296ff8a640">More...</a><br /></td></tr>
<tr class="separator:ga1a11529f6335f3e93191ee296ff8a640"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga9920f7ec0a8081faf57a77d93c474b32"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video.html#ga9920f7ec0a8081faf57a77d93c474b32">lqt_rows_free</a> (uint8_t **rows)</td></tr>
<tr class="memdesc:ga9920f7ec0a8081faf57a77d93c474b32"><td class="mdescLeft"> </td><td class="mdescRight">Free a frame allocated by <a class="el" href="group__video.html#ga57ce679a75a23aac4009bfb1cbf3a2fa">lqt_rows_alloc</a>. <a href="#ga9920f7ec0a8081faf57a77d93c474b32">More...</a><br /></td></tr>
<tr class="separator:ga9920f7ec0a8081faf57a77d93c474b32"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6d65bc0c73130f73da12379d8f428cdc"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video.html#ga6d65bc0c73130f73da12379d8f428cdc">lqt_set_cmodel</a> (<a class="el" href="group__general.html#gaef65e7300455a3b25eafc7485ec2efa4">quicktime_t</a> *file, int track, int colormodel)</td></tr>
<tr class="memdesc:ga6d65bc0c73130f73da12379d8f428cdc"><td class="mdescLeft"> </td><td class="mdescRight">Set the colormodel for en-/decoding. <a href="#ga6d65bc0c73130f73da12379d8f428cdc">More...</a><br /></td></tr>
<tr class="separator:ga6d65bc0c73130f73da12379d8f428cdc"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga74cb491bf21df93ba971caf92d641a98"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video.html#ga74cb491bf21df93ba971caf92d641a98">lqt_set_row_span</a> (<a class="el" href="group__general.html#gaef65e7300455a3b25eafc7485ec2efa4">quicktime_t</a> *file, int track, int row_span)</td></tr>
<tr class="memdesc:ga74cb491bf21df93ba971caf92d641a98"><td class="mdescLeft"> </td><td class="mdescRight">Set the row span for the luma plane. <a href="#ga74cb491bf21df93ba971caf92d641a98">More...</a><br /></td></tr>
<tr class="separator:ga74cb491bf21df93ba971caf92d641a98"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga65538f230c191a361ca894883e7e3752"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__video.html#ga65538f230c191a361ca894883e7e3752">lqt_set_row_span_uv</a> (<a class="el" href="group__general.html#gaef65e7300455a3b25eafc7485ec2efa4">quicktime_t</a> *file, int track, int row_span_uv)</td></tr>
<tr class="memdesc:ga65538f230c191a361ca894883e7e3752"><td class="mdescLeft"> </td><td class="mdescRight">Set the row span for the chroma planes. <a href="#ga65538f230c191a361ca894883e7e3752">More...</a><br /></td></tr>
<tr class="separator:ga65538f230c191a361ca894883e7e3752"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<p>Video related definitions and functions. </p>
<h2 class="groupheader">Enumeration Type Documentation</h2>
<a class="anchor" id="ga58950c90660f8709fa724f19afe83c7b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="group__video.html#ga58950c90660f8709fa724f19afe83c7b">lqt_interlace_mode_t</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>interlace modes </p>
<p>This is the interlace mode of a video track. Read it with <a class="el" href="group__video__decode.html#ga04f3591187e13cc2c6828ff82c02acad">lqt_get_interlace_mode</a> . </p>
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a class="anchor" id="gga58950c90660f8709fa724f19afe83c7bacb07470be4c1d9e75f43793cd435410e"></a>LQT_INTERLACE_NONE </td><td class="fielddoc">
<p>No interlacing (= progressive) </p>
</td></tr>
<tr><td class="fieldname"><a class="anchor" id="gga58950c90660f8709fa724f19afe83c7ba9d808f083652c8e6315f65ace4f8cf58"></a>LQT_INTERLACE_TOP_FIRST </td><td class="fielddoc">
<p>Top field first </p>
</td></tr>
<tr><td class="fieldname"><a class="anchor" id="gga58950c90660f8709fa724f19afe83c7bae623d0817d9164618ad8a2018c39983a"></a>LQT_INTERLACE_BOTTOM_FIRST </td><td class="fielddoc">
<p>Bottom field first </p>
</td></tr>
</table>
</div>
</div>
<a class="anchor" id="ga29e261e843838c4509b4223e7a825516"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="group__video.html#ga29e261e843838c4509b4223e7a825516">lqt_chroma_placement_t</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Chroma placement. </p>
<p>This describes the chroma placement of a video track. Read it with <a class="el" href="group__video__decode.html#ga1679de33e938d9f9bcc7d670cadaecde">lqt_get_chroma_placement</a> . Chroma placement makes only sense for YUV420 formats. For other pixelformats, it is set implicitely to LQT_CHROMA_PLACEMENT_DEFAULT. </p>
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a class="anchor" id="gga29e261e843838c4509b4223e7a825516a1dde2930c75c1a7cc3863c052bc389cb"></a>LQT_CHROMA_PLACEMENT_DEFAULT </td><td class="fielddoc">
<p>MPEG-1, JPEG or non 4:2:0 </p>
</td></tr>
<tr><td class="fieldname"><a class="anchor" id="gga29e261e843838c4509b4223e7a825516aef405c345a902ae3cc3e20e24381ecae"></a>LQT_CHROMA_PLACEMENT_MPEG2 </td><td class="fielddoc">
<p>MPEG-2 </p>
</td></tr>
<tr><td class="fieldname"><a class="anchor" id="gga29e261e843838c4509b4223e7a825516a1af8a6f7e0f074ba22e8625d0f3d0696"></a>LQT_CHROMA_PLACEMENT_DVPAL </td><td class="fielddoc">
<p>DV PAL </p>
</td></tr>
</table>
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a class="anchor" id="gaf44128ec17fe3c167c36ac6491be6dff"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void quicktime_set_cmodel </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>colormodel</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the colormodel for en-/decoding. </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">colormodel</td><td>The colormodel to use.</td></tr>
</table>
</dd>
</dl>
<p>This sets the colormodels for all video tracks at once. It's a better idea to use <a class="el" href="group__video.html#ga6d65bc0c73130f73da12379d8f428cdc">lqt_set_cmodel</a> instead. </p>
</div>
</div>
<a class="anchor" id="ga57604576bcdf178afb9023bc194dc12f"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void quicktime_set_row_span </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>row_span</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the row_span for en-/decoding. </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">row_span</td><td>The rowspan to use.</td></tr>
</table>
</dd>
</dl>
<p>This sets the rowspans for all video tracks at once. It's a better idea to use <a class="el" href="group__video.html#ga74cb491bf21df93ba971caf92d641a98">lqt_set_row_span</a> and <a class="el" href="group__video.html#ga65538f230c191a361ca894883e7e3752">lqt_set_row_span_uv</a> instead. </p>
</div>
</div>
<a class="anchor" id="ga80672f881bf783060c467c5e4054e8da"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_set_video_parameter </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 class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const void * </td>
<td class="paramname"><em>value</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set a codec parameter for a video track. </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>Track index (starting with 0) </td></tr>
<tr><td class="paramname">key</td><td>Short name of the parameter </td></tr>
<tr><td class="paramname">value</td><td>Parameter value.</td></tr>
</table>
</dd>
</dl>
<p>For integer parameters, value must be of the type int*. For string parameters, use char*. For floating-point parameters, use float*. </p>
</div>
</div>
<a class="anchor" id="ga5b74e970a99330005d1250102b8452a9"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* lqt_interlace_mode_to_string </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__video.html#ga58950c90660f8709fa724f19afe83c7b">lqt_interlace_mode_t</a> </td>
<td class="paramname"><em>mode</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Convert an interlace mode to a human readable string. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">mode</td><td>An interlace mode </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A description of the interlace mode </dd></dl>
</div>
</div>
<a class="anchor" id="ga6b4afa2a6c0c13ba4887b1f9bde3c175"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* lqt_chroma_placement_to_string </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__video.html#ga29e261e843838c4509b4223e7a825516">lqt_chroma_placement_t</a> </td>
<td class="paramname"><em>chroma_placement</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Convert a chroma placement to a human readable string. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">chroma_placement</td><td>A chroma placement </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A description of the chroma placement </dd></dl>
</div>
</div>
<a class="anchor" id="ga128d549ba1e29083ab61f3425ae6350d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int lqt_get_best_colormodel </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 class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>supported</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the best colormodel out of a list of supported colormodels. </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>Track index (starting with 0) </td></tr>
<tr><td class="paramname">supported</td><td>An array with supported colormodels. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The best colormodel</dd></dl>
<p>This is a convenience function for application developers: It takes an array with supported colormodels (Terminated with LQT_COLORMODEL_NONE) and returns the best colormodel. The decision is done according to the conversion overhead. i.e. you'll get the colormodel of your list, which is "closest" to the colormodel, the codec delivers. To make sure, that this function never fails, you should at least support <a class="el" href="group__color.html#gaaec2dd466403410fc4daa417ec2ab6c6">BC_RGB888</a> . This function works for en- and decoding. </p>
</div>
</div>
<a class="anchor" id="ga7053978f505b771b36fc27892721d032"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int lqt_get_cmodel </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 the colormodel, which will be valid for the next en-/decode call. </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>Track index (starting with 0) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The colormodel used for en-/decode functions.</dd></dl>
<p>By default, it will return the colormodel, which is used natively by the codec. It can be changed with <a class="el" href="group__video.html#ga6d65bc0c73130f73da12379d8f428cdc">lqt_set_cmodel</a> . </p>
</div>
</div>
<a class="anchor" id="ga57ce679a75a23aac4009bfb1cbf3a2fa"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">uint8_t** lqt_rows_alloc </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>width</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>height</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>colormodel</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>rowspan</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>rowspan_uv</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Allocate a frame buffer for use with libquicktime. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">width</td><td>The width of the frame </td></tr>
<tr><td class="paramname">height</td><td>The height of the frame </td></tr>
<tr><td class="paramname">colormodel</td><td>The colormodel of the frame (see <a class="el" href="group__color.html">Color handling</a>). </td></tr>
<tr><td class="paramname">rowspan</td><td>Specifies the row span to use for the luma plane. Can be 0 to use default values. After the function call, it will contain the rowspan actually used. </td></tr>
<tr><td class="paramname">rowspan_uv</td><td>Specifies the row span to use for the chroma planes. Can be 0 to use default values. After the function call, it will contain the rowspan actually used. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>An array of pointers to be passed to any of the en-/decoding functions.</dd></dl>
<p>What is called "row_pointers" here is a bit misleading: For packed formats, the pointers point to the beginnings of scanlines. For planar formats, the pointers point to the beginning of planes. In either case, the byte offsets between scanlines are be specified by rowspan and rowspan_uv. To free the returned frame, call <a class="el" href="group__video.html#ga9920f7ec0a8081faf57a77d93c474b32">lqt_rows_free</a> </p>
</div>
</div>
<a class="anchor" id="gaae1a660f8ca20b7c44194aaf591f190d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_rows_copy </td>
<td>(</td>
<td class="paramtype">uint8_t ** </td>
<td class="paramname"><em>out_rows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint8_t ** </td>
<td class="paramname"><em>in_rows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>width</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>height</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>in_rowspan</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>in_rowspan_uv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>out_rowspan</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>out_rowspan_uv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>colormodel</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Copy a video frame. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">out_rows</td><td>Destination frame </td></tr>
<tr><td class="paramname">in_rows</td><td>Source frame </td></tr>
<tr><td class="paramname">width</td><td>Width of the frame </td></tr>
<tr><td class="paramname">height</td><td>Height of the frame </td></tr>
<tr><td class="paramname">in_rowspan</td><td>Rowspan for the luma plane of the input frame </td></tr>
<tr><td class="paramname">in_rowspan_uv</td><td>Rowspan for the chroma planes of the input frame </td></tr>
<tr><td class="paramname">out_rowspan</td><td>Rowspan for the luma plane of the output frame </td></tr>
<tr><td class="paramname">out_rowspan_uv</td><td>Rowspan for the chroma planes of the output frame </td></tr>
<tr><td class="paramname">colormodel</td><td>The colormodel of the frames </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="gaedcd9eba19c17deff86dea3eb38af92d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_rows_copy_sub </td>
<td>(</td>
<td class="paramtype">uint8_t ** </td>
<td class="paramname"><em>out_rows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint8_t ** </td>
<td class="paramname"><em>in_rows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>width</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>height</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>in_rowspan</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>in_rowspan_uv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>out_rowspan</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>out_rowspan_uv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>colormodel</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>src_x</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>src_y</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>dst_x</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>dst_y</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Copy a subrectangle video frame. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">out_rows</td><td>Destination frame </td></tr>
<tr><td class="paramname">in_rows</td><td>Source frame </td></tr>
<tr><td class="paramname">width</td><td>Width of the frame </td></tr>
<tr><td class="paramname">height</td><td>Height of the frame </td></tr>
<tr><td class="paramname">in_rowspan</td><td>Rowspan for the luma plane of the input frame </td></tr>
<tr><td class="paramname">in_rowspan_uv</td><td>Rowspan for the chroma planes of the input frame </td></tr>
<tr><td class="paramname">out_rowspan</td><td>Rowspan for the luma plane of the output frame </td></tr>
<tr><td class="paramname">out_rowspan_uv</td><td>Rowspan for the chroma planes of the output frame </td></tr>
<tr><td class="paramname">colormodel</td><td>The colormodel of the frames </td></tr>
<tr><td class="paramname">src_x</td><td>X offset in the source frame </td></tr>
<tr><td class="paramname">src_y</td><td>Y offset in the source frame </td></tr>
<tr><td class="paramname">dst_x</td><td>X offset in the destination frame </td></tr>
<tr><td class="paramname">dst_y</td><td>Y offset in the destination frame</td></tr>
</table>
</dd>
</dl>
<p>Since 1.2.0 </p>
</div>
</div>
<a class="anchor" id="ga1a11529f6335f3e93191ee296ff8a640"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_rows_clear </td>
<td>(</td>
<td class="paramtype">uint8_t ** </td>
<td class="paramname"><em>rows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>width</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>height</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>rowspan</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>rowspan_uv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>colormodel</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Clear a video frame. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">rows</td><td>Frame </td></tr>
<tr><td class="paramname">width</td><td>Width of the frame </td></tr>
<tr><td class="paramname">height</td><td>Height of the frame </td></tr>
<tr><td class="paramname">rowspan</td><td>Rowspan for the luma plane of theframe </td></tr>
<tr><td class="paramname">rowspan_uv</td><td>Rowspan for the chroma planes of the frame </td></tr>
<tr><td class="paramname">colormodel</td><td>The colormodel of the frame</td></tr>
</table>
</dd>
</dl>
<p>This will set the colors to black and alpha (if available) to completely transparent.</p>
<p>Since 1.2.0 </p>
</div>
</div>
<a class="anchor" id="ga9920f7ec0a8081faf57a77d93c474b32"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_rows_free </td>
<td>(</td>
<td class="paramtype">uint8_t ** </td>
<td class="paramname"><em>rows</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Free a frame allocated by <a class="el" href="group__video.html#ga57ce679a75a23aac4009bfb1cbf3a2fa">lqt_rows_alloc</a>. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">rows</td><td>The frame to be freed </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga6d65bc0c73130f73da12379d8f428cdc"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_set_cmodel </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 class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>colormodel</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the colormodel for en-/decoding. </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>Track index (starting with 0) </td></tr>
<tr><td class="paramname">colormodel</td><td>The colormodel to use.</td></tr>
</table>
</dd>
</dl>
<p>Set colormodel of a video track. It's the colormodel, libquicktime will expect for the next call to <a class="el" href="group__video__encode.html#gad5d2f5fcdbd3237e8cfb4cdc37df91b6">lqt_encode_video</a> or <a class="el" href="group__video__decode.html#gad364110b5fbcaf20d6756559693c094a">lqt_decode_video</a> respectively. Before you should call this, you should verify, that this colormodel can be used with <a class="el" href="group__video__decode.html#gade9f2accad2e073101f2eaac4e34a499">quicktime_reads_cmodel</a> (for reading), <a class="el" href="group__video__encode.html#ga1819c497a934a07c6dc18abfd91b0a91">quicktime_writes_cmodel</a> (for writing) or <a class="el" href="group__video.html#ga128d549ba1e29083ab61f3425ae6350d">lqt_get_best_colormodel</a> (for reading and writing). </p>
</div>
</div>
<a class="anchor" id="ga74cb491bf21df93ba971caf92d641a98"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_set_row_span </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 class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>row_span</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the row span for the luma plane. </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>Track index (starting with 0) </td></tr>
<tr><td class="paramname">row_span</td><td>The row span for the luma plane</td></tr>
</table>
</dd>
</dl>
<p>This sets the row_span, which will be used for the next en-/decode calls (see <a class="el" href="group__video.html#ga57ce679a75a23aac4009bfb1cbf3a2fa">lqt_rows_alloc</a> ). </p>
</div>
</div>
<a class="anchor" id="ga65538f230c191a361ca894883e7e3752"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_set_row_span_uv </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 class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>row_span_uv</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the row span for the chroma planes. </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>Track index (starting with 0) </td></tr>
<tr><td class="paramname">row_span_uv</td><td>The row span for the chroma planes</td></tr>
</table>
</dd>
</dl>
<p>This sets the row_span, which will be used for the next en-/decode calls (see <a class="el" href="group__video.html#ga57ce679a75a23aac4009bfb1cbf3a2fa">lqt_rows_alloc</a> ). </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
>
63
