File: oggz__deprecated_8h.html

package info (click to toggle)
liboggz 1.1.1-8
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, sid, trixie
  • size: 4,348 kB
  • sloc: ansic: 14,332; sh: 10,385; makefile: 467
file content (225 lines) | stat: -rw-r--r-- 14,396 bytes parent folder | download | duplicates (5)
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>liboggz: oggz_deprecated.h File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.6.3 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul>
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
    </ul>
  </div>
  <div class="tabs">
    <ul>
      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
      <li><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
</div>
<div class="contents">
<h1>oggz_deprecated.h File Reference</h1>
<p>Deprecated interfaces.  
<a href="#_details">More...</a></p>

<p><a href="oggz__deprecated_8h_source.html">Go to the source code of this file.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__deprecated_8h.html#aaa24ef96507165b2c5e1ac4108d59288">OGGZ_ERR_USER_STOPPED</a>&nbsp;&nbsp;&nbsp;OGGZ_ERR_STOP_OK</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">DEPRECATED CONSTANT.  <a href="#aaa24ef96507165b2c5e1ac4108d59288"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__deprecated_8h.html#a0d9b4d212038e72fb45d751fe750d3cf">OGGZ_ERR_READ_STOP_OK</a>&nbsp;&nbsp;&nbsp;OGGZ_ERR_STOP_OK</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">DEPRECATED CONSTANT.  <a href="#a0d9b4d212038e72fb45d751fe750d3cf"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__deprecated_8h.html#a7fb3e5030a672e6ecfd8e8e6bf57fdfa">OGGZ_ERR_READ_STOP_ERR</a>&nbsp;&nbsp;&nbsp;OGGZ_ERR_STOP_ERR</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">DEPRECATED CONSTANT.  <a href="#a7fb3e5030a672e6ecfd8e8e6bf57fdfa"></a><br/></td></tr>
<tr><td colspan="2"><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__deprecated_8h.html#a12f232bca448853e66a1226ddccff7e0">oggz_set_metric_linear</a> (<a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> *oggz, long serialno, ogg_int64_t granule_rate_numerator, ogg_int64_t granule_rate_denominator)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">DEPRECATED FUNCTION This function has been replaced with the more clearly named <a class="el" href="group__metric.html#gaa2a86ec590161bc2295a2c8e91cefa49" title="Specify the granulerate of a logical bitstream.">oggz_set_granulerate()</a>.  <a href="#a12f232bca448853e66a1226ddccff7e0"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">ogg_packet *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="oggz__deprecated_8h.html#aab908fe161372aceb99f98a3be54ead5">oggz_comment_generate</a> (<a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> *oggz, long serialno, <a class="el" href="oggz__constants_8h.html#ab20058e3d54fc5540aa719a99e1e9598">OggzStreamContent</a> packet_type, int FLAC_final_metadata_block)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">DEPRECATED FUNCTION This function has been replaced with <a class="el" href="oggz__comments_8h.html#a1ee69481fa517d80e63db962a23d53ae" title="Output a comment packet for the specified stream.">oggz_comments_generate()</a>, which does not require the packet_type argument.  <a href="#aab908fe161372aceb99f98a3be54ead5"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Deprecated interfaces. </p>
<hr/><h2>Define Documentation</h2>
<a class="anchor" id="a7fb3e5030a672e6ecfd8e8e6bf57fdfa"></a><!-- doxytag: member="oggz_deprecated.h::OGGZ_ERR_READ_STOP_ERR" ref="a7fb3e5030a672e6ecfd8e8e6bf57fdfa" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define OGGZ_ERR_READ_STOP_ERR&nbsp;&nbsp;&nbsp;OGGZ_ERR_STOP_ERR</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>DEPRECATED CONSTANT. </p>
<p>OGGZ_ERR_READ_STOP_OK, OGGZ_ERR_READ_STOP_ERR were introduced to allow the user to differentiate between a cancelled oggz_read_*() returning due to error or an ok condition. From 0.9.4 similar functionality was added for oggz_write_*(), hence this constant was renamed. </p>

</div>
</div>
<a class="anchor" id="a0d9b4d212038e72fb45d751fe750d3cf"></a><!-- doxytag: member="oggz_deprecated.h::OGGZ_ERR_READ_STOP_OK" ref="a0d9b4d212038e72fb45d751fe750d3cf" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define OGGZ_ERR_READ_STOP_OK&nbsp;&nbsp;&nbsp;OGGZ_ERR_STOP_OK</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>DEPRECATED CONSTANT. </p>
<p>OGGZ_ERR_READ_STOP_OK, OGGZ_ERR_READ_STOP_ERR were introduced to allow the user to differentiate between a cancelled oggz_read_*() returning due to error or an ok condition. From 0.9.4 similar functionality was added for oggz_write_*(), hence this constant was renamed. </p>

</div>
</div>
<a class="anchor" id="aaa24ef96507165b2c5e1ac4108d59288"></a><!-- doxytag: member="oggz_deprecated.h::OGGZ_ERR_USER_STOPPED" ref="aaa24ef96507165b2c5e1ac4108d59288" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define OGGZ_ERR_USER_STOPPED&nbsp;&nbsp;&nbsp;OGGZ_ERR_STOP_OK</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>DEPRECATED CONSTANT. </p>
<p>OGGZ_ERR_USER_STOPPED was introduced during development (post 0.8.3), and is similar in functionality to and numerically equal to (ie. ABI compatible with) OGGZ_ERR_STOP_OK in &lt;<a class="el" href="oggz__constants_8h.html" title="General constants used by liboggz.">oggz/oggz_constants.h</a>&gt;. It was badly named, as the preferred functionality distinguishes between a user's OggzReadCallback returning OGGZ_STOP_OK or OGGZ_STOP_ERR; your code should distinguish between these two too :-) Hence, don't use this (unreleased) name in new code. </p>

</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="aab908fe161372aceb99f98a3be54ead5"></a><!-- doxytag: member="oggz_deprecated.h::oggz_comment_generate" ref="aab908fe161372aceb99f98a3be54ead5" args="(OGGZ *oggz, long serialno, OggzStreamContent packet_type, int FLAC_final_metadata_block)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">ogg_packet* oggz_comment_generate </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> *&nbsp;</td>
          <td class="paramname"> <em>oggz</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">long&nbsp;</td>
          <td class="paramname"> <em>serialno</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="oggz__constants_8h.html#ab20058e3d54fc5540aa719a99e1e9598">OggzStreamContent</a>&nbsp;</td>
          <td class="paramname"> <em>packet_type</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>FLAC_final_metadata_block</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>DEPRECATED FUNCTION This function has been replaced with <a class="el" href="oggz__comments_8h.html#a1ee69481fa517d80e63db962a23d53ae" title="Output a comment packet for the specified stream.">oggz_comments_generate()</a>, which does not require the packet_type argument. </p>
<p>Instead, the packet type is determined by the content type of the stream, which was discovered when the bos packet was passed to oggz_write_feed.</p>
<p>Output a comment packet for the specified stream. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>oggz</em>&nbsp;</td><td>A OGGZ* handle (created with OGGZ_WRITE) </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>serialno</em>&nbsp;</td><td>Identify a logical bitstream within <em>oggz</em> </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>packet_type</em>&nbsp;</td><td>Type of comment packet to generate, FLAC, OggPCM, Speex, Theora and Vorbis are supported </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>FLAC_final_metadata_block</em>&nbsp;</td><td>Set this to zero unless the packet_type is FLAC, and there are no further metadata blocks to follow. See note below for details. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A comment packet for the stream. When no longer needed it should be freed with <a class="el" href="oggz__comments_8h.html#a9301332e99b0397cff54c3593595b809" title="Free a packet and its payload.">oggz_packet_destroy()</a>. </dd></dl>
<dl><dt><b>Return values:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>NULL</em>&nbsp;</td><td>content type does not support comments, not enough memory or comment was too long for FLAC </td></tr>
  </table>
  </dd>
</dl>
<dl class="note"><dt><b>Note:</b></dt><dd>FLAC streams may contain multiple metadata blocks of different types. When encapsulated in Ogg the first of these must be a Vorbis comment packet but PADDING, APPLICATION, SEEKTABLE, CUESHEET and PICTURE may follow. The last metadata block must have its first bit set to 1. Since liboggz does not know whether you will supply more metadata blocks you must tell it if this is the last (or only) metadata block by setting FLAC_final_metadata_block to 1. <br/>
 As FLAC metadata blocks are limited in size to 16MB minus 1 byte, this function will refuse to produce longer comment packets for FLAC. <br/>
 See <a href="http://flac.sourceforge.net/format.html">http://flac.sourceforge.net/format.html</a> for more details. </dd></dl>

</div>
</div>
<a class="anchor" id="a12f232bca448853e66a1226ddccff7e0"></a><!-- doxytag: member="oggz_deprecated.h::oggz_set_metric_linear" ref="a12f232bca448853e66a1226ddccff7e0" args="(OGGZ *oggz, long serialno, ogg_int64_t granule_rate_numerator, ogg_int64_t granule_rate_denominator)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int oggz_set_metric_linear </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="oggz_8h.html#a672d218df13da45a4b41d5366211bfee">OGGZ</a> *&nbsp;</td>
          <td class="paramname"> <em>oggz</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">long&nbsp;</td>
          <td class="paramname"> <em>serialno</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">ogg_int64_t&nbsp;</td>
          <td class="paramname"> <em>granule_rate_numerator</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">ogg_int64_t&nbsp;</td>
          <td class="paramname"> <em>granule_rate_denominator</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>DEPRECATED FUNCTION This function has been replaced with the more clearly named <a class="el" href="group__metric.html#gaa2a86ec590161bc2295a2c8e91cefa49" title="Specify the granulerate of a logical bitstream.">oggz_set_granulerate()</a>. </p>
<p>Specify that a logical bitstream has a linear metric </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>oggz</em>&nbsp;</td><td>An OGGZ handle </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>serialno</em>&nbsp;</td><td>Identify the logical bitstream in <em>oggz</em> to attach this linear metric to. A value of -1 indicates that the metric should be attached to all unattached logical bitstreams in <em>oggz</em>. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>granule_rate_numerator</em>&nbsp;</td><td>The numerator of the granule rate </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>granule_rate_denominator</em>&nbsp;</td><td>The denominator of the granule rate </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>0 Success </dd></dl>
<dl><dt><b>Return values:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>OGGZ_ERR_BAD_SERIALNO</em>&nbsp;</td><td><em>serialno</em> does not identify an existing logical bitstream in <em>oggz</em>. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>OGGZ_ERR_BAD_OGGZ</em>&nbsp;</td><td><em>oggz</em> does not refer to an existing OGGZ </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
</div>
<hr class="footer"/><address style="text-align: right;"><small>Generated on Sat Apr 24 09:13:55 2010 for liboggz by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.3 </small></address>
</body>
</html>