<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>gmerlin: A/V Converters</title>
<link href="tabs.css" rel="stylesheet" type="text/css">
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.9 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</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>
<li><a href="dirs.html"><span>Directories</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1>A/V Converters</h1><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Typedefs</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef struct bg_audio_converter_s </td><td class="memItemRight" valign="bottom"><a class="el" href="group__converters.html#g520953b58cf6704de4cff464ecdf3064">bg_audio_converter_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Audio converter. <a href="#g520953b58cf6704de4cff464ecdf3064"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef struct bg_video_converter_s </td><td class="memItemRight" valign="bottom"><a class="el" href="group__converters.html#ge06980e9eb9fba5cbf14b85e8685f0c2">bg_video_converter_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Video converter. <a href="#ge06980e9eb9fba5cbf14b85e8685f0c2"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__converters.html#g520953b58cf6704de4cff464ecdf3064">bg_audio_converter_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__converters.html#gae8d6f3e416d7f8ca28a1651bcd636bb">bg_audio_converter_create</a> (const <a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//group__audio__options.html#ga0">gavl_audio_options_t</a> *opt)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create an audio converter. <a href="#gae8d6f3e416d7f8ca28a1651bcd636bb"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__converters.html#gd255512ca244ec7951542a9ffea3131c">bg_audio_converter_init</a> (<a class="el" href="group__converters.html#g520953b58cf6704de4cff464ecdf3064">bg_audio_converter_t</a> *cnv, const <a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//structgavl__audio__format__s.html">gavl_audio_format_t</a> *in_format, const <a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//structgavl__audio__format__s.html">gavl_audio_format_t</a> *out_format)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize an audio converter. <a href="#gd255512ca244ec7951542a9ffea3131c"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__converters.html#gdeb46ff119c02b6123db775cc9e5f292">bg_audio_converter_connect_input</a> (<a class="el" href="group__converters.html#g520953b58cf6704de4cff464ecdf3064">bg_audio_converter_t</a> *cnv, <a class="el" href="group__plugin.html#gf3ade316707ab6bd66d55dcf60403b3d">bg_read_audio_func_t</a> func, void *priv, int stream)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set input callback of an audio converter. <a href="#gdeb46ff119c02b6123db775cc9e5f292"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__converters.html#gbc7f7180bce67509f24ac2d7f4083ac5">bg_audio_converter_read</a> (void *priv, <a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//structgavl__audio__frame__s.html">gavl_audio_frame_t</a> *frame, int stream, int num_samples)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read samples from an audio converter. <a href="#gbc7f7180bce67509f24ac2d7f4083ac5"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__converters.html#gcd16357f42bff722795a7a72a90f4209">bg_audio_converter_destroy</a> (<a class="el" href="group__converters.html#g520953b58cf6704de4cff464ecdf3064">bg_audio_converter_t</a> *cnv)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Destroy an audio converter and free all associated memory. <a href="#gcd16357f42bff722795a7a72a90f4209"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__converters.html#g1e1dab00c9b9e269672e4076ce3548a6">bg_audio_converter_reset</a> (<a class="el" href="group__converters.html#g520953b58cf6704de4cff464ecdf3064">bg_audio_converter_t</a> *cnv)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Reset an audio converter as if no samples have been processed since initialization. <a href="#g1e1dab00c9b9e269672e4076ce3548a6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__converters.html#ge06980e9eb9fba5cbf14b85e8685f0c2">bg_video_converter_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__converters.html#gaffe783b782bc54af092d550ad3859cd">bg_video_converter_create</a> (const <a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//group__video__options.html#ga0">gavl_video_options_t</a> *opt)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create a video converter. <a href="#gaffe783b782bc54af092d550ad3859cd"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__converters.html#g22b62b0870af24c5e0c1fce5b09314f3">bg_video_converter_init</a> (<a class="el" href="group__converters.html#ge06980e9eb9fba5cbf14b85e8685f0c2">bg_video_converter_t</a> *cnv, const <a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//structgavl__video__format__s.html">gavl_video_format_t</a> *in_format, const <a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//structgavl__video__format__s.html">gavl_video_format_t</a> *out_format)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a video converter. <a href="#g22b62b0870af24c5e0c1fce5b09314f3"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__converters.html#gbd240a78547c8b54d85cb63f8465d6fd">bg_video_converter_connect_input</a> (<a class="el" href="group__converters.html#ge06980e9eb9fba5cbf14b85e8685f0c2">bg_video_converter_t</a> *cnv, <a class="el" href="group__plugin.html#gdc25c1f00af83f18062dcf72af04374d">bg_read_video_func_t</a> func, void *priv, int stream)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set input callback of a video converter. <a href="#gbd240a78547c8b54d85cb63f8465d6fd"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__converters.html#g1a4c4617e4bf22a4a3678498dc34bfe9">bg_video_converter_read</a> (void *priv, <a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//structgavl__video__frame__s.html">gavl_video_frame_t</a> *frame, int stream)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read a video frame from a video converter. <a href="#g1a4c4617e4bf22a4a3678498dc34bfe9"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__converters.html#g2328191689a6192e90928e339ca5d3f3">bg_video_converter_destroy</a> (<a class="el" href="group__converters.html#ge06980e9eb9fba5cbf14b85e8685f0c2">bg_video_converter_t</a> *cnv)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Destroy a video converter and free all associated memory. <a href="#g2328191689a6192e90928e339ca5d3f3"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__converters.html#ge962c4049a42e9aba473dfd4d880e2fd">bg_video_converter_reset</a> (<a class="el" href="group__converters.html#ge06980e9eb9fba5cbf14b85e8685f0c2">bg_video_converter_t</a> *cnv)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Reset a video converter as if no samples have been processed since initialization. <a href="#ge962c4049a42e9aba473dfd4d880e2fd"></a><br></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
A/V converters, which can be plugged together with filters and input plugins. These are basically wrappers around the <a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//group__audio__converter.html#ga0">gavl_audio_converter_t</a> and the <a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//group__video__converter.html#ga0">gavl_video_converter_t</a> with the difference, that they work asynchronous with the advantage, that the video converter can do framerate conversion as well.<p>
The functions for reading A/V frames are compatible with the read functions of input plugins and filters for easy generation of processing pipelines. <hr><h2>Typedef Documentation</h2>
<a class="anchor" name="g520953b58cf6704de4cff464ecdf3064"></a><!-- doxytag: member="converters.h::bg_audio_converter_t" ref="g520953b58cf6704de4cff464ecdf3064" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct bg_audio_converter_s <a class="el" href="group__converters.html#g520953b58cf6704de4cff464ecdf3064">bg_audio_converter_t</a> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Audio converter.
<p>
Opaque audio converter structure. You don't want to know, what's inside.
</div>
</div><p>
<a class="anchor" name="ge06980e9eb9fba5cbf14b85e8685f0c2"></a><!-- doxytag: member="converters.h::bg_video_converter_t" ref="ge06980e9eb9fba5cbf14b85e8685f0c2" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct bg_video_converter_s <a class="el" href="group__converters.html#ge06980e9eb9fba5cbf14b85e8685f0c2">bg_video_converter_t</a> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Video converter.
<p>
Opaque video converter structure. You don't want to know, what's inside.
</div>
</div><p>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="gae8d6f3e416d7f8ca28a1651bcd636bb"></a><!-- doxytag: member="converters.h::bg_audio_converter_create" ref="gae8d6f3e416d7f8ca28a1651bcd636bb" args="(const gavl_audio_options_t *opt)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__converters.html#g520953b58cf6704de4cff464ecdf3064">bg_audio_converter_t</a>* bg_audio_converter_create </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//group__audio__options.html#ga0">gavl_audio_options_t</a> * </td>
<td class="paramname"> <em>opt</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Create an audio converter.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>Audio options</td></tr>
</table>
</dl>
The options should be valid for the whole lifetime of the converter.
</div>
</div><p>
<a class="anchor" name="gd255512ca244ec7951542a9ffea3131c"></a><!-- doxytag: member="converters.h::bg_audio_converter_init" ref="gd255512ca244ec7951542a9ffea3131c" args="(bg_audio_converter_t *cnv, const gavl_audio_format_t *in_format, const gavl_audio_format_t *out_format)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int bg_audio_converter_init </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__converters.html#g520953b58cf6704de4cff464ecdf3064">bg_audio_converter_t</a> * </td>
<td class="paramname"> <em>cnv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//structgavl__audio__format__s.html">gavl_audio_format_t</a> * </td>
<td class="paramname"> <em>in_format</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//structgavl__audio__format__s.html">gavl_audio_format_t</a> * </td>
<td class="paramname"> <em>out_format</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Initialize an audio converter.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>cnv</em> </td><td>An audio converter </td></tr>
<tr><td valign="top"></td><td valign="top"><em>in_format</em> </td><td>Input format </td></tr>
<tr><td valign="top"></td><td valign="top"><em>out_format</em> </td><td>Output format </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The number of conversion steps</dd></dl>
When this function returns 0 it means, that the converter can be bypassed. It should not be used then until the next initialization, which returns nonzero.
</div>
</div><p>
<a class="anchor" name="gdeb46ff119c02b6123db775cc9e5f292"></a><!-- doxytag: member="converters.h::bg_audio_converter_connect_input" ref="gdeb46ff119c02b6123db775cc9e5f292" args="(bg_audio_converter_t *cnv, bg_read_audio_func_t func, void *priv, int stream)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void bg_audio_converter_connect_input </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__converters.html#g520953b58cf6704de4cff464ecdf3064">bg_audio_converter_t</a> * </td>
<td class="paramname"> <em>cnv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__plugin.html#gf3ade316707ab6bd66d55dcf60403b3d">bg_read_audio_func_t</a> </td>
<td class="paramname"> <em>func</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>priv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>stream</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set input callback of an audio converter.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>cnv</em> </td><td>An audio converter </td></tr>
<tr><td valign="top"></td><td valign="top"><em>func</em> </td><td>The function to call </td></tr>
<tr><td valign="top"></td><td valign="top"><em>priv</em> </td><td>The private handle to pass to func </td></tr>
<tr><td valign="top"></td><td valign="top"><em>stream</em> </td><td>The stream argument to pass to func </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="gbc7f7180bce67509f24ac2d7f4083ac5"></a><!-- doxytag: member="converters.h::bg_audio_converter_read" ref="gbc7f7180bce67509f24ac2d7f4083ac5" args="(void *priv, gavl_audio_frame_t *frame, int stream, int num_samples)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int bg_audio_converter_read </td>
<td>(</td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>priv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//structgavl__audio__frame__s.html">gavl_audio_frame_t</a> * </td>
<td class="paramname"> <em>frame</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>stream</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>num_samples</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Read samples from an audio converter.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>priv</em> </td><td>An audio converter </td></tr>
<tr><td valign="top"></td><td valign="top"><em>frame</em> </td><td>An audio frame </td></tr>
<tr><td valign="top"></td><td valign="top"><em>stream</em> </td><td>Stream number (must be 0) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>num_samples</em> </td><td>Number of samples to read </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The number of samples read. 0 means EOF.</dd></dl>
This function can be used as an input callback for audio filters.
</div>
</div><p>
<a class="anchor" name="gcd16357f42bff722795a7a72a90f4209"></a><!-- doxytag: member="converters.h::bg_audio_converter_destroy" ref="gcd16357f42bff722795a7a72a90f4209" args="(bg_audio_converter_t *cnv)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void bg_audio_converter_destroy </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__converters.html#g520953b58cf6704de4cff464ecdf3064">bg_audio_converter_t</a> * </td>
<td class="paramname"> <em>cnv</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Destroy an audio converter and free all associated memory.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>cnv</em> </td><td>An audio converter </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="g1e1dab00c9b9e269672e4076ce3548a6"></a><!-- doxytag: member="converters.h::bg_audio_converter_reset" ref="g1e1dab00c9b9e269672e4076ce3548a6" args="(bg_audio_converter_t *cnv)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void bg_audio_converter_reset </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__converters.html#g520953b58cf6704de4cff464ecdf3064">bg_audio_converter_t</a> * </td>
<td class="paramname"> <em>cnv</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Reset an audio converter as if no samples have been processed since initialization.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>cnv</em> </td><td>An audio converter</td></tr>
</table>
</dl>
Reset an audio converter as if no samples have been processed since initialization.
</div>
</div><p>
<a class="anchor" name="gaffe783b782bc54af092d550ad3859cd"></a><!-- doxytag: member="converters.h::bg_video_converter_create" ref="gaffe783b782bc54af092d550ad3859cd" args="(const gavl_video_options_t *opt)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__converters.html#ge06980e9eb9fba5cbf14b85e8685f0c2">bg_video_converter_t</a>* bg_video_converter_create </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//group__video__options.html#ga0">gavl_video_options_t</a> * </td>
<td class="paramname"> <em>opt</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Create a video converter.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>Video options</td></tr>
</table>
</dl>
The options should be valid for the whole lifetime of the converter.
</div>
</div><p>
<a class="anchor" name="g22b62b0870af24c5e0c1fce5b09314f3"></a><!-- doxytag: member="converters.h::bg_video_converter_init" ref="g22b62b0870af24c5e0c1fce5b09314f3" args="(bg_video_converter_t *cnv, const gavl_video_format_t *in_format, const gavl_video_format_t *out_format)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int bg_video_converter_init </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__converters.html#ge06980e9eb9fba5cbf14b85e8685f0c2">bg_video_converter_t</a> * </td>
<td class="paramname"> <em>cnv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//structgavl__video__format__s.html">gavl_video_format_t</a> * </td>
<td class="paramname"> <em>in_format</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//structgavl__video__format__s.html">gavl_video_format_t</a> * </td>
<td class="paramname"> <em>out_format</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Initialize a video converter.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>cnv</em> </td><td>A video converter </td></tr>
<tr><td valign="top"></td><td valign="top"><em>in_format</em> </td><td>Input format </td></tr>
<tr><td valign="top"></td><td valign="top"><em>out_format</em> </td><td>Output format </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The number of conversion steps</dd></dl>
When this function returns 0 it means, that the converter can be bypassed. It should not be used then until the next initialization, which returns nonzero.
</div>
</div><p>
<a class="anchor" name="gbd240a78547c8b54d85cb63f8465d6fd"></a><!-- doxytag: member="converters.h::bg_video_converter_connect_input" ref="gbd240a78547c8b54d85cb63f8465d6fd" args="(bg_video_converter_t *cnv, bg_read_video_func_t func, void *priv, int stream)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void bg_video_converter_connect_input </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__converters.html#ge06980e9eb9fba5cbf14b85e8685f0c2">bg_video_converter_t</a> * </td>
<td class="paramname"> <em>cnv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__plugin.html#gdc25c1f00af83f18062dcf72af04374d">bg_read_video_func_t</a> </td>
<td class="paramname"> <em>func</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>priv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>stream</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set input callback of a video converter.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>cnv</em> </td><td>A video converter </td></tr>
<tr><td valign="top"></td><td valign="top"><em>func</em> </td><td>The function to call </td></tr>
<tr><td valign="top"></td><td valign="top"><em>priv</em> </td><td>The private handle to pass to func </td></tr>
<tr><td valign="top"></td><td valign="top"><em>stream</em> </td><td>The stream argument to pass to func </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="g1a4c4617e4bf22a4a3678498dc34bfe9"></a><!-- doxytag: member="converters.h::bg_video_converter_read" ref="g1a4c4617e4bf22a4a3678498dc34bfe9" args="(void *priv, gavl_video_frame_t *frame, int stream)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int bg_video_converter_read </td>
<td>(</td>
<td class="paramtype">void * </td>
<td class="paramname"> <em>priv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" doxygen="gavl.tags:http://gmerlin.sourceforge.net/doc/gavl//" href="http://gmerlin.sourceforge.net/doc/gavl//structgavl__video__frame__s.html">gavl_video_frame_t</a> * </td>
<td class="paramname"> <em>frame</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>stream</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Read a video frame from a video converter.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>priv</em> </td><td>A video converter </td></tr>
<tr><td valign="top"></td><td valign="top"><em>frame</em> </td><td>A video frame </td></tr>
<tr><td valign="top"></td><td valign="top"><em>stream</em> </td><td>Stream number (must be 0) </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>1 if a frame was read, 0 means EOF.</dd></dl>
This function can be used as an input callback for video filters.
</div>
</div><p>
<a class="anchor" name="g2328191689a6192e90928e339ca5d3f3"></a><!-- doxytag: member="converters.h::bg_video_converter_destroy" ref="g2328191689a6192e90928e339ca5d3f3" args="(bg_video_converter_t *cnv)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void bg_video_converter_destroy </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__converters.html#ge06980e9eb9fba5cbf14b85e8685f0c2">bg_video_converter_t</a> * </td>
<td class="paramname"> <em>cnv</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Destroy a video converter and free all associated memory.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>cnv</em> </td><td>A video converter </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="ge962c4049a42e9aba473dfd4d880e2fd"></a><!-- doxytag: member="converters.h::bg_video_converter_reset" ref="ge962c4049a42e9aba473dfd4d880e2fd" args="(bg_video_converter_t *cnv)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void bg_video_converter_reset </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__converters.html#ge06980e9eb9fba5cbf14b85e8685f0c2">bg_video_converter_t</a> * </td>
<td class="paramname"> <em>cnv</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Reset a video converter as if no samples have been processed since initialization.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>cnv</em> </td><td>A video converter</td></tr>
</table>
</dl>
Reset a video converter as if no frame has been processed since initialization.
</div>
</div><p>
</div>
<hr size="1"><address style="text-align: right;"><small>Generated on Sat Aug 22 01:28:05 2009 for gmerlin by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.9 </small></address>
</body>
</html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
874255f3b26b44feb57fbe38a7384518
>
files
>
198
