mirror of
https://github.com/cookiengineer/audacity
synced 2025-10-10 16:43:33 +02:00
Reverting r12850...hopefully
Never removed one before, but I'm pretty sure it is correct.
This commit is contained in:
lllucius
@@ -115,8 +115,8 @@ application.</dd>
|
||||
<dt><i>seekable</i></dt>
|
||||
<dd>Read-only int indicating whether file is seekable. E.g., a physical file is seekable, a pipe isn't.</dd>
|
||||
<dt><i>links</i></dt>
|
||||
<dd>Read-only int indicating the number of logical bitstreams within the physical bitstream.</dd>
|
||||
<dt><i>ov_callbacks</i></dt>
|
||||
<dd>Read-only int indicating the number of logical bitstreams within the physical bitstream.</dd>
|
||||
<dt><i>ov_callbacks</i></dt>
|
||||
<dd>Collection of file manipulation routines to be used on this data source. When using stdio/FILE access via <a href="ov_open.html">ov_open()</a>, the callbacks will be filled in with stdio calls or wrappers to stdio calls.</dd>
|
||||
</dl>
|
||||
|
||||
|
||||
@@ -1,95 +1,95 @@
|
||||
<html>
|
||||
|
||||
<head>
|
||||
<title>Vorbisfile - File Information</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>Vorbisfile documentation</p></td>
|
||||
<td align=right><p class=tiny>vorbisfile version 1.3.2 - 20101101</p></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h1>File Information</h1>
|
||||
<p>Libvorbisfile contains many functions to get information about bitstream attributes and decoding status.
|
||||
<p>
|
||||
All libvorbisfile file information routines are declared in "vorbis/vorbisfile.h".
|
||||
<p>
|
||||
|
||||
<table border=1 color=black width=50% cellspacing=0 cellpadding=7>
|
||||
<tr bgcolor=#cccccc>
|
||||
<td><b>function</b></td>
|
||||
<td><b>purpose</b></td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_bitrate.html">ov_bitrate</a></td>
|
||||
<td>Returns the average bitrate of the current logical bitstream.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_bitrate_instant.html">ov_bitrate_instant</a></td>
|
||||
<td>Returns the exact bitrate since the last call of this function, or -1 if at the beginning of the bitream or no new information is available.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_streams.html">ov_streams</a></td>
|
||||
<td>Gives the number of logical bitstreams within the current physical bitstream.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_seekable.html">ov_seekable</a></td>
|
||||
<td>Indicates whether the bitstream is seekable.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_serialnumber.html">ov_serialnumber</a></td>
|
||||
<td>Returns the unique serial number of the specified logical bitstream.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_raw_total.html">ov_raw_total</a></td>
|
||||
<td>Returns the total (compressed) bytes in a physical or logical seekable bitstream.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_pcm_total.html">ov_pcm_total</a></td>
|
||||
<td>Returns the total number of samples in a physical or logical seekable bitstream.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_time_total.html">ov_time_total</a></td>
|
||||
<td>Returns the total time length in seconds of a physical or logical seekable bitstream.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_raw_tell.html">ov_raw_tell</a></td>
|
||||
<td>Returns the byte location of the next sample to be read, giving the approximate location in the stream that the decoding engine has reached.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_pcm_tell.html">ov_pcm_tell</a></td>
|
||||
<td>Returns the sample location of the next sample to be read, giving the approximate location in the stream that the decoding engine has reached.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_time_tell.html">ov_time_tell</a></td>
|
||||
<td>Returns the time location of the next sample to be read, giving the approximate location in the stream that the decoding engine has reached.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_info.html">ov_info</a></td>
|
||||
<td>Returns the <a href="../libvorbis/vorbis_info.html">vorbis_info</a> struct for a specific bitstream section.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_comment.html">ov_comment</a></td>
|
||||
<td>Returns attached <a href="../libvorbis/vorbis_comment.html">comments</a> for the current bitstream.</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<br><br>
|
||||
<hr noshade>
|
||||
<table border=0 width=100%>
|
||||
<tr valign=top>
|
||||
<td><p class=tiny>copyright © 2000-2010 Xiph.Org</p></td>
|
||||
<td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/">Ogg Vorbis</a></p></td>
|
||||
</tr><tr>
|
||||
<td><p class=tiny>Vorbisfile documentation</p></td>
|
||||
<td align=right><p class=tiny>vorbisfile version 1.3.2 - 20101101</p></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
<html>
|
||||
|
||||
<head>
|
||||
<title>Vorbisfile - File Information</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>Vorbisfile documentation</p></td>
|
||||
<td align=right><p class=tiny>vorbisfile version 1.3.2 - 20101101</p></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h1>File Information</h1>
|
||||
<p>Libvorbisfile contains many functions to get information about bitstream attributes and decoding status.
|
||||
<p>
|
||||
All libvorbisfile file information routines are declared in "vorbis/vorbisfile.h".
|
||||
<p>
|
||||
|
||||
<table border=1 color=black width=50% cellspacing=0 cellpadding=7>
|
||||
<tr bgcolor=#cccccc>
|
||||
<td><b>function</b></td>
|
||||
<td><b>purpose</b></td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_bitrate.html">ov_bitrate</a></td>
|
||||
<td>Returns the average bitrate of the current logical bitstream.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_bitrate_instant.html">ov_bitrate_instant</a></td>
|
||||
<td>Returns the exact bitrate since the last call of this function, or -1 if at the beginning of the bitream or no new information is available.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_streams.html">ov_streams</a></td>
|
||||
<td>Gives the number of logical bitstreams within the current physical bitstream.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_seekable.html">ov_seekable</a></td>
|
||||
<td>Indicates whether the bitstream is seekable.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_serialnumber.html">ov_serialnumber</a></td>
|
||||
<td>Returns the unique serial number of the specified logical bitstream.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_raw_total.html">ov_raw_total</a></td>
|
||||
<td>Returns the total (compressed) bytes in a physical or logical seekable bitstream.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_pcm_total.html">ov_pcm_total</a></td>
|
||||
<td>Returns the total number of samples in a physical or logical seekable bitstream.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_time_total.html">ov_time_total</a></td>
|
||||
<td>Returns the total time length in seconds of a physical or logical seekable bitstream.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_raw_tell.html">ov_raw_tell</a></td>
|
||||
<td>Returns the byte location of the next sample to be read, giving the approximate location in the stream that the decoding engine has reached.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_pcm_tell.html">ov_pcm_tell</a></td>
|
||||
<td>Returns the sample location of the next sample to be read, giving the approximate location in the stream that the decoding engine has reached.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_time_tell.html">ov_time_tell</a></td>
|
||||
<td>Returns the time location of the next sample to be read, giving the approximate location in the stream that the decoding engine has reached.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_info.html">ov_info</a></td>
|
||||
<td>Returns the <a href="../libvorbis/vorbis_info.html">vorbis_info</a> struct for a specific bitstream section.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_comment.html">ov_comment</a></td>
|
||||
<td>Returns attached <a href="../libvorbis/vorbis_comment.html">comments</a> for the current bitstream.</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<br><br>
|
||||
<hr noshade>
|
||||
<table border=0 width=100%>
|
||||
<tr valign=top>
|
||||
<td><p class=tiny>copyright © 2000-2010 Xiph.Org</p></td>
|
||||
<td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/">Ogg Vorbis</a></p></td>
|
||||
</tr><tr>
|
||||
<td><p class=tiny>Vorbisfile documentation</p></td>
|
||||
<td align=right><p class=tiny>vorbisfile version 1.3.2 - 20101101</p></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
|
||||
@@ -1,107 +1,107 @@
|
||||
<html>
|
||||
|
||||
<head>
|
||||
<title>Vorbisfile - Seeking</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>Vorbisfile documentation</p></td>
|
||||
<td align=right><p class=tiny>vorbisfile version 1.3.2 - 20101101</p></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h1>Seeking</h1>
|
||||
<p>Seeking functions allow you to specify a specific point in the stream to begin or continue decoding.
|
||||
<p>
|
||||
All libvorbisfile seeking routines are declared in "vorbis/vorbisfile.h".
|
||||
|
||||
<p>Certain seeking functions are best suited to different situations.
|
||||
When speed is important and exact positioning isn't required,
|
||||
page-level seeking should be used. Note also that Vorbis files do not
|
||||
necessarily start at a sample number or time offset of zero. Do not
|
||||
be surprised if a file begins at a positive offset of several minutes
|
||||
or hours, such as would happen if a large stream (such as a concert
|
||||
recording) is chopped into multiple separate files. Requesting to
|
||||
seek to a position before the beginning of such a file will seek to
|
||||
the position where audio begins.
|
||||
|
||||
<p>As of vorbisfile version 1.68, seeking also optionally provides
|
||||
automatic crosslapping to eliminate clicks and other discontinuity
|
||||
artifacts at seeking boundaries. This fetaure is of particular
|
||||
interest to player and game developers implementing dynamic music and
|
||||
audio engines, or others looking for smooth transitions within a
|
||||
single sample or across multiple samples.<p>
|
||||
|
||||
<p>Naturally, seeking is available only within a seekable file or
|
||||
stream. Seeking functions will return <tt>OV_ENOSEEK</tt> on
|
||||
nonseekable files and streams.
|
||||
|
||||
</ul>
|
||||
|
||||
<table border=1 color=black width=50% cellspacing=0 cellpadding=7>
|
||||
<tr bgcolor=#cccccc>
|
||||
<td><b>function</b></td>
|
||||
<td><b>purpose</b></td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_raw_seek.html">ov_raw_seek</a></td>
|
||||
<td>This function seeks to a position specified in the compressed bitstream, specified in bytes.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_pcm_seek.html">ov_pcm_seek</a></td>
|
||||
<td>This function seeks to a specific audio sample number, specified in pcm samples.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_pcm_seek_page.html">ov_pcm_seek_page</a></td>
|
||||
<td>This function seeks to the closest page preceding the specified audio sample number, specified in pcm samples.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_time_seek.html">ov_time_seek</a></td>
|
||||
<td>This function seeks to the specific time location in the bitstream, specified in seconds </td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_time_seek_page.html">ov_time_seek_page</a></td>
|
||||
<td>This function seeks to the closest page preceding the specified time position in the bitstream</td>
|
||||
</tr>
|
||||
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_raw_seek_lap.html">ov_raw_seek_lap</a></td>
|
||||
<td>This function seeks to a position specified in the compressed bitstream, specified in bytes. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities. </td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_pcm_seek_lap.html">ov_pcm_seek_lap</a></td>
|
||||
<td>This function seeks to a specific audio sample number, specified in pcm samples. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_pcm_seek_page_lap.html">ov_pcm_seek_page_lap</a></td>
|
||||
<td>This function seeks to the closest page preceding the specified audio sample number, specified in pcm samples. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_time_seek_lap.html">ov_time_seek_lap</a></td>
|
||||
<td>This function seeks to the specific time location in the bitstream, specified in seconds. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities. </td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_time_seek_page_lap.html">ov_time_seek_page_lap</a></td>
|
||||
<td>This function seeks to the closest page preceding the specified time position in the bitstream. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities.</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<br><br>
|
||||
<hr noshade>
|
||||
<table border=0 width=100%>
|
||||
<tr valign=top>
|
||||
<td><p class=tiny>copyright © 2000-2010 Xiph.Org</p></td>
|
||||
<td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/">Ogg Vorbis</a></p></td>
|
||||
</tr><tr>
|
||||
<td><p class=tiny>Vorbisfile documentation</p></td>
|
||||
<td align=right><p class=tiny>vorbisfile version 1.3.2 - 20101101</p></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
<html>
|
||||
|
||||
<head>
|
||||
<title>Vorbisfile - Seeking</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>Vorbisfile documentation</p></td>
|
||||
<td align=right><p class=tiny>vorbisfile version 1.3.2 - 20101101</p></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h1>Seeking</h1>
|
||||
<p>Seeking functions allow you to specify a specific point in the stream to begin or continue decoding.
|
||||
<p>
|
||||
All libvorbisfile seeking routines are declared in "vorbis/vorbisfile.h".
|
||||
|
||||
<p>Certain seeking functions are best suited to different situations.
|
||||
When speed is important and exact positioning isn't required,
|
||||
page-level seeking should be used. Note also that Vorbis files do not
|
||||
necessarily start at a sample number or time offset of zero. Do not
|
||||
be surprised if a file begins at a positive offset of several minutes
|
||||
or hours, such as would happen if a large stream (such as a concert
|
||||
recording) is chopped into multiple separate files. Requesting to
|
||||
seek to a position before the beginning of such a file will seek to
|
||||
the position where audio begins.
|
||||
|
||||
<p>As of vorbisfile version 1.68, seeking also optionally provides
|
||||
automatic crosslapping to eliminate clicks and other discontinuity
|
||||
artifacts at seeking boundaries. This fetaure is of particular
|
||||
interest to player and game developers implementing dynamic music and
|
||||
audio engines, or others looking for smooth transitions within a
|
||||
single sample or across multiple samples.<p>
|
||||
|
||||
<p>Naturally, seeking is available only within a seekable file or
|
||||
stream. Seeking functions will return <tt>OV_ENOSEEK</tt> on
|
||||
nonseekable files and streams.
|
||||
|
||||
</ul>
|
||||
|
||||
<table border=1 color=black width=50% cellspacing=0 cellpadding=7>
|
||||
<tr bgcolor=#cccccc>
|
||||
<td><b>function</b></td>
|
||||
<td><b>purpose</b></td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_raw_seek.html">ov_raw_seek</a></td>
|
||||
<td>This function seeks to a position specified in the compressed bitstream, specified in bytes.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_pcm_seek.html">ov_pcm_seek</a></td>
|
||||
<td>This function seeks to a specific audio sample number, specified in pcm samples.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_pcm_seek_page.html">ov_pcm_seek_page</a></td>
|
||||
<td>This function seeks to the closest page preceding the specified audio sample number, specified in pcm samples.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_time_seek.html">ov_time_seek</a></td>
|
||||
<td>This function seeks to the specific time location in the bitstream, specified in seconds </td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_time_seek_page.html">ov_time_seek_page</a></td>
|
||||
<td>This function seeks to the closest page preceding the specified time position in the bitstream</td>
|
||||
</tr>
|
||||
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_raw_seek_lap.html">ov_raw_seek_lap</a></td>
|
||||
<td>This function seeks to a position specified in the compressed bitstream, specified in bytes. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities. </td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_pcm_seek_lap.html">ov_pcm_seek_lap</a></td>
|
||||
<td>This function seeks to a specific audio sample number, specified in pcm samples. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_pcm_seek_page_lap.html">ov_pcm_seek_page_lap</a></td>
|
||||
<td>This function seeks to the closest page preceding the specified audio sample number, specified in pcm samples. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities.</td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_time_seek_lap.html">ov_time_seek_lap</a></td>
|
||||
<td>This function seeks to the specific time location in the bitstream, specified in seconds. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities. </td>
|
||||
</tr>
|
||||
<tr valign=top>
|
||||
<td><a href="ov_time_seek_page_lap.html">ov_time_seek_page_lap</a></td>
|
||||
<td>This function seeks to the closest page preceding the specified time position in the bitstream. The boundary between the old and new playback positions is crosslapped to eliminate discontinuities.</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<br><br>
|
||||
<hr noshade>
|
||||
<table border=0 width=100%>
|
||||
<tr valign=top>
|
||||
<td><p class=tiny>copyright © 2000-2010 Xiph.Org</p></td>
|
||||
<td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/">Ogg Vorbis</a></p></td>
|
||||
</tr><tr>
|
||||
<td><p class=tiny>Vorbisfile documentation</p></td>
|
||||
<td align=right><p class=tiny>vorbisfile version 1.3.2 - 20101101</p></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
|
||||
Reference in New Issue
Block a user