diff options
| author | Ralph Giles <giles@xiph.org> | 2004-09-28 06:21:08 +0000 |
|---|---|---|
| committer | Ralph Giles <giles@xiph.org> | 2004-09-28 06:21:08 +0000 |
| commit | 7a1fb6f949dfca7597bbef5eaef19a347cfef1eb (patch) | |
| tree | cd5a6088f84c2106ea6a35c7580a872342a2c521 /doc | |
| parent | 81e8703c56912875171e69ebb8f34a966266a8d3 (diff) | |
| download | ogg-git-7a1fb6f949dfca7597bbef5eaef19a347cfef1eb.tar.gz | |
additional verbosity on ogg_stream_packetout()
svn path=/trunk/ogg/; revision=7889
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/ogg/ogg_stream_packetout.html | 12 |
1 files changed, 6 insertions, 6 deletions
diff --git a/doc/ogg/ogg_stream_packetout.html b/doc/ogg/ogg_stream_packetout.html index d879339..bc57e85 100644 --- a/doc/ogg/ogg_stream_packetout.html +++ b/doc/ogg/ogg_stream_packetout.html @@ -17,8 +17,8 @@ <p><i>declared in "ogg/ogg.h";</i></p> -<p>This function assembles a raw data packet for output to the codec decoding engine. The data is already in the stream and broken into packet segments.</p> -<p>In a typical decoding situation, this should be used after calling <a href="ogg_stream_pagein.html">ogg_stream_pagein()</a> to submit a page of data to the bitstream.</p> +<p>This function assembles a raw data packet for output to the codec decoding engine. The data is already in the stream and broken into packet segments. Each successive call returns the next complete packet built from those segments.</p> +<p>In a typical decoding situation, this should be used after calling <a href="ogg_stream_pagein.html">ogg_stream_pagein()</a> to submit a page of data to the bitstream. If the function returns 0, more data is needed and another page should be submitted. A non-zero return value indicates successful return of a packet.</p> <br><br> <table border=0 color=black cellspacing=0 cellpadding=7> @@ -46,9 +46,9 @@ function is called.</dd> <h3>Return Values</h3> <blockquote> <ul> -<li>-1 if we are out of sync and there is a gap in the data. Usually this will not be a fatal error.</li> -<li>0 if there is no data available, or only a partial packet. -<li>1 in all other cases.</li> +<li>-1 if we are out of sync and there is a gap in the data. Usually this will not be a fatal error. <i>op</i> contains a the first packet decodable after the hole.</li> +<li>0 if there is insufficient data available to complete a packet. <i>op</i> has not been updated. +<li>1 if a packet was assembled normally. <i>op</i> contains the next packet from the stream.</li> </ul> </blockquote> @@ -58,7 +58,7 @@ function is called.</dd> <table border=0 width=100%> <tr valign=top> -<td><p class=tiny>copyright © 2000 xiph.org</p></td> +<td><p class=tiny>copyright © 2004 xiph.org</p></td> <td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/index.html">Ogg Vorbis</a><br><a href="mailto:team@xiph.org">team@xiph.org</a></p></td> </tr><tr> <td><p class=tiny>libogg documentation</p></td> |