Why Gemfury?
Push, build, and install
RubyGems
npm packages
Python packages
Maven artifacts
PHP packages
Go Modules
Debian packages
RPM packages
NuGet packages
showbox-public / ffmpeg-doc deb
Repository URL to install this package:
|
Version:
7:2.7.1-1ubuntu3 ▾
|
<!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"/>
<title>FFmpeg: Buffer sink API</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
$(document).ready(function() { searchBox.OnSelectItem(0); });
</script>
</head>
<body>
<div id="top"><!-- do not remove this div! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">FFmpeg
 <span id="projectnumber">2.7.1</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- Generated by Doxygen 1.7.6.1 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<div id="navrow1" class="tabs">
<ul class="tablist">
<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="examples.html"><span>Examples</span></a></li>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<span class="left">
<img id="MSearchSelect" src="search/mag_sel.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
</span><span class="right">
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</span>
</div>
</li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#nested-classes">Data Structures</a> |
<a href="#files">Files</a> |
<a href="#define-members">Defines</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">Buffer sink API</div> </div>
<div class="ingroups"><a class="el" href="group__lavfi.html">Libavfilter - graph-based frame editing library</a></div></div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="nested-classes"></a>
Data Structures</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structAVBufferSinkParams.html">AVBufferSinkParams</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Struct to use for initializing a buffersink context. <a href="structAVBufferSinkParams.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structAVABufferSinkParams.html">AVABufferSinkParams</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Struct to use for initializing an abuffersink context. <a href="structAVABufferSinkParams.html#details">More...</a><br/></td></tr>
<tr><td colspan="2"><h2><a name="files"></a>
Files</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">file  </td><td class="memItemRight" valign="bottom"><a class="el" href="buffersink_8h.html">buffersink.h</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><p>memory buffer sink API for audio and video </p>
<br/></td></tr>
<tr><td colspan="2"><h2><a name="define-members"></a>
Defines</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lavfi__buffersink.html#ga9453fc0e81d30237080b51575da0f0d8">AV_BUFFERSINK_FLAG_PEEK</a>   1</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Tell av_buffersink_get_buffer_ref() to read video/samples buffer reference, but not remove it from the buffer. <a href="#ga9453fc0e81d30237080b51575da0f0d8"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lavfi__buffersink.html#gade670e86ece8d740194c916fa1ea6cc0">AV_BUFFERSINK_FLAG_NO_REQUEST</a>   2</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Tell av_buffersink_get_buffer_ref() not to request a frame from its input. <a href="#gade670e86ece8d740194c916fa1ea6cc0"></a><br/></td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lavfi__buffersink.html#ga71ae9c529c8da51681e12faa37d1a395">av_buffersink_get_frame_flags</a> (<a class="el" href="structAVFilterContext.html">AVFilterContext</a> *ctx, <a class="el" href="structAVFrame.html">AVFrame</a> *<a class="el" href="extract__mvs_8c.html#ad7d33d579a8d4241a5e643e39287a209">frame</a>, int flags)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get a frame with filtered data from sink and put it in frame. <a href="#ga71ae9c529c8da51681e12faa37d1a395"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="structAVBufferSinkParams.html">AVBufferSinkParams</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lavfi__buffersink.html#gac27f0473a1e3dc340cf8e557b6fa98dd">av_buffersink_params_alloc</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create an <a class="el" href="structAVBufferSinkParams.html" title="Struct to use for initializing a buffersink context.">AVBufferSinkParams</a> structure. <a href="#gac27f0473a1e3dc340cf8e557b6fa98dd"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="structAVABufferSinkParams.html">AVABufferSinkParams</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lavfi__buffersink.html#ga87d2066b9a7f5dfaff00a0e0ac2e25e7">av_abuffersink_params_alloc</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create an <a class="el" href="structAVABufferSinkParams.html" title="Struct to use for initializing an abuffersink context.">AVABufferSinkParams</a> structure. <a href="#ga87d2066b9a7f5dfaff00a0e0ac2e25e7"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lavfi__buffersink.html#ga359d7d1e42c27ca14c07559d4e9adba7">av_buffersink_set_frame_size</a> (<a class="el" href="structAVFilterContext.html">AVFilterContext</a> *ctx, unsigned frame_size)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the frame size for an audio buffer sink. <a href="#ga359d7d1e42c27ca14c07559d4e9adba7"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="structAVRational.html">AVRational</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lavfi__buffersink.html#ga9e788b28139d9b5063676ac81870737b">av_buffersink_get_frame_rate</a> (<a class="el" href="structAVFilterContext.html">AVFilterContext</a> *ctx)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the frame rate of the input. <a href="#ga9e788b28139d9b5063676ac81870737b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lavfi__buffersink.html#ga653228f4cbca427c654d844a5fc59cfa">av_buffersink_get_frame</a> (<a class="el" href="structAVFilterContext.html">AVFilterContext</a> *ctx, <a class="el" href="structAVFrame.html">AVFrame</a> *<a class="el" href="extract__mvs_8c.html#ad7d33d579a8d4241a5e643e39287a209">frame</a>)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get a frame with filtered data from sink and put it in frame. <a href="#ga653228f4cbca427c654d844a5fc59cfa"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lavfi__buffersink.html#ga9c06b3744579f165cc032160c154828a">av_buffersink_get_samples</a> (<a class="el" href="structAVFilterContext.html">AVFilterContext</a> *ctx, <a class="el" href="structAVFrame.html">AVFrame</a> *<a class="el" href="extract__mvs_8c.html#ad7d33d579a8d4241a5e643e39287a209">frame</a>, int nb_samples)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Same as <a class="el" href="group__lavfi__buffersink.html#ga653228f4cbca427c654d844a5fc59cfa" title="Get a frame with filtered data from sink and put it in frame.">av_buffersink_get_frame()</a>, but with the ability to specify the number of samples read. <a href="#ga9c06b3744579f165cc032160c154828a"></a><br/></td></tr>
</table>
<hr/><h2>Define Documentation</h2>
<a class="anchor" id="ga9453fc0e81d30237080b51575da0f0d8"></a><!-- doxytag: member="buffersink.h::AV_BUFFERSINK_FLAG_PEEK" ref="ga9453fc0e81d30237080b51575da0f0d8" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define <a class="el" href="group__lavfi__buffersink.html#ga9453fc0e81d30237080b51575da0f0d8">AV_BUFFERSINK_FLAG_PEEK</a>   1</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Tell av_buffersink_get_buffer_ref() to read video/samples buffer reference, but not remove it from the buffer. </p>
<p>This is useful if you need only to read a video/samples buffer, without to fetch it. </p>
<p>Definition at line <a class="el" href="buffersink_8h_source.html#l00110">110</a> of file <a class="el" href="buffersink_8h_source.html">buffersink.h</a>.</p>
</div>
</div>
<a class="anchor" id="gade670e86ece8d740194c916fa1ea6cc0"></a><!-- doxytag: member="buffersink.h::AV_BUFFERSINK_FLAG_NO_REQUEST" ref="gade670e86ece8d740194c916fa1ea6cc0" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define <a class="el" href="group__lavfi__buffersink.html#gade670e86ece8d740194c916fa1ea6cc0">AV_BUFFERSINK_FLAG_NO_REQUEST</a>   2</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Tell av_buffersink_get_buffer_ref() not to request a frame from its input. </p>
<p>If a frame is already buffered, it is read (and removed from the buffer), but if no frame is present, return <a class="el" href="group__lavu__error.html#gae4bb6f165973d09584e0ec0f335f69ca">AVERROR(EAGAIN)</a>. </p>
<p>Definition at line <a class="el" href="buffersink_8h_source.html#l00117">117</a> of file <a class="el" href="buffersink_8h_source.html">buffersink.h</a>.</p>
</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga71ae9c529c8da51681e12faa37d1a395"></a><!-- doxytag: member="buffersink.h::av_buffersink_get_frame_flags" ref="ga71ae9c529c8da51681e12faa37d1a395" args="(AVFilterContext *ctx, AVFrame *frame, int flags)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int <a class="el" href="group__lavfi__buffersink.html#ga71ae9c529c8da51681e12faa37d1a395">av_buffersink_get_frame_flags</a> </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structAVFilterContext.html">AVFilterContext</a> * </td>
<td class="paramname"><em>ctx</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structAVFrame.html">AVFrame</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>flags</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get a frame with filtered data from sink and put it in frame. </p>
<dl class="params"><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">ctx</td><td>pointer to a buffersink or abuffersink filter context. </td></tr>
<tr><td class="paramname">frame</td><td>pointer to an allocated frame that will be filled with data. The data must be freed using <a class="el" href="group__lavu__frame.html#ga0a2b687f9c1c5ed0089b01fd61227108" title="Unreference all the buffers referenced by frame and reset the frame fields.">av_frame_unref()</a> / <a class="el" href="group__lavu__frame.html#ga979d73f3228814aee56aeca0636e37cc" title="Free the frame and any dynamically allocated objects in it, e.g.">av_frame_free()</a> </td></tr>
<tr><td class="paramname">flags</td><td>a combination of AV_BUFFERSINK_FLAG_* flags</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>>= 0 in for success, a negative AVERROR code for failure. </dd></dl>
</div>
</div>
<a class="anchor" id="gac27f0473a1e3dc340cf8e557b6fa98dd"></a><!-- doxytag: member="buffersink.h::av_buffersink_params_alloc" ref="gac27f0473a1e3dc340cf8e557b6fa98dd" args="(void)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structAVBufferSinkParams.html">AVBufferSinkParams</a>* <a class="el" href="group__lavfi__buffersink.html#gac27f0473a1e3dc340cf8e557b6fa98dd">av_buffersink_params_alloc</a> </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Create an <a class="el" href="structAVBufferSinkParams.html" title="Struct to use for initializing a buffersink context.">AVBufferSinkParams</a> structure. </p>
<p>Must be freed with <a class="el" href="group__lavu__mem.html#ga0c9096f498624c525aa2315b8a20c411" title="Free a memory block which has been allocated with av_malloc(z)() or av_realloc().">av_free()</a>. </p>
</div>
</div>
<a class="anchor" id="ga87d2066b9a7f5dfaff00a0e0ac2e25e7"></a><!-- doxytag: member="buffersink.h::av_abuffersink_params_alloc" ref="ga87d2066b9a7f5dfaff00a0e0ac2e25e7" args="(void)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structAVABufferSinkParams.html">AVABufferSinkParams</a>* <a class="el" href="group__lavfi__buffersink.html#ga87d2066b9a7f5dfaff00a0e0ac2e25e7">av_abuffersink_params_alloc</a> </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Create an <a class="el" href="structAVABufferSinkParams.html" title="Struct to use for initializing an abuffersink context.">AVABufferSinkParams</a> structure. </p>
<p>Must be freed with <a class="el" href="group__lavu__mem.html#ga0c9096f498624c525aa2315b8a20c411" title="Free a memory block which has been allocated with av_malloc(z)() or av_realloc().">av_free()</a>. </p>
</div>
</div>
<a class="anchor" id="ga359d7d1e42c27ca14c07559d4e9adba7"></a><!-- doxytag: member="buffersink.h::av_buffersink_set_frame_size" ref="ga359d7d1e42c27ca14c07559d4e9adba7" args="(AVFilterContext *ctx, unsigned frame_size)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void <a class="el" href="group__lavfi__buffersink.html#ga359d7d1e42c27ca14c07559d4e9adba7">av_buffersink_set_frame_size</a> </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structAVFilterContext.html">AVFilterContext</a> * </td>
<td class="paramname"><em>ctx</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned </td>
<td class="paramname"><em>frame_size</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the frame size for an audio buffer sink. </p>
<p>All calls to av_buffersink_get_buffer_ref will return a buffer with exactly the specified number of samples, or <a class="el" href="group__lavu__error.html#gae4bb6f165973d09584e0ec0f335f69ca">AVERROR(EAGAIN)</a> if there is not enough. The last buffer at EOF will be padded with 0. </p>
</div>
</div>
<a class="anchor" id="ga9e788b28139d9b5063676ac81870737b"></a><!-- doxytag: member="buffersink.h::av_buffersink_get_frame_rate" ref="ga9e788b28139d9b5063676ac81870737b" args="(AVFilterContext *ctx)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structAVRational.html">AVRational</a> <a class="el" href="group__lavfi__buffersink.html#ga9e788b28139d9b5063676ac81870737b">av_buffersink_get_frame_rate</a> </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structAVFilterContext.html">AVFilterContext</a> * </td>
<td class="paramname"><em>ctx</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the frame rate of the input. </p>
</div>
</div>
<a class="anchor" id="ga653228f4cbca427c654d844a5fc59cfa"></a><!-- doxytag: member="buffersink.h::av_buffersink_get_frame" ref="ga653228f4cbca427c654d844a5fc59cfa" args="(AVFilterContext *ctx, AVFrame *frame)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int <a class="el" href="group__lavfi__buffersink.html#ga653228f4cbca427c654d844a5fc59cfa">av_buffersink_get_frame</a> </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structAVFilterContext.html">AVFilterContext</a> * </td>
<td class="paramname"><em>ctx</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structAVFrame.html">AVFrame</a> * </td>
<td class="paramname"><em>frame</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get a frame with filtered data from sink and put it in frame. </p>
<dl class="params"><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">ctx</td><td>pointer to a context of a buffersink or abuffersink <a class="el" href="structAVFilter.html" title="Filter definition.">AVFilter</a>. </td></tr>
<tr><td class="paramname">frame</td><td>pointer to an allocated frame that will be filled with data. The data must be freed using <a class="el" href="group__lavu__frame.html#ga0a2b687f9c1c5ed0089b01fd61227108" title="Unreference all the buffers referenced by frame and reset the frame fields.">av_frame_unref()</a> / <a class="el" href="group__lavu__frame.html#ga979d73f3228814aee56aeca0636e37cc" title="Free the frame and any dynamically allocated objects in it, e.g.">av_frame_free()</a></td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><ul>
<li>>= 0 if a frame was successfully returned.</li>
<li><a class="el" href="group__lavu__error.html#gae4bb6f165973d09584e0ec0f335f69ca">AVERROR(EAGAIN)</a> if no frames are available at this point; more input frames must be added to the filtergraph to get more output.</li>
<li>AVERROR_EOF if there will be no more output frames on this sink.</li>
<li>A different negative AVERROR code in other failure cases. </li>
</ul>
</dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="filter_audio_8c-example.html#a55">filter_audio.c</a>, <a class="el" href="filtering_audio_8c-example.html#a80">filtering_audio.c</a>, <a class="el" href="filtering_video_8c-example.html#a74">filtering_video.c</a>, and <a class="el" href="transcoding_8c-example.html#a107">transcoding.c</a>.</dd>
</dl>
<p>Referenced by <a class="el" href="transcoding_8c_source.html#l00402">filter_encode_write_frame()</a>, and <a class="el" href="filter__audio_8c_source.html#l00270">main()</a>.</p>
</div>
</div>
<a class="anchor" id="ga9c06b3744579f165cc032160c154828a"></a><!-- doxytag: member="buffersink.h::av_buffersink_get_samples" ref="ga9c06b3744579f165cc032160c154828a" args="(AVFilterContext *ctx, AVFrame *frame, int nb_samples)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int <a class="el" href="group__lavfi__buffersink.html#ga9c06b3744579f165cc032160c154828a">av_buffersink_get_samples</a> </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structAVFilterContext.html">AVFilterContext</a> * </td>
<td class="paramname"><em>ctx</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structAVFrame.html">AVFrame</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>nb_samples</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Same as <a class="el" href="group__lavfi__buffersink.html#ga653228f4cbca427c654d844a5fc59cfa" title="Get a frame with filtered data from sink and put it in frame.">av_buffersink_get_frame()</a>, but with the ability to specify the number of samples read. </p>
<p>This function is less efficient than <a class="el" href="group__lavfi__buffersink.html#ga653228f4cbca427c654d844a5fc59cfa" title="Get a frame with filtered data from sink and put it in frame.">av_buffersink_get_frame()</a>, because it copies the data around.</p>
<dl class="params"><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">ctx</td><td>pointer to a context of the abuffersink <a class="el" href="structAVFilter.html" title="Filter definition.">AVFilter</a>. </td></tr>
<tr><td class="paramname">frame</td><td>pointer to an allocated frame that will be filled with data. The data must be freed using <a class="el" href="group__lavu__frame.html#ga0a2b687f9c1c5ed0089b01fd61227108" title="Unreference all the buffers referenced by frame and reset the frame fields.">av_frame_unref()</a> / <a class="el" href="group__lavu__frame.html#ga979d73f3228814aee56aeca0636e37cc" title="Free the frame and any dynamically allocated objects in it, e.g.">av_frame_free()</a> frame will contain exactly nb_samples audio samples, except at the end of stream, when it can contain less than nb_samples.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The return codes have the same meaning as for <a class="el" href="group__lavfi__buffersink.html#ga9c06b3744579f165cc032160c154828a" title="Same as av_buffersink_get_frame(), but with the ability to specify the number of samples read...">av_buffersink_get_samples()</a>.</dd></dl>
<dl class="warning"><dt><b>Warning:</b></dt><dd>do not mix this function with <a class="el" href="group__lavfi__buffersink.html#ga653228f4cbca427c654d844a5fc59cfa" title="Get a frame with filtered data from sink and put it in frame.">av_buffersink_get_frame()</a>. Use only one or the other with a single sink, not both. </dd></dl>
</div>
</div>
</div><!-- contents -->
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Defines</a></div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<hr class="footer"/><address class="footer"><small>
Generated by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.7.6.1
</small></address>
</body>
</html>