1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<link rel="stylesheet" href="style.css" type="text/css">
5
<meta content="text/html; charset=iso-8859-1" http-equiv="Content-Type">
6
<link rel="Start" href="index.html">
7
<link rel="Up" href="index.html">
8
<link title="Index of types" rel=Appendix href="index_types.html">
9
<link title="Index of exceptions" rel=Appendix href="index_exceptions.html">
10
<link title="Index of values" rel=Appendix href="index_values.html">
11
<link title="Index of modules" rel=Appendix href="index_modules.html">
12
<link title="Vorbis" rel="Chapter" href="Vorbis.html"><link title="Exceptions" rel="Section" href="#1_Exceptions">
13
<link title="Useful types" rel="Section" href="#1_Usefultypes">
14
<link title="Operations with vorbis files" rel="Section" href="#1_Operationswithvorbisfiles">
15
<link title="Encoding" rel="Subsection" href="#2_Encoding">
16
<link title="Decoding" rel="Subsection" href="#2_Decoding">
20
<div class="navbar"> <a href="index.html">Up</a>
22
<center><h1>Module <a href="type_Vorbis.html">Vorbis</a></h1></center>
24
<pre><span class="keyword">module</span> Vorbis: <code class="code">sig</code> <a href="Vorbis.html">..</a> <code class="code">end</code></pre> Decode from or encode to the Ogg Vorbis compressed audio format;
25
or get informations about an Ogg Vorbis file.
29
<b>Author(s):</b> Samuel Mimram, Julien Cristau, David Baelde<br>
32
<a name="1_Exceptions"></a>
33
<h1>Exceptions</h1><br>
34
<pre><span class="keyword">exception</span> <a name="EXCEPTIONInvalid_parameters"></a>Invalid_parameters</pre>
36
Some parameters are invalid for this function.<br>
38
<pre><span class="keyword">exception</span> <a name="EXCEPTIONInvalid_quality"></a>Invalid_quality</pre>
40
The given quality in invalid.<br>
42
<pre><span class="keyword">exception</span> <a name="EXCEPTIONInvalid_bitrate"></a>Invalid_bitrate</pre>
44
The given bitrate is invalid.<br>
46
<pre><span class="keyword">exception</span> <a name="EXCEPTIONInvalid_channels"></a>Invalid_channels</pre>
48
The given number of channels is invalid.<br>
50
<pre><span class="keyword">exception</span> <a name="EXCEPTIONInvalid_sample_freq"></a>Invalid_sample_freq</pre>
52
The given sampling frequency is invalid.<br>
54
<pre><span class="keyword">exception</span> <a name="EXCEPTIONInvalid_argument"></a>Invalid_argument</pre>
56
Invalid setup request, e.g. out of range argument.<br>
58
<pre><span class="keyword">exception</span> <a name="EXCEPTIONCould_not_open_file"></a>Could_not_open_file</pre>
60
The given file could not be opened.<br>
62
<pre><span class="keyword">exception</span> <a name="EXCEPTIONNot_vorbis"></a>Not_vorbis</pre>
64
Bitstream is not Vorbis data.<br>
66
<pre><span class="keyword">exception</span> <a name="EXCEPTIONBad_header"></a>Bad_header</pre>
68
Invalid Vorbis bitstream header.<br>
70
<pre><span class="keyword">exception</span> <a name="EXCEPTIONRead_error"></a>Read_error</pre>
72
A read from media returned an error.<br>
74
<pre><span class="keyword">exception</span> <a name="EXCEPTIONInternal_fault"></a>Internal_fault</pre>
76
Internal logic fault; indicates a bug or heap/stack corruption.<br>
78
<pre><span class="keyword">exception</span> <a name="EXCEPTIONHole_in_data"></a>Hole_in_data</pre>
80
Indicates there was an interruption in the data (one of: garbage between
81
pages, loss of sync followed by recapture, or a corrupt page).<br>
83
<pre><span class="keyword">exception</span> <a name="EXCEPTIONBad_link"></a>Bad_link</pre>
85
Indicates that an invalid stream section was supplied,
86
or the requested link is corrupt.<br>
88
<pre><span class="keyword">exception</span> <a name="EXCEPTIONVersion_mismatch"></a>Version_mismatch</pre>
90
Invalid Vorbis bitstream header.<br>
92
<pre><span class="keyword">exception</span> <a name="EXCEPTIONNot_implemented"></a>Not_implemented</pre>
94
Unimplemented mode.<br>
96
<pre><span class="keyword">exception</span> <a name="EXCEPTIONUnknown_error"></a>Unknown_error <span class="keyword">of</span> <code class="type">int</code></pre>
98
An unknown error happened (it should not have happened, please report).<br>
100
<pre><span class="keyword">exception</span> <a name="EXCEPTIONUtf8_failure"></a>Utf8_failure <span class="keyword">of</span> <code class="type">string</code></pre>
102
Error while converting utf8.<br>
105
<a name="1_Usefultypes"></a>
106
<h1>Useful types</h1><br>
107
<pre><span class="keyword">type</span> <a name="TYPEbitstream"></a><code class="type"></code>bitstream = <code class="type">int</code> </pre>
109
Index of a logical bitstream. The special value -1 means the physical
113
<br><code><span class="keyword">type</span> <a name="TYPEinfo"></a><code class="type"></code>info = {</code><table class="typetable">
115
<td align="left" valign="top" >
116
<code> </code></td>
117
<td align="left" valign="top" >
118
<code>vorbis_version : <code class="type">int</code>;</code></td>
119
<td class="typefieldcomment" align="left" valign="top" ><code>(*</code></td><td class="typefieldcomment" align="left" valign="top" >version of vorbis codec, must be 0</td><td class="typefieldcomment" align="left" valign="bottom" ><code>*)</code></td>
122
<td align="left" valign="top" >
123
<code> </code></td>
124
<td align="left" valign="top" >
125
<code>audio_channels : <code class="type">int</code>;</code></td>
126
<td class="typefieldcomment" align="left" valign="top" ><code>(*</code></td><td class="typefieldcomment" align="left" valign="top" >number of audio channels</td><td class="typefieldcomment" align="left" valign="bottom" ><code>*)</code></td>
129
<td align="left" valign="top" >
130
<code> </code></td>
131
<td align="left" valign="top" >
132
<code>audio_samplerate : <code class="type">int</code>;</code></td>
133
<td class="typefieldcomment" align="left" valign="top" ><code>(*</code></td><td class="typefieldcomment" align="left" valign="top" >samplerate in Hertz</td><td class="typefieldcomment" align="left" valign="bottom" ><code>*)</code></td>
136
<td align="left" valign="top" >
137
<code> </code></td>
138
<td align="left" valign="top" >
139
<code>bitrate_upper : <code class="type">int</code>;</code></td>
143
<td align="left" valign="top" >
144
<code> </code></td>
145
<td align="left" valign="top" >
146
<code>bitrate_nominal : <code class="type">int</code>;</code></td>
150
<td align="left" valign="top" >
151
<code> </code></td>
152
<td align="left" valign="top" >
153
<code>bitrate_lower : <code class="type">int</code>;</code></td>
157
<td align="left" valign="top" >
158
<code> </code></td>
159
<td align="left" valign="top" >
160
<code>bitrate_window : <code class="type">int</code>;</code></td>
166
Vorbis informations about a file.<br>
170
<a name="1_Operationswithvorbisfiles"></a>
171
<h1>Operations with vorbis files</h1><br>
173
<a name="2_Encoding"></a>
174
<h2>Encoding</h2><br>
175
<pre><span class="keyword">val</span> <a name="VALtags"></a>tags : <code class="type">?title:string -><br> ?artist:string -><br> ?genre:string -><br> ?date:string -><br> ?album:string -><br> ?tracknumber:string -> ?comment:string -> unit -> (string * string) list</code></pre><div class="info">
176
Create a list of vorbis tags.<br>
178
<pre><span class="keyword">module</span> <a href="Vorbis.Encoder.html">Encoder</a>: <code class="code">sig</code> <a href="Vorbis.Encoder.html">..</a> <code class="code">end</code></pre><br>
179
<a name="2_Decoding"></a>
180
<h2>Decoding</h2><br>
181
<pre><span class="keyword">module</span> <a href="Vorbis.Decoder.html">Decoder</a>: <code class="code">sig</code> <a href="Vorbis.Decoder.html">..</a> <code class="code">end</code></pre></body></html>
b'\\ No newline at end of file'