Mercurial > hg > sv-dependency-builds

comparison src/libvorbis-1.3.3/doc/vorbisenc/changes.html @ 1:05aa0afa9217

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Bring in flac, ogg, vorbis
author Chris Cannam
date Tue, 19 Mar 2013 17:37:49 +0000
parents
children
comparison
equal deleted inserted replaced
0:c7265573341e 1:05aa0afa9217
1 <html>
2
3 <head>
4 <title>libvorbisenc - Documentation</title>
5 <link rel=stylesheet href="style.css" type="text/css">
6 </head>
7
8 <body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
9 <table border=0 width=100%>
10 <tr>
11 <td><p class=tiny>libvorbisenc documentation</p></td>
12 <td align=right><p class=tiny>libvorbisenc version 1.3.2 - 20101101</p></td>
13 </tr>
14 </table>
15
16 <h1>Libvorbisenc API changes 1.0 through 1.1</h1>
17
18 This document describes API additions to libvorbisenc between release
19 1.0 and 1.1.
20
21 <h2>1.0.1</h2>
22
23 The programming API and binary application ABI are unchanged and fully
24 forward/backward compatible between release 1.0 and 1.0.1. Libvorbis,
25 libvorbisenc and libvorbisfile must match versions amongst themselves,
26 however.
27
28 <h2>1.1</h2>
29
30 The binary ABI from release 1.0.1 to 1.1 is backward compatible;
31 applications linked against libvorbis/libvorbisenc 1.0 and 1.0.1 will
32 continue to function correctly when upgrading the libvorbis and
33 libvorbisenc dynamic libraries without re-linking. <p>
34
35 Release 1.1 adds several possible requests to the libvorbisenc <a
36 href="vorbis_encode_ctl.html">vorbis_encode_ctl()</a> call in order to
37 reflect the shift to <a href="overview.html#BBR">bit-reservoir style
38 bitrate management</a>. In addition, several <a
39 href="vorbis_encode_ctl.html">vorbis_encode_ctl()</a> requests are
40 deprecated (but functional) as they are redered semantically obsolete
41 by the <a href="overview.html#BBR">new bitrate management</a>.<p>
42
43 <h3>Deprecated in 1.1</h3>
44
45 These calls are still available to older codebases to preserve
46 compatability; the fields of the <a
47 href="ovectl_ratemanage_arg.html">ovectl_ratemanage_arg</a> argument
48 are mapped as closely as possible to the fields of the new <a
49 href="ovectl_ratemanage2_arg.html">ovectl_ratemanage2_arg</a>
50 structure.
51
52 <dl>
53 <dt><a href="vorbis_encode_ctl.html#OV_ECTL_RATEMANAGE_GET">OV_ECTL_RATEMANAGE_GET</a>:<dd> Use <a
54 href="vorbis_encode_ctl.html#OV_ECTL_RATEMANAGE2_GET">OV_ECTL_RATEMANAGE2_GET</a>
55 instead.
56
57
58 <dt><a href="vorbis_encode_ctl.html#OV_ECTL_RATEMANAGE_SET">OV_ECTL_RATEMANAGE_SET</a>:<dd> Use <a
59 href="vorbis_encode_ctl.html#OV_ECTL_RATEMANAGE2_SET">OV_ECTL_RATEMANAGE2_SET</a>
60 instead.
61
62 <dt><a href="vorbis_encode_ctl.html#OV_ECTL_RATEMANAGE_AVG">OV_ECTL_RATEMANAGE_AVG</a>:<dd> Use <a
63 href="vorbis_encode_ctl.html#OV_ECTL_RATEMANAGE2_SET">OV_ECTL_RATEMANAGE2_SET</a>
64 instead.
65
66 <dt><a href="vorbis_encode_ctl.html#OV_ECTL_RATEMANAGE_HARD">OV_ECTL_RATEMANAGE_HARD</a>:<dd> Use <a
67 href="vorbis_encode_ctl.html#OV_ECTL_RATEMANAGE2_SET">OV_ECTL_RATEMANAGE2_SET</a>
68 instead.
69 </dl>
70
71 <h3>Newly added in 1.1</h3>
72
73 The following calls are added in 1.1 to semantically reflect movement
74 to a <a href="overview.html#BBR">bit-reservoir-based bitrate
75 management</a> scheme by introducing the <a
76 href="ovectl_ratemanage2_arg.html">ovectl_ratemanage2_arg</a>
77 structure in order to better represent the abilities of the bitrate
78 manager.<p>
79
80 <dl>
81 <dt><a href="vorbis_encode_ctl.html#OV_ECTL_RATEMANAGE2_GET">OV_ECTL_RATEMANAGE2_GET</a><dd>
82
83 Used to query the current state of bitrate management setup.
84
85 <dt><a href="vorbis_encode_ctl.html#OV_ECTL_RATEMANAGE2_SET">OV_ECTL_RATEMANAGE2_SET</a><dd>
86
87 Used to set or alter bitrate management settings.
88 </dl>
89
90 <br><br>
91 <hr noshade>
92 <table border=0 width=100%>
93 <tr valign=top>
94 <td><p class=tiny>copyright &copy; 2000-2010 Xiph.Org</p></td>
95 <td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/">Ogg Vorbis</a></p></td>
96 </tr><tr>
97 <td><p class=tiny>libvorbisenc documentation</p></td>
98 <td align=right><p class=tiny>libvorbisenc version 1.3.2 - 20101101</p></td>
99 </tr>
100 </table>
101
102 </body>
103
104 </html>