-
Notifications
You must be signed in to change notification settings - Fork 58
/
audio.xml
196 lines (188 loc) · 6.6 KB
/
audio.xml
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
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xml:id="wrappers.audio" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_wrapper">
<refnamediv>
<refname>ogg://</refname>
<refpurpose>オーディオストリーム</refpurpose>
</refnamediv>
<refsect1 role="description"><!-- {{{ -->
&reftitle.description;
<para>
<filename>ogg://</filename> ラッパー経由で読み込みモードでオープンされた
ファイルは、<literal>OGG/Vorbis</literal> コーデックでエンコードされた圧縮音声ファイルとして
扱われます。同様に、<filename>ogg://</filename> ラッパー経由で書き込みモード
あるいは追記モードでオープンされたファイルは、圧縮音声データとして
書き込まれます。読み込みモードでオープンした <literal>OGG/Vorbis</literal> ファイルに対して
<function>stream_get_meta_data</function> を適用した場合、以下のような
さまざまな情報を返します。
<parameter>vendor</parameter> タグ、<parameter>comments</parameter>、
多くの <parameter>channels</parameter>、サンプリングレート
<parameter>rate</parameter> 、
および以下のパラメータで指定されるエンコーディングレート。
<parameter>bitrate_lower</parameter>、<parameter>bitrate_upper</parameter>、
<parameter>bitrate_nominal</parameter>、<parameter>bitrate_window</parameter>
</para>
<simpara><filename>ogg://</filename> (PECL) </simpara>
<note>
<title>このラッパーはデフォルトでは有効になっていません</title>
<simpara>
<filename>ogg://</filename> ラッパーを使用するには、
&link.pecl; から
<link xlink:href="&url.pecl.package;oggvorbis">OGG/Vorbis</link> 拡張モジュールを
インストールする必要があります。
</simpara>
</note>
</refsect1><!-- }}} -->
<refsect1 role="usage"> <!-- {{{ -->
&reftitle.usage;
<itemizedlist>
<listitem><simpara><filename>ogg://soundfile.ogg</filename></simpara></listitem>
<listitem><simpara><filename>ogg:///path/to/soundfile.ogg</filename></simpara></listitem>
<listitem><simpara><filename>ogg://http://www.example.com/path/to/soundstream.ogg</filename></simpara></listitem>
</itemizedlist>
</refsect1> <!-- }}} -->
<refsect1 role="options"><!-- {{{ -->
&reftitle.options;
<para>
<table>
<title>ラッパーの概要</title>
<tgroup cols="2">
<thead>
<row>
<entry>属性</entry>
<entry>サポートの有無</entry>
</row>
</thead>
<tbody>
<row>
<entry><link linkend="ini.allow-url-fopen">allow_url_fopen</link> で制約される</entry>
<entry>No</entry>
</row>
<row>
<entry>読み込み許可</entry>
<entry>Yes</entry>
</row>
<row>
<entry>書き込み許可</entry>
<entry>Yes</entry>
</row>
<row>
<entry>追加許可</entry>
<entry>Yes</entry>
</row>
<row>
<entry>同時読み書き許可</entry>
<entry>No</entry>
</row>
<row>
<entry><function>stat</function> のサポート</entry>
<entry>No</entry>
</row>
<row>
<entry><function>unlink</function> のサポート</entry>
<entry>No</entry>
</row>
<row>
<entry><function>rename</function> のサポート</entry>
<entry>No</entry>
</row>
<row>
<entry><function>mkdir</function> のサポート</entry>
<entry>No</entry>
</row>
<row>
<entry><function>rmdir</function> のサポート</entry>
<entry>No</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<!-- FIXME: This should not be here! context.audio... -->
<para>
<table>
<title>コンテキストオプション</title>
<tgroup cols="3">
<thead>
<row>
<entry>名前</entry>
<entry>使用法</entry>
<entry>デフォルト</entry>
<entry>モード</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>pcm_mode</literal></entry>
<entry>
読み込みの際に適用する PCM エンコーディング。以下のうちのひとつ。
<constant>OGGVORBIS_PCM_U8</constant>、<constant>OGGVORBIS_PCM_S8</constant>、
<constant>OGGVORBIS_PCM_U16_BE</constant>、<constant>OGGVORBIS_PCM_S16_BE</constant>、
<constant>OGGVORBIS_PCM_U16_LE</constant>、および <constant>OGGVORBIS_PCM_S16_LE</constant>
(8 ビットか 16 ビットか、符号付きか符号なしか、ビッグエンディアンかリトルエンディアンか)。
</entry>
<entry>OGGVORBIS_PCM_S16_LE</entry>
<entry>Read</entry>
</row>
<row>
<entry><literal>rate</literal></entry>
<entry>
入力データのサンプリングレート。Hz 単位。
</entry>
<entry>44100</entry>
<entry>Write/Append</entry>
</row>
<row>
<entry><literal>bitrate</literal></entry>
<entry>
整数値の場合、エンコードの際の固定ビットレート(16000 から 131072)。
浮動小数点値の場合、使用する可変ビットレート(-1.0 から 1.0)。
</entry>
<entry>128000</entry>
<entry>Write/Append</entry>
</row>
<row>
<entry><literal>channels</literal></entry>
<entry>
エンコードする音声チャネル数。一般には 1(モノラル)あるいは 2(ステレオ)。
最大 16 まで。
</entry>
<entry>2</entry>
<entry>Write/Append</entry>
</row>
<row>
<entry><literal>comments</literal></entry>
<entry>
エンコード時にトラックヘッダに入れる文字列の配列。
</entry>
<entry/>
<entry>Write/Append</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</refsect1> <!-- }}} -->
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->