vorbis_synthesis_pcmout.html 2.2 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576
  1. <html>
  2. <head>
  3. <title>libvorbis - function - vorbis_synthesis_pcmout</title>
  4. <link rel=stylesheet href="style.css" type="text/css">
  5. </head>
  6. <body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
  7. <table border=0 width=100%>
  8. <tr>
  9. <td><p class=tiny>libvorbis documentation</p></td>
  10. <td align=right><p class=tiny>libvorbis version 1.3.2 - 20101101</p></td>
  11. </tr>
  12. </table>
  13. <h1>vorbis_synthesis_pcmout</h1>
  14. <p><i>declared in "vorbis/codec.h";</i></p>
  15. <p>This function retrieves buffers containing decoded audio samples.</p>
  16. <p>The application is not required to make use of all of the samples
  17. made available to it by one call to this function before it continues to
  18. decode. Use <a href="vorbis_synthesis_read.html">vorbis_synthesis_read</a>
  19. to inform the decoder of how many samples were actually used. Any
  20. unused samples will be included in the buffers output by the next call
  21. to this function.</p>
  22. <table border=0 color=black cellspacing=0 cellpadding=7>
  23. <tr bgcolor=#cccccc>
  24. <td>
  25. <pre><b>
  26. extern int vorbis_synthesis_pcmout(vorbis_dsp_state *v,float ***pcm);
  27. </b></pre>
  28. </td>
  29. </tr>
  30. </table>
  31. <h3>Parameters</h3>
  32. <dl>
  33. <dt><i>v</i></dt>
  34. <dd>The <a href="vorbis_dsp_state.html">vorbis_dsp_state</a> for the
  35. decoder instance.</dd>
  36. <dt><i>pcm</i></dt>
  37. <dd>A pointer to a float** which will be made to point to an array of
  38. pointers to the decoded samples for each channel. The memory is owned
  39. by the decoder instance and will be freed when the application continues
  40. decoding or destroys the decoder instance. This can be NULL, in which
  41. case the return value gives the number of samples that would be returned
  42. if this function were called with a non-NULL pointer here.</dd>
  43. </dl>
  44. <h3>Return Values</h3>
  45. <blockquote>
  46. <li>The number of samples available in the output buffer.</li>
  47. <li>0 if no more samples are currently available.</li>
  48. </blockquote>
  49. <p>
  50. <br><br>
  51. <hr noshade>
  52. <table border=0 width=100%>
  53. <tr valign=top>
  54. <td><p class=tiny>copyright &copy; 2010 Xiph.Org</p></td>
  55. <td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/index.html">Ogg Vorbis</a></p></td>
  56. </tr><tr>
  57. <td><p class=tiny>libvorbis documentation</p></td>
  58. <td align=right><p class=tiny>libvorbis version 1.3.2 - 20101101</p></td>
  59. </tr>
  60. </table>
  61. </body>
  62. </html>