summaryrefslogtreecommitdiffhomepage
path: root/doc/libvorbis/vorbis_synthesis_lapout.html
blob: 7fcdf0639c288bcd4aec02095fab7c7783f0fa32 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
<html>

<head>
<title>libvorbis - function - vorbis_synthesis_lapout</title>
<link rel=stylesheet href="style.css" type="text/css">
</head>

<body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
<table border=0 width=100%>
<tr>
<td><p class=tiny>libvorbis documentation</p></td>
<td align=right><p class=tiny>libvorbis version 1.3.2 - 20101101</p></td>
</tr>
</table>

<h1>vorbis_synthesis_lapout</h1>

<p><i>declared in "vorbis/codec.h";</i></p>

<p>This function retrieves buffers containing decoded audio samples, similarly
to <a href="vorbis_synthesis_pcmout.html">vorbis_synthesis_pcmout</a>.
However, it includes some extra samples extrapolated from the end of
the audio, suitable for crosslapping with other blocks. This exists mainly
for <a href="../vorbisfile/index.html">libvorbisfile</a> to use for
handling chained bitstreams and bitstreams with holes.</p>

<table border=0 color=black cellspacing=0 cellpadding=7>
<tr bgcolor=#cccccc>
	<td>
<pre><b>
extern int      vorbis_synthesis_lapout(vorbis_dsp_state *v,float ***pcm);
</b></pre>
	</td>
</tr>
</table>

<h3>Parameters</h3>
<dl>
<dt><i>v</i></dt>
<dd>The <a href="vorbis_dsp_state.html">vorbis_dsp_state</a> for the
decoder instance.</dd>
<dt><i>pcm</i></dt>
<dd>A pointer to a float** which will be made to point to an array of
pointers to the decoded samples for each channel. The memory is owned
by the decoder instance and will be freed when the application continues
decoding or destroys the decoder instance. This can be NULL, in which
case the return value gives the number of samples that would be returned
if this function were called with a non-NULL pointer here.</dd>
</dl>


<h3>Return Values</h3>
<blockquote>
<li>The number of samples available in the output buffer.</li>
<li>0 if no more samples are currently available.</li>
</blockquote>
<p>

<br><br>
<hr noshade>
<table border=0 width=100%>
<tr valign=top>
<td><p class=tiny>copyright &copy; 2010 Xiph.Org</p></td>
<td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/index.html">Ogg Vorbis</a></p></td>
</tr><tr>
<td><p class=tiny>libvorbis documentation</p></td>
<td align=right><p class=tiny>libvorbis version 1.3.2 - 20101101</p></td>
</tr>
</table>


</body>

</html>