~ubuntu-branches/ubuntu/quantal/gst-plugins-bad-multiverse0.10/quantal

« back to all changes in this revision

Viewing changes to docs/plugins/html/gst-plugins-bad-plugins-faac.html

  • Committer: Bazaar Package Importer
  • Author(s): Onkar Shinde
  • Date: 2010-03-13 22:48:10 UTC
  • mfrom: (1.1.16 upstream)
  • Revision ID: james.westby@ubuntu.com-20100313224810-8l25xl017imj7z4l
Tags: 0.10.18-0ubuntu1
* New upstream bugfix release.
* Relevant upstream fixes
  - 598350 : qtmux with AAC streams (from faac) generate invalid files
  - 607105 : faac doesn't negotiate channel positions correctly
  - 606726 : FAAC bitrate setting has no effect

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>faac</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
7
<link rel="home" href="index.html" title="GStreamer Bad Plugins 0.10 Plugins Reference Manual">
8
8
<link rel="up" href="ch01.html" title="gst-plugins-bad Elements">
9
9
<link rel="prev" href="gst-plugins-bad-plugins-dvdspu.html" title="dvdspu">
10
 
<link rel="next" href="gst-plugins-bad-plugins-festival.html" title="festival">
11
 
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
 
10
<link rel="next" href="gst-plugins-bad-plugins-faad.html" title="faad">
 
11
<meta name="generator" content="GTK-Doc V1.13 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="ch01.html" title="gst-plugins-bad Elements">
14
14
<link rel="chapter" href="ch02.html" title="gst-plugins-bad Plugins">
21
21
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
22
22
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
23
23
<th width="100%" align="center">GStreamer Bad Plugins 0.10 Plugins Reference Manual</th>
24
 
<td><a accesskey="n" href="gst-plugins-bad-plugins-festival.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
24
<td><a accesskey="n" href="gst-plugins-bad-plugins-faad.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
25
25
</tr>
26
26
<tr><td colspan="5" class="shortcuts">
27
27
<a href="#gst-plugins-bad-plugins-faac.synopsis" class="shortcut">Top</a>
28
 
                 | 
29
 
                <a href="#gst-plugins-bad-plugins-faac.description" class="shortcut">Description</a>
30
 
                 | 
31
 
                <a href="#gst-plugins-bad-plugins-faac.object-hierarchy" class="shortcut">Object Hierarchy</a>
32
 
                 | 
33
 
                <a href="#gst-plugins-bad-plugins-faac.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
34
 
                 | 
35
 
                <a href="#gst-plugins-bad-plugins-faac.properties" class="shortcut">Properties</a>
 
28
                   | 
 
29
                  <a href="#gst-plugins-bad-plugins-faac.description" class="shortcut">Description</a>
 
30
                   | 
 
31
                  <a href="#gst-plugins-bad-plugins-faac.object-hierarchy" class="shortcut">Object Hierarchy</a>
 
32
                   | 
 
33
                  <a href="#gst-plugins-bad-plugins-faac.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
 
34
                   | 
 
35
                  <a href="#gst-plugins-bad-plugins-faac.properties" class="shortcut">Properties</a>
36
36
</td></tr>
37
37
</table>
38
38
<div class="refentry" title="faac">
46
46
</tr></table></div>
47
47
<div class="refsynopsisdiv" title="Synopsis">
48
48
<a name="gst-plugins-bad-plugins-faac.synopsis"></a><h2>Synopsis</h2>
49
 
<a name="GstFaac"></a><pre class="synopsis">
50
 
                    <a class="link" href="gst-plugins-bad-plugins-faac.html#GstFaac-struct" title="GstFaac">GstFaac</a>;
 
49
<a name="GstFaac"></a><pre class="synopsis">                    <a class="link" href="gst-plugins-bad-plugins-faac.html#GstFaac-struct" title="GstFaac">GstFaac</a>;
51
50
</pre>
52
51
</div>
53
52
<div class="refsect1" title="Object Hierarchy">
54
53
<a name="gst-plugins-bad-plugins-faac.object-hierarchy"></a><h2>Object Hierarchy</h2>
55
54
<pre class="synopsis">
56
 
  <a
57
 
href="../gobject/gobject-The-Base-Object-Type.html#GObject"
58
 
>GObject</a>
59
 
   +----<a
60
 
href="../gstreamer-0.10/GstObject.html"
61
 
>GstObject</a>
62
 
         +----<a
63
 
href="../gstreamer-0.10/GstElement.html"
64
 
>GstElement</a>
 
55
  <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
56
   +----<a href="/usr/share/gtk-doc/html/gstreamer-0.10/GstObject.html">GstObject</a>
 
57
         +----<a href="/usr/share/gtk-doc/html/gstreamer-0.10/GstElement.html">GstElement</a>
65
58
               +----GstFaac
66
59
</pre>
67
60
</div>
69
62
<a name="gst-plugins-bad-plugins-faac.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
70
63
<p>
71
64
GstFaac implements
72
 
 <a
73
 
href="../gstreamer-0.10/GstPreset.html"
74
 
>GstPreset</a>.</p>
 
65
 <a href="/usr/share/gtk-doc/html/gstreamer-0.10/GstPreset.html">GstPreset</a>.</p>
75
66
</div>
76
67
<div class="refsect1" title="Properties">
77
68
<a name="gst-plugins-bad-plugins-faac.properties"></a><h2>Properties</h2>
78
69
<pre class="synopsis">
79
 
  "<a class="link" href="gst-plugins-bad-plugins-faac.html#GstFaac--bitrate" title='The "bitrate" property'>bitrate</a>"                  <a
80
 
href="../glib/glib-Basic-Types.html#gint"
81
 
>gint</a>                  : Read / Write
82
 
  "<a class="link" href="gst-plugins-bad-plugins-faac.html#GstFaac--midside" title='The "midside" property'>midside</a>"                  <a
83
 
href="../glib/glib-Basic-Types.html#gboolean"
84
 
>gboolean</a>              : Read / Write
85
 
  "<a class="link" href="gst-plugins-bad-plugins-faac.html#GstFaac--outputformat" title='The "outputformat" property'>outputformat</a>"             GstFaacOutputFormat   : Read / Write
86
 
  "<a class="link" href="gst-plugins-bad-plugins-faac.html#GstFaac--profile" title='The "profile" property'>profile</a>"                  GstFaacProfile        : Read / Write
87
 
  "<a class="link" href="gst-plugins-bad-plugins-faac.html#GstFaac--shortctl" title='The "shortctl" property'>shortctl</a>"                 GstFaacShortCtl       : Read / Write
88
 
  "<a class="link" href="gst-plugins-bad-plugins-faac.html#GstFaac--tns" title='The "tns" property'>tns</a>"                      <a
89
 
href="../glib/glib-Basic-Types.html#gboolean"
90
 
>gboolean</a>              : Read / Write
 
70
  "<a class="link" href="gst-plugins-bad-plugins-faac.html#GstFaac--bitrate" title='The "bitrate" property'>bitrate</a>"                  <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
 
71
  "<a class="link" href="gst-plugins-bad-plugins-faac.html#GstFaac--midside" title='The "midside" property'>midside</a>"                  <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
72
  "<a class="link" href="gst-plugins-bad-plugins-faac.html#GstFaac--outputformat" title='The "outputformat" property'>outputformat</a>"             <span class="type">GstFaacOutputFormat</span>   : Read / Write
 
73
  "<a class="link" href="gst-plugins-bad-plugins-faac.html#GstFaac--profile" title='The "profile" property'>profile</a>"                  <span class="type">GstFaacProfile</span>        : Read / Write
 
74
  "<a class="link" href="gst-plugins-bad-plugins-faac.html#GstFaac--shortctl" title='The "shortctl" property'>shortctl</a>"                 <span class="type">GstFaacShortCtl</span>       : Read / Write
 
75
  "<a class="link" href="gst-plugins-bad-plugins-faac.html#GstFaac--tns" title='The "tns" property'>tns</a>"                      <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
91
76
</pre>
92
77
</div>
93
78
<div class="refsect1" title="Description">
94
79
<a name="gst-plugins-bad-plugins-faac.description"></a><h2>Description</h2>
95
80
<p>
96
 
faac encodes raw audio to AAC (MPEG-4 part 10) streams.
 
81
faac encodes raw audio to AAC (MPEG-4 part 3) streams.
97
82
</p>
98
83
<p>
99
84
The <a class="link" href="gst-plugins-bad-plugins-faac.html#GstFaac--outputformat" title='The "outputformat" property'><span class="type">"outputformat"</span></a> property determines whether or not the
110
95
<p>
111
96
</p>
112
97
<div class="refsect2" title="Example launch line">
113
 
<a name="id2866096"></a><h3>Example launch line</h3>
114
 
<pre class="programlisting">
115
 
gst-launch audiotestsrc wave=sine num-buffers=100 ! audioconvert ! faac ! matroskamux ! filesink location=sine.mkv
116
 
</pre>
117
 
</div>
118
 
<div class="refsynopsisdiv" title="Synopsis">
119
 
<h2>Synopsis</h2>
120
 
<div class="refsect2" title="Element Information">
121
 
<a name="id2866118"></a><h3>Element Information</h3>
122
 
<div class="variablelist"><table border="0">
123
 
<col align="left" valign="top">
124
 
<tbody>
125
 
<tr>
126
 
<td><p><span class="term">plugin</span></p></td>
127
 
<td>
128
 
            <a class="link" href="gst-plugins-bad-plugins-plugin-faac.html#plugin-faac">faac</a>
129
 
          </td>
130
 
</tr>
131
 
<tr>
132
 
<td><p><span class="term">author</span></p></td>
133
 
<td>Ronald Bultje &lt;rbultje@ronald.bitfreak.net&gt;</td>
134
 
</tr>
135
 
<tr>
136
 
<td><p><span class="term">class</span></p></td>
137
 
<td>Codec/Encoder/Audio</td>
138
 
</tr>
139
 
</tbody>
140
 
</table></div>
141
 
</div>
142
 
<hr>
143
 
<div class="refsect2" title="Element Pads">
144
 
<a name="id2866180"></a><h3>Element Pads</h3>
145
 
<div class="variablelist"><table border="0">
146
 
<col align="left" valign="top">
147
 
<tbody>
148
 
<tr>
149
 
<td><p><span class="term">name</span></p></td>
150
 
<td>sink</td>
151
 
</tr>
152
 
<tr>
153
 
<td><p><span class="term">direction</span></p></td>
154
 
<td>sink</td>
155
 
</tr>
156
 
<tr>
157
 
<td><p><span class="term">presence</span></p></td>
158
 
<td>always</td>
159
 
</tr>
160
 
<tr>
161
 
<td><p><span class="term">details</span></p></td>
162
 
<td>audio/x-raw-int, endianness=(int)1234, signed=(boolean)true, width=(int)16, depth=(int)16, rate=(int)[ 8000, 96000 ], channels=(int)[ 1, 6 ]</td>
163
 
</tr>
164
 
</tbody>
165
 
</table></div>
166
 
<div class="variablelist"><table border="0">
167
 
<col align="left" valign="top">
168
 
<tbody>
169
 
<tr>
170
 
<td><p><span class="term">name</span></p></td>
171
 
<td>src</td>
172
 
</tr>
173
 
<tr>
174
 
<td><p><span class="term">direction</span></p></td>
175
 
<td>source</td>
176
 
</tr>
177
 
<tr>
178
 
<td><p><span class="term">presence</span></p></td>
179
 
<td>always</td>
180
 
</tr>
181
 
<tr>
182
 
<td><p><span class="term">details</span></p></td>
183
 
<td>audio/mpeg, mpegversion=(int){ 4, 2 }, channels=(int)[ 1, 6 ], rate=(int)[ 8000, 96000 ]</td>
184
 
</tr>
185
 
</tbody>
186
 
</table></div>
187
 
</div>
188
 
</div>
189
 
<p>
190
 
</p>
 
98
<a name="id344316"></a><h3>Example launch line</h3>
 
99
<div class="informalexample">
 
100
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 
101
    <tbody>
 
102
      <tr>
 
103
        <td class="listing_lines" align="right"><pre>1</pre></td>
 
104
        <td class="listing_code"><pre class="programlisting">gst<span class="symbol">-</span>launch audiotestsrc wave<span class="symbol">=</span>sine num<span class="symbol">-</span>buffers<span class="symbol">=</span><span class="number">100</span> <span class="symbol">!</span> audioconvert <span class="symbol">!</span> faac <span class="symbol">!</span> matroskamux <span class="symbol">!</span> filesink location<span class="symbol">=</span>sine<span class="symbol">.</span>mkv</pre></td>
 
105
      </tr>
 
106
    </tbody>
 
107
  </table>
 
108
</div>
 
109
 Encode a sine beep as aac and write to matroska container.
 
110
</div>
191
111
</div>
192
112
<div class="refsect1" title="Details">
193
113
<a name="gst-plugins-bad-plugins-faac.details"></a><h2>Details</h2>
202
122
<a name="gst-plugins-bad-plugins-faac.property-details"></a><h2>Property Details</h2>
203
123
<div class="refsect2" title='The "bitrate" property'>
204
124
<a name="GstFaac--bitrate"></a><h3>The <code class="literal">"bitrate"</code> property</h3>
205
 
<pre class="programlisting">  "bitrate"                  <a
206
 
href="../glib/glib-Basic-Types.html#gint"
207
 
>gint</a>                  : Read / Write</pre>
 
125
<pre class="programlisting">  "bitrate"                  <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
208
126
<p>Bitrate in bits/sec.</p>
209
127
<p>Allowed values: [8000,320000]</p>
210
128
<p>Default value: 128000</p>
212
130
<hr>
213
131
<div class="refsect2" title='The "midside" property'>
214
132
<a name="GstFaac--midside"></a><h3>The <code class="literal">"midside"</code> property</h3>
215
 
<pre class="programlisting">  "midside"                  <a
216
 
href="../glib/glib-Basic-Types.html#gboolean"
217
 
>gboolean</a>              : Read / Write</pre>
 
133
<pre class="programlisting">  "midside"                  <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
218
134
<p>Allow mid/side encoding.</p>
219
135
<p>Default value: TRUE</p>
220
136
</div>
221
137
<hr>
222
138
<div class="refsect2" title='The "outputformat" property'>
223
139
<a name="GstFaac--outputformat"></a><h3>The <code class="literal">"outputformat"</code> property</h3>
224
 
<pre class="programlisting">  "outputformat"             GstFaacOutputFormat   : Read / Write</pre>
 
140
<pre class="programlisting">  "outputformat"             <span class="type">GstFaacOutputFormat</span>   : Read / Write</pre>
225
141
<p>Format of output frames.</p>
226
142
<p>Default value: OUTPUTFORMAT_RAW</p>
227
143
</div>
228
144
<hr>
229
145
<div class="refsect2" title='The "profile" property'>
230
146
<a name="GstFaac--profile"></a><h3>The <code class="literal">"profile"</code> property</h3>
231
 
<pre class="programlisting">  "profile"                  GstFaacProfile        : Read / Write</pre>
 
147
<pre class="programlisting">  "profile"                  <span class="type">GstFaacProfile</span>        : Read / Write</pre>
232
148
<p>MPEG/AAC encoding profile.</p>
233
149
<p>Default value: LC</p>
234
150
</div>
235
151
<hr>
236
152
<div class="refsect2" title='The "shortctl" property'>
237
153
<a name="GstFaac--shortctl"></a><h3>The <code class="literal">"shortctl"</code> property</h3>
238
 
<pre class="programlisting">  "shortctl"                 GstFaacShortCtl       : Read / Write</pre>
 
154
<pre class="programlisting">  "shortctl"                 <span class="type">GstFaacShortCtl</span>       : Read / Write</pre>
239
155
<p>Block type encorcing.</p>
240
156
<p>Default value: SHORTCTL_NORMAL</p>
241
157
</div>
242
158
<hr>
243
159
<div class="refsect2" title='The "tns" property'>
244
160
<a name="GstFaac--tns"></a><h3>The <code class="literal">"tns"</code> property</h3>
245
 
<pre class="programlisting">  "tns"                      <a
246
 
href="../glib/glib-Basic-Types.html#gboolean"
247
 
>gboolean</a>              : Read / Write</pre>
 
161
<pre class="programlisting">  "tns"                      <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
248
162
<p>Use temporal noise shaping.</p>
249
163
<p>Default value: FALSE</p>
250
164
</div>
251
165
</div>
 
166
<div class="refsect1" title="See Also">
 
167
<a name="gst-plugins-bad-plugins-faac.see-also"></a><h2>See Also</h2>
 
168
faad
 
169
</div>
252
170
</div>
253
171
<div class="footer">
254
172
<hr>
255
 
          Generated by GTK-Doc V1.11</div>
 
173
          Generated by GTK-Doc V1.13</div>
256
174
</body>
257
 
</html>
 
175
</html>
 
 
b'\\ No newline at end of file'