<!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.5"/>
<title>libquicktime: Color handling</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.5 -->
<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="#define-members">Macros</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">Color handling</div> </div>
</div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="define-members"></a>
Macros</h2></td></tr>
<tr class="memitem:ga945c2341e12eb1a9baad5844e851746b"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga945c2341e12eb1a9baad5844e851746b">BC_RGB565</a>   2</td></tr>
<tr class="separator:ga945c2341e12eb1a9baad5844e851746b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gada8983e541c62bb195f1e94a2ba18b9d"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#gada8983e541c62bb195f1e94a2ba18b9d">BC_BGR565</a>   3</td></tr>
<tr class="separator:gada8983e541c62bb195f1e94a2ba18b9d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga50de57e7d6e7a4042c0bcb4aa824a3c0"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga50de57e7d6e7a4042c0bcb4aa824a3c0">BC_BGR888</a>   4</td></tr>
<tr class="separator:ga50de57e7d6e7a4042c0bcb4aa824a3c0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gac3ec15bef87f60840e342d0a359cb088"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#gac3ec15bef87f60840e342d0a359cb088">BC_BGR8888</a>   5</td></tr>
<tr class="separator:gac3ec15bef87f60840e342d0a359cb088"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaaec2dd466403410fc4daa417ec2ab6c6"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#gaaec2dd466403410fc4daa417ec2ab6c6">BC_RGB888</a>   6</td></tr>
<tr class="separator:gaaec2dd466403410fc4daa417ec2ab6c6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga27c5ec4934a8fd3590a186c031426702"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga27c5ec4934a8fd3590a186c031426702">BC_RGBA8888</a>   7</td></tr>
<tr class="separator:ga27c5ec4934a8fd3590a186c031426702"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga0db9d18202d091b1542697851dcb6c58"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga0db9d18202d091b1542697851dcb6c58">BC_RGB161616</a>   8</td></tr>
<tr class="separator:ga0db9d18202d091b1542697851dcb6c58"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga8f7950a15f4fd3180e7238101176f817"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga8f7950a15f4fd3180e7238101176f817">BC_RGBA16161616</a>   9</td></tr>
<tr class="separator:ga8f7950a15f4fd3180e7238101176f817"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa1b06526031c14815566cd944963adb4"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#gaa1b06526031c14815566cd944963adb4">BC_YUVA8888</a>   10</td></tr>
<tr class="separator:gaa1b06526031c14815566cd944963adb4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga9854a8f5bd49fe535624c37a15b81128"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga9854a8f5bd49fe535624c37a15b81128">BC_YUV422</a>   13</td></tr>
<tr class="separator:ga9854a8f5bd49fe535624c37a15b81128"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab4583749c1106aef4b0c13d1710c7ac3"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#gab4583749c1106aef4b0c13d1710c7ac3">BC_YUV420P</a>   14</td></tr>
<tr class="separator:gab4583749c1106aef4b0c13d1710c7ac3"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga0d7eed5ffd41f3528b0c8ba97ee35e06"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga0d7eed5ffd41f3528b0c8ba97ee35e06">BC_YUV422P</a>   15</td></tr>
<tr class="separator:ga0d7eed5ffd41f3528b0c8ba97ee35e06"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf4520fe86245d3134aaf9d3ddcf728bf"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#gaf4520fe86245d3134aaf9d3ddcf728bf">BC_YUV444P</a>   16</td></tr>
<tr class="separator:gaf4520fe86245d3134aaf9d3ddcf728bf"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga1c06a3a83d7ca0ef29b2a913b6995ad1"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga1c06a3a83d7ca0ef29b2a913b6995ad1">BC_YUV411P</a>   17</td></tr>
<tr class="separator:ga1c06a3a83d7ca0ef29b2a913b6995ad1"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga0996b15349a538dcadb8adb40daf1657"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga0996b15349a538dcadb8adb40daf1657">BC_YUVJ420P</a>   18</td></tr>
<tr class="separator:ga0996b15349a538dcadb8adb40daf1657"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga8e74c98804b21c966b8e61130bc89516"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga8e74c98804b21c966b8e61130bc89516">BC_YUVJ422P</a>   19</td></tr>
<tr class="separator:ga8e74c98804b21c966b8e61130bc89516"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf31d62bbd2b1e8bc47f170b9b89daf49"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#gaf31d62bbd2b1e8bc47f170b9b89daf49">BC_YUVJ444P</a>   20</td></tr>
<tr class="separator:gaf31d62bbd2b1e8bc47f170b9b89daf49"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gadf49d0f6c48bad10fd59d995cfc6109a"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#gadf49d0f6c48bad10fd59d995cfc6109a">BC_YUV422P16</a>   21</td></tr>
<tr class="separator:gadf49d0f6c48bad10fd59d995cfc6109a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga85a2bde828e96b9d0db53e28803e4ec7"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga85a2bde828e96b9d0db53e28803e4ec7">BC_YUV444P16</a>   22</td></tr>
<tr class="separator:ga85a2bde828e96b9d0db53e28803e4ec7"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gabc6a008a7710aa3cf5b21637f509f2bf"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#gabc6a008a7710aa3cf5b21637f509f2bf">BC_YUV422P10</a>   23</td></tr>
<tr class="separator:gabc6a008a7710aa3cf5b21637f509f2bf"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaca0ea3c325d5ddd69967514ae38eaaf0"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#gaca0ea3c325d5ddd69967514ae38eaaf0">BC_YUVJ422P10</a>   24</td></tr>
<tr class="separator:gaca0ea3c325d5ddd69967514ae38eaaf0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga942d9eb46460b14d451d05483089d8ca"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga942d9eb46460b14d451d05483089d8ca">LQT_COLORMODEL_NONE</a>   -1</td></tr>
<tr class="separator:ga942d9eb46460b14d451d05483089d8ca"><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:ga2e3811219333b5193e1078459b78da6a"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga2e3811219333b5193e1078459b78da6a">lqt_colormodel_to_string</a> (int colormodel)</td></tr>
<tr class="memdesc:ga2e3811219333b5193e1078459b78da6a"><td class="mdescLeft"> </td><td class="mdescRight">Convert a colormodel to a human readable string. <a href="#ga2e3811219333b5193e1078459b78da6a">More...</a><br/></td></tr>
<tr class="separator:ga2e3811219333b5193e1078459b78da6a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gae26c1c9f82ea5d9741feaabaf9b9c493"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#gae26c1c9f82ea5d9741feaabaf9b9c493">lqt_string_to_colormodel</a> (const char *str)</td></tr>
<tr class="memdesc:gae26c1c9f82ea5d9741feaabaf9b9c493"><td class="mdescLeft"> </td><td class="mdescRight">Convert a description string to a colormodel. <a href="#gae26c1c9f82ea5d9741feaabaf9b9c493">More...</a><br/></td></tr>
<tr class="separator:gae26c1c9f82ea5d9741feaabaf9b9c493"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab8dbf96c67abf4a98e94a00e02d11188"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#gab8dbf96c67abf4a98e94a00e02d11188">lqt_colormodel_is_planar</a> (int colormodel)</td></tr>
<tr class="memdesc:gab8dbf96c67abf4a98e94a00e02d11188"><td class="mdescLeft"> </td><td class="mdescRight">Check if a colormodel is planar. <a href="#gab8dbf96c67abf4a98e94a00e02d11188">More...</a><br/></td></tr>
<tr class="separator:gab8dbf96c67abf4a98e94a00e02d11188"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga06fd25b090ccdcc57ae90ee4aa7cd78b"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga06fd25b090ccdcc57ae90ee4aa7cd78b">lqt_colormodel_has_alpha</a> (int colormodel)</td></tr>
<tr class="memdesc:ga06fd25b090ccdcc57ae90ee4aa7cd78b"><td class="mdescLeft"> </td><td class="mdescRight">Check if a colormodel has an alpha (transperency) channel. <a href="#ga06fd25b090ccdcc57ae90ee4aa7cd78b">More...</a><br/></td></tr>
<tr class="separator:ga06fd25b090ccdcc57ae90ee4aa7cd78b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf5f7a279dbad2307cddf7333d35e3db9"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#gaf5f7a279dbad2307cddf7333d35e3db9">lqt_colormodel_is_rgb</a> (int colormodel)</td></tr>
<tr class="memdesc:gaf5f7a279dbad2307cddf7333d35e3db9"><td class="mdescLeft"> </td><td class="mdescRight">Check, if a colormodel is RGB based. <a href="#gaf5f7a279dbad2307cddf7333d35e3db9">More...</a><br/></td></tr>
<tr class="separator:gaf5f7a279dbad2307cddf7333d35e3db9"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gacb9d9b1d82fe6e5afa517467fc204fcc"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#gacb9d9b1d82fe6e5afa517467fc204fcc">lqt_colormodel_is_yuv</a> (int colormodel)</td></tr>
<tr class="memdesc:gacb9d9b1d82fe6e5afa517467fc204fcc"><td class="mdescLeft"> </td><td class="mdescRight">Check, if a colormodel is YUV based. <a href="#gacb9d9b1d82fe6e5afa517467fc204fcc">More...</a><br/></td></tr>
<tr class="separator:gacb9d9b1d82fe6e5afa517467fc204fcc"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gad658d0626460a239ead7c322bc8249b9"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#gad658d0626460a239ead7c322bc8249b9">lqt_colormodel_get_chroma_sub</a> (int colormodel, int *sub_h, int *sub_v)</td></tr>
<tr class="memdesc:gad658d0626460a239ead7c322bc8249b9"><td class="mdescLeft"> </td><td class="mdescRight">Get the chroma subsampling factors. <a href="#gad658d0626460a239ead7c322bc8249b9">More...</a><br/></td></tr>
<tr class="separator:gad658d0626460a239ead7c322bc8249b9"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gad8ff9f9697ce3a7f513e12734d533a61"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#gad8ff9f9697ce3a7f513e12734d533a61">lqt_get_default_rowspan</a> (int colormodel, int width, int *rowspan, int *rowspan_uv)</td></tr>
<tr class="memdesc:gad8ff9f9697ce3a7f513e12734d533a61"><td class="mdescLeft"> </td><td class="mdescRight">Get the default row span for a colormodel and an image width. <a href="#gad8ff9f9697ce3a7f513e12734d533a61">More...</a><br/></td></tr>
<tr class="separator:gad8ff9f9697ce3a7f513e12734d533a61"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga26e92d17dd935fad1f121dabba028ad5"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga26e92d17dd935fad1f121dabba028ad5">lqt_colormodel_has_conversion</a> (int in_cmodel, int out_cmodel)</td></tr>
<tr class="memdesc:ga26e92d17dd935fad1f121dabba028ad5"><td class="mdescLeft"> </td><td class="mdescRight">Check if a colormodel conversion is supported by libquicktime. <a href="#ga26e92d17dd935fad1f121dabba028ad5">More...</a><br/></td></tr>
<tr class="separator:ga26e92d17dd935fad1f121dabba028ad5"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga54991b74c721fe85f9d97d88ec019e62"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga54991b74c721fe85f9d97d88ec019e62">lqt_num_colormodels</a> ()</td></tr>
<tr class="memdesc:ga54991b74c721fe85f9d97d88ec019e62"><td class="mdescLeft"> </td><td class="mdescRight">Get number of supported colormodels. <a href="#ga54991b74c721fe85f9d97d88ec019e62">More...</a><br/></td></tr>
<tr class="separator:ga54991b74c721fe85f9d97d88ec019e62"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga8647bebf01b05d3105dab7dfbf74de89"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga8647bebf01b05d3105dab7dfbf74de89">lqt_get_colormodel_string</a> (int index)</td></tr>
<tr class="memdesc:ga8647bebf01b05d3105dab7dfbf74de89"><td class="mdescLeft"> </td><td class="mdescRight">Get a colormodel string. <a href="#ga8647bebf01b05d3105dab7dfbf74de89">More...</a><br/></td></tr>
<tr class="separator:ga8647bebf01b05d3105dab7dfbf74de89"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaec06e1abe7b5b0429db256e7001c7eb0"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#gaec06e1abe7b5b0429db256e7001c7eb0">lqt_get_colormodel</a> (int index)</td></tr>
<tr class="memdesc:gaec06e1abe7b5b0429db256e7001c7eb0"><td class="mdescLeft"> </td><td class="mdescRight">Get a colormodel. <a href="#gaec06e1abe7b5b0429db256e7001c7eb0">More...</a><br/></td></tr>
<tr class="separator:gaec06e1abe7b5b0429db256e7001c7eb0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga9e5f2fc3458e11fc35ecf778b1ba26b2"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga9e5f2fc3458e11fc35ecf778b1ba26b2">lqt_get_best_source_colormodel</a> (int const *source_options, int target)</td></tr>
<tr class="memdesc:ga9e5f2fc3458e11fc35ecf778b1ba26b2"><td class="mdescLeft"> </td><td class="mdescRight">Select a source colormodel from a provided list that is best for conversion into a specified target colormodel. <a href="#ga9e5f2fc3458e11fc35ecf778b1ba26b2">More...</a><br/></td></tr>
<tr class="separator:ga9e5f2fc3458e11fc35ecf778b1ba26b2"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga33d7eba2d1c07ad0f5cf681561acbc17"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__color.html#ga33d7eba2d1c07ad0f5cf681561acbc17">lqt_get_best_target_colormodel</a> (int source, int const *target_options)</td></tr>
<tr class="memdesc:ga33d7eba2d1c07ad0f5cf681561acbc17"><td class="mdescLeft"> </td><td class="mdescRight">Select a target colormodel from a provided list that is best for conversion from a specified source colormodel. <a href="#ga33d7eba2d1c07ad0f5cf681561acbc17">More...</a><br/></td></tr>
<tr class="separator:ga33d7eba2d1c07ad0f5cf681561acbc17"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<p>Libquicktime has a built in colormodel converter, which can do implicit colormodel conversions while en-/decoding. It is, however, far from perfect: It is incomplete (i.e. not all conversions are present), slow and sometimes inaccurate. Therefore, there is a possibility to bypass internal colormodel conversions. </p>
<h2 class="groupheader">Macro Definition Documentation</h2>
<a class="anchor" id="ga945c2341e12eb1a9baad5844e851746b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_RGB565   2</td>
</tr>
</table>
</div><div class="memdoc">
<p>16 bit RGB. Each pixel is a uint16_t in native byte order. Color masks are: for red: 0xf800, for green: 0x07e0, for blue: 0x001f </p>
</div>
</div>
<a class="anchor" id="gada8983e541c62bb195f1e94a2ba18b9d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_BGR565   3</td>
</tr>
</table>
</div><div class="memdoc">
<p>16 bit BGR. Each pixel is a uint16_t in native byte order. Color masks are: for red: 0x001f, for green: 0x07e0, for blue: 0xf800 </p>
</div>
</div>
<a class="anchor" id="ga50de57e7d6e7a4042c0bcb4aa824a3c0"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_BGR888   4</td>
</tr>
</table>
</div><div class="memdoc">
<p>24 bit BGR. Each color is an uint8_t. Color order is BGR </p>
</div>
</div>
<a class="anchor" id="gac3ec15bef87f60840e342d0a359cb088"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_BGR8888   5</td>
</tr>
</table>
</div><div class="memdoc">
<p>32 bit BGR. Each color is an uint8_t. Color order is BGRXBGRX, where X is unused </p>
</div>
</div>
<a class="anchor" id="gaaec2dd466403410fc4daa417ec2ab6c6"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_RGB888   6</td>
</tr>
</table>
</div><div class="memdoc">
<p>24 bit RGB. Each color is an uint8_t. Color order is RGB </p>
</div>
</div>
<a class="anchor" id="ga27c5ec4934a8fd3590a186c031426702"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_RGBA8888   7</td>
</tr>
</table>
</div><div class="memdoc">
<p>32 bit RGBA. Each color is an uint8_t. Color order is RGBARGBA </p>
</div>
</div>
<a class="anchor" id="ga0db9d18202d091b1542697851dcb6c58"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_RGB161616   8</td>
</tr>
</table>
</div><div class="memdoc">
<p>48 bit RGB. Each color is an uint16_t in native byte order. Color order is RGB </p>
</div>
</div>
<a class="anchor" id="ga8f7950a15f4fd3180e7238101176f817"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_RGBA16161616   9</td>
</tr>
</table>
</div><div class="memdoc">
<p>64 bit RGBA. Each color is an uint16_t in native byte order. Color order is RGBA </p>
</div>
</div>
<a class="anchor" id="gaa1b06526031c14815566cd944963adb4"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_YUVA8888   10</td>
</tr>
</table>
</div><div class="memdoc">
<p>Packed YCbCrA 4:4:4:4. Each component is an uint8_t. Component order is YUVA </p>
</div>
</div>
<a class="anchor" id="ga9854a8f5bd49fe535624c37a15b81128"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_YUV422   13</td>
</tr>
</table>
</div><div class="memdoc">
<p>Packed YCbCr 4:2:2. Each component is an uint8_t. Component order is Y1 U1 Y2 V1 </p>
</div>
</div>
<a class="anchor" id="gab4583749c1106aef4b0c13d1710c7ac3"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_YUV420P   14</td>
</tr>
</table>
</div><div class="memdoc">
<p>Planar YCbCr 4:2:0. Each component is an uint8_t. Chroma placement is defined by <a class="el" href="group__video.html#ga29e261e843838c4509b4223e7a825516">lqt_chroma_placement_t</a> </p>
</div>
</div>
<a class="anchor" id="ga0d7eed5ffd41f3528b0c8ba97ee35e06"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_YUV422P   15</td>
</tr>
</table>
</div><div class="memdoc">
<p>Planar YCbCr 4:2:2. Each component is an uint8_t </p>
</div>
</div>
<a class="anchor" id="gaf4520fe86245d3134aaf9d3ddcf728bf"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_YUV444P   16</td>
</tr>
</table>
</div><div class="memdoc">
<p>Planar YCbCr 4:4:4. Each component is an uint8_t </p>
</div>
</div>
<a class="anchor" id="ga1c06a3a83d7ca0ef29b2a913b6995ad1"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_YUV411P   17</td>
</tr>
</table>
</div><div class="memdoc">
<p>Planar YCbCr 4:1:1. Each component is an uint8_t </p>
</div>
</div>
<a class="anchor" id="ga0996b15349a538dcadb8adb40daf1657"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_YUVJ420P   18</td>
</tr>
</table>
</div><div class="memdoc">
<p>Planar YCbCr 4:2:0. Each component is an uint8_t, luma and chroma values are full range (0x00 .. 0xff) </p>
</div>
</div>
<a class="anchor" id="ga8e74c98804b21c966b8e61130bc89516"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_YUVJ422P   19</td>
</tr>
</table>
</div><div class="memdoc">
<p>Planar YCbCr 4:2:2. Each component is an uint8_t, luma and chroma values are full range (0x00 .. 0xff) </p>
</div>
</div>
<a class="anchor" id="gaf31d62bbd2b1e8bc47f170b9b89daf49"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_YUVJ444P   20</td>
</tr>
</table>
</div><div class="memdoc">
<p>Planar YCbCr 4:4:4. Each component is an uint8_t, luma and chroma values are full range (0x00 .. 0xff) </p>
</div>
</div>
<a class="anchor" id="gadf49d0f6c48bad10fd59d995cfc6109a"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_YUV422P16   21</td>
</tr>
</table>
</div><div class="memdoc">
<p>16 bit Planar YCbCr 4:2:2. Each component is an uint16_t in native byte order. </p>
</div>
</div>
<a class="anchor" id="ga85a2bde828e96b9d0db53e28803e4ec7"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_YUV444P16   22</td>
</tr>
</table>
</div><div class="memdoc">
<p>16 bit Planar YCbCr 4:4:4. Each component is an uint16_t in native byte order. </p>
</div>
</div>
<a class="anchor" id="gabc6a008a7710aa3cf5b21637f509f2bf"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_YUV422P10   23</td>
</tr>
</table>
</div><div class="memdoc">
<p>10 bit values in uint16_t native byte order containers, planar YCbCr 4:2:2. </p>
</div>
</div>
<a class="anchor" id="gaca0ea3c325d5ddd69967514ae38eaaf0"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define BC_YUVJ422P10   24</td>
</tr>
</table>
</div><div class="memdoc">
<p>10 bit values in uint16_t native byte order containers, planar YCbCr 4:2:2. Luma and chroma values are full range (0 .. 1023) </p>
</div>
</div>
<a class="anchor" id="ga942d9eb46460b14d451d05483089d8ca"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define LQT_COLORMODEL_NONE   -1</td>
</tr>
</table>
</div><div class="memdoc">
<p>This value is used for termination of colormodel arrays </p>
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a class="anchor" id="ga2e3811219333b5193e1078459b78da6a"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* lqt_colormodel_to_string </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>colormodel</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Convert a colormodel to a human readable string. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">colormodel</td><td>A colormodel </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A description of the colormodel </dd></dl>
</div>
</div>
<a class="anchor" id="gae26c1c9f82ea5d9741feaabaf9b9c493"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int lqt_string_to_colormodel </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>str</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Convert a description string to a colormodel. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">str</td><td>A colormodel description (as returned by <a class="el" href="group__color.html#ga2e3811219333b5193e1078459b78da6a">lqt_colormodel_to_string</a>) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The corresponding colormodel or <a class="el" href="group__color.html#ga942d9eb46460b14d451d05483089d8ca">LQT_COLORMODEL_NONE</a> </dd></dl>
</div>
</div>
<a class="anchor" id="gab8dbf96c67abf4a98e94a00e02d11188"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int lqt_colormodel_is_planar </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>colormodel</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Check if a colormodel is planar. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">colormodel</td><td>A colormodel </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>1 if the colormodel is planar, 0 else </dd></dl>
</div>
</div>
<a class="anchor" id="ga06fd25b090ccdcc57ae90ee4aa7cd78b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int lqt_colormodel_has_alpha </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>colormodel</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Check if a colormodel has an alpha (transperency) channel. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">colormodel</td><td>A colormodel </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>1 if the colormodel has an alpha channel, 0 else </dd></dl>
</div>
</div>
<a class="anchor" id="gaf5f7a279dbad2307cddf7333d35e3db9"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int lqt_colormodel_is_rgb </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>colormodel</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Check, if a colormodel is RGB based. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">colormodel</td><td>A colormodel </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>1 if the colormodel is RGB based, 0 else </dd></dl>
</div>
</div>
<a class="anchor" id="gacb9d9b1d82fe6e5afa517467fc204fcc"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int lqt_colormodel_is_yuv </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>colormodel</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Check, if a colormodel is YUV based. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">colormodel</td><td>A colormodel </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>1 if the colormodel is YUV based, 0 else </dd></dl>
</div>
</div>
<a class="anchor" id="gad658d0626460a239ead7c322bc8249b9"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_colormodel_get_chroma_sub </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>sub_h</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>sub_v</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the chroma subsampling factors. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">colormodel</td><td>A colormodel </td></tr>
<tr><td class="paramname">sub_h</td><td>Returns the horizontal subsampling factor </td></tr>
<tr><td class="paramname">sub_v</td><td>Returns the vertical subsampling factor </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="gad8ff9f9697ce3a7f513e12734d533a61"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void lqt_get_default_rowspan </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>width</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>Get the default row span for a colormodel and an image width. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">colormodel</td><td>A colormodel </td></tr>
<tr><td class="paramname">width</td><td>Image width </td></tr>
<tr><td class="paramname">rowspan</td><td>Returns the rowspan for the luminance (Y) plane </td></tr>
<tr><td class="paramname">rowspan_uv</td><td>Returns the rowspan for the chrominance (U/V) planes</td></tr>
</table>
</dd>
</dl>
<p>The rowspan is the byte offset between scanlines. It can be calculated from the colormodel and the image width. Some APIs however, padd the scanlines to certain boundaries, so the rowspans might become larger here (see <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>). </p>
</div>
</div>
<a class="anchor" id="ga26e92d17dd935fad1f121dabba028ad5"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int lqt_colormodel_has_conversion </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>in_cmodel</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>out_cmodel</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Check if a colormodel conversion is supported by libquicktime. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">in_cmodel</td><td>Input colormodel </td></tr>
<tr><td class="paramname">out_cmodel</td><td>Output colormodel </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>1 if the requested conversion is possible, 0 else</dd></dl>
<p>As noted before, the colormodel converter is not complete, and this function checks it. As a fallback, conversions from and to <a class="el" href="group__color.html#gaaec2dd466403410fc4daa417ec2ab6c6">BC_RGB888</a> are always supported. If you need a converison, which is not present, contact the authors for hints how to write it :) </p>
</div>
</div>
<a class="anchor" id="ga54991b74c721fe85f9d97d88ec019e62"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int lqt_num_colormodels </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get number of supported colormodels. </p>
<dl class="section return"><dt>Returns</dt><dd>The number of colormodels known to your version of libquicktime </dd></dl>
</div>
</div>
<a class="anchor" id="ga8647bebf01b05d3105dab7dfbf74de89"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* lqt_get_colormodel_string </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>Get a colormodel string. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">index</td><td>Index of the colormodel (between 0 and the return value of <a class="el" href="group__color.html#ga54991b74c721fe85f9d97d88ec019e62">lqt_num_colormodels</a> - 1) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A description of the colormodel according to index or NULL. </dd></dl>
</div>
</div>
<a class="anchor" id="gaec06e1abe7b5b0429db256e7001c7eb0"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int lqt_get_colormodel </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>Get a colormodel. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">index</td><td>Index of the colormodel (between 0 and the return value of <a class="el" href="group__color.html#ga54991b74c721fe85f9d97d88ec019e62">lqt_num_colormodels</a> - 1) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The colormodel according to index or <a class="el" href="group__color.html#ga942d9eb46460b14d451d05483089d8ca">LQT_COLORMODEL_NONE</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ga9e5f2fc3458e11fc35ecf778b1ba26b2"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int lqt_get_best_source_colormodel </td>
<td>(</td>
<td class="paramtype">int const * </td>
<td class="paramname"><em>source_options</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>target</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Select a source colormodel from a provided list that is best for conversion into a specified target colormodel. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">source_options</td><td>An array of source colormodels to select from. Must be terminated with LQT_COLORMODEL_NODE. </td></tr>
<tr><td class="paramname">target</td><td>The target colormodel. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A colormodel from <code>source_options</code> or LQT_COLORMODEL_NONE, if none of the source colormodels can be converted to the target one. </dd></dl>
</div>
</div>
<a class="anchor" id="ga33d7eba2d1c07ad0f5cf681561acbc17"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int lqt_get_best_target_colormodel </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>source</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int const * </td>
<td class="paramname"><em>target_options</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Select a target colormodel from a provided list that is best for conversion from a specified source colormodel. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">source</td><td>The source colormodel. </td></tr>
<tr><td class="paramname">target_options</td><td>An array of target colormodels to select from. Must be terminated with LQT_COLORMODEL_NODE. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A colormodel from <code>target_options</code> or LQT_COLORMODEL_NONE, if the source colormodel can't be converted to any of the target ones. </dd></dl>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Sat Aug 24 2013 16:07:02 for libquicktime by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.5
</small></address>
</body>
</html>
