6
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
<link rel="prev" href="gst-plugins-bad-plugins-mpegaudioparse.html" title="mpegaudioparse">
9
<link rel="prev" href="gst-plugins-bad-plugins-modplug.html" title="modplug">
10
10
<link rel="next" href="gst-plugins-bad-plugins-mplex.html" title="mplex">
11
<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.17 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
16
<tr valign="middle">
17
<td><a accesskey="p" href="gst-plugins-bad-plugins-mpegaudioparse.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
17
<td><a accesskey="p" href="gst-plugins-bad-plugins-modplug.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
18
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
20
<th width="100%" align="center">GStreamer Bad Plugins 0.10 Plugins Reference Manual</th>
110
110
and on the various available parameters in the documentation
111
111
of the mpeg2enc tool in particular, which shares options with this element.
113
<div class="refsect2" title="Example pipeline">
114
<a name="id631445"></a><h3>Example pipeline</h3>
115
<div class="refsect2">
116
<a name="idp15317376"></a><h3>Example pipeline</h3>
115
117
<div class="informalexample">
116
118
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
119
121
<td class="listing_lines" align="right"><pre>1</pre></td>
120
<td class="listing_code"><pre class="programlisting">gst<span class="symbol">-</span>launch<span class="symbol">-</span><span class="number">0.10</span> videotestsrc num<span class="symbol">-</span>buffers<span class="symbol">=</span><span class="number">1000</span> <span class="symbol">!</span> mpeg2enc <span class="symbol">!</span> filesink location<span class="symbol">=</span>videotestsrc<span class="symbol">.</span>m1v</pre></td>
122
<td class="listing_code"><pre class="programlisting">gst<span class="gtkdoc opt">-</span>launch<span class="gtkdoc opt">-</span><span class="number">0.10</span> videotestsrc num<span class="gtkdoc opt">-</span>buffers<span class="gtkdoc opt">=</span><span class="number">1000</span> <span class="gtkdoc opt">!</span> mpeg2enc <span class="gtkdoc opt">!</span> filesink location<span class="gtkdoc opt">=</span>videotestsrc<span class="gtkdoc opt">.</span>m1v</pre></td>
146
148
This will produce an MPEG1 profile stream according to VCD2.0 specifications
147
149
for PAL <a class="link" href="gst-plugins-bad-plugins-mpeg2enc.html#GstMpeg2enc--norm" title='The "norm" property'><span class="type">"norm"</span></a> (as the image height is dependent on video norm).
150
<div class="refsect1" title="Details">
153
<div class="refsynopsisdiv">
155
<div class="refsect2">
156
<a name="idp15323696"></a><h3>Element Information</h3>
157
<div class="variablelist"><table border="0">
158
<col align="left" valign="top">
161
<td><p><span class="term">plugin</span></p></td>
163
<a class="link" href="gst-plugins-bad-plugins-plugin-mpeg2enc.html#plugin-mpeg2enc">mpeg2enc</a>
167
<td><p><span class="term">author</span></p></td>
168
<td>Andrew Stevens <andrew.stevens@nexgo.de>
169
Ronald Bultje <rbultje@ronald.bitfreak.net></td>
172
<td><p><span class="term">class</span></p></td>
173
<td>Codec/Encoder/Video</td>
179
<div class="refsect2">
180
<a name="idp15331104"></a><h3>Element Pads</h3>
181
<div class="variablelist"><table border="0">
182
<col align="left" valign="top">
185
<td><p><span class="term">name</span></p></td>
189
<td><p><span class="term">direction</span></p></td>
193
<td><p><span class="term">presence</span></p></td>
197
<td><p><span class="term">details</span></p></td>
198
<td>video/x-raw-yuv, format=(fourcc){ I420 }, width=(int)[ 16, 4096 ], height=(int)[ 16, 4096 ], framerate=(fraction){ 24000/1001, 24/1, 25/1, 30000/1001, 30/1, 50/1, 60000/1001 }</td>
202
<div class="variablelist"><table border="0">
203
<col align="left" valign="top">
206
<td><p><span class="term">name</span></p></td>
210
<td><p><span class="term">direction</span></p></td>
214
<td><p><span class="term">presence</span></p></td>
218
<td><p><span class="term">details</span></p></td>
219
<td>video/mpeg, systemstream=(boolean)false, mpegversion=(int){ 1, 2 }, width=(int)[ 16, 4096 ], height=(int)[ 16, 4096 ], framerate=(fraction){ 24000/1001, 24/1, 25/1, 30000/1001, 30/1, 50/1, 60000/1001 }</td>
228
<div class="refsect1">
151
229
<a name="gst-plugins-bad-plugins-mpeg2enc.details"></a><h2>Details</h2>
152
<div class="refsect2" title="GstMpeg2enc">
230
<div class="refsect2">
153
231
<a name="GstMpeg2enc-struct"></a><h3>GstMpeg2enc</h3>
154
232
<pre class="programlisting">typedef struct _GstMpeg2enc GstMpeg2enc;</pre>
159
<div class="refsect1" title="Property Details">
237
<div class="refsect1">
160
238
<a name="gst-plugins-bad-plugins-mpeg2enc.property-details"></a><h2>Property Details</h2>
161
<div class="refsect2" title='The "altscan-mpeg2" property'>
239
<div class="refsect2">
162
240
<a name="GstMpeg2enc--altscan-mpeg2"></a><h3>The <code class="literal">"altscan-mpeg2"</code> property</h3>
163
241
<pre class="programlisting"> "altscan-mpeg2" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
164
242
<p>Alternate MPEG-2 block scanning. Disabling this might make buggy players play SVCD streams.</p>
165
243
<p>Default value: TRUE</p>
168
<div class="refsect2" title='The "aspect" property'>
246
<div class="refsect2">
169
247
<a name="GstMpeg2enc--aspect"></a><h3>The <code class="literal">"aspect"</code> property</h3>
170
248
<pre class="programlisting"> "aspect" <span class="type">GstMpeg2encAspect</span> : Read / Write</pre>
171
249
<p>Display aspect ratio.</p>
172
250
<p>Default value: Deduce from input</p>
175
<div class="refsect2" title='The "b-per-refframe" property'>
253
<div class="refsect2">
176
254
<a name="GstMpeg2enc--b-per-refframe"></a><h3>The <code class="literal">"b-per-refframe"</code> property</h3>
177
255
<pre class="programlisting"> "b-per-refframe" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write</pre>
178
256
<p>Number of B frames between each I/P frame.</p>
196
274
<p>Default value: 46</p>
199
<div class="refsect2" title='The "closed-gop" property'>
277
<div class="refsect2">
200
278
<a name="GstMpeg2enc--closed-gop"></a><h3>The <code class="literal">"closed-gop"</code> property</h3>
201
279
<pre class="programlisting"> "closed-gop" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
202
280
<p>All Group-of-Pictures are closed (for multi-angle DVDs).</p>
203
281
<p>Default value: FALSE</p>
206
<div class="refsect2" title='The "constraints" property'>
284
<div class="refsect2">
207
285
<a name="GstMpeg2enc--constraints"></a><h3>The <code class="literal">"constraints"</code> property</h3>
208
286
<pre class="programlisting"> "constraints" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
209
287
<p>Use strict video resolution and bitrate checks.</p>
210
288
<p>Default value: TRUE</p>
213
<div class="refsect2" title='The "correct-svcd-hds" property'>
291
<div class="refsect2">
214
292
<a name="GstMpeg2enc--correct-svcd-hds"></a><h3>The <code class="literal">"correct-svcd-hds"</code> property</h3>
215
293
<pre class="programlisting"> "correct-svcd-hds" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
216
294
<p>Force SVCD width to 480 instead of 540/720.</p>
217
295
<p>Default value: FALSE</p>
220
<div class="refsect2" title='The "dualprime" property'>
298
<div class="refsect2">
221
299
<a name="GstMpeg2enc--dualprime"></a><h3>The <code class="literal">"dualprime"</code> property</h3>
222
300
<pre class="programlisting"> "dualprime" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
223
301
<p>Dual Prime Motion Estimation Mode for MPEG-2 I/P-frame only streams. Quite some players do not support this.</p>
224
302
<p>Default value: FALSE</p>
227
<div class="refsect2" title='The "dummy-svcd-sof" property'>
305
<div class="refsect2">
228
306
<a name="GstMpeg2enc--dummy-svcd-sof"></a><h3>The <code class="literal">"dummy-svcd-sof"</code> property</h3>
229
307
<pre class="programlisting"> "dummy-svcd-sof" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
230
308
<p>Generate dummy SVCD scan-data (for vcdimager).</p>
231
309
<p>Default value: TRUE</p>
234
<div class="refsect2" title='The "force-b-b-p" property'>
312
<div class="refsect2">
235
313
<a name="GstMpeg2enc--force-b-b-p"></a><h3>The <code class="literal">"force-b-b-p"</code> property</h3>
236
314
<pre class="programlisting"> "force-b-b-p" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
237
315
<p>Force two B frames between I/P frames when closing GOP boundaries.</p>
238
316
<p>Default value: FALSE</p>
241
<div class="refsect2" title='The "format" property'>
319
<div class="refsect2">
242
320
<a name="GstMpeg2enc--format"></a><h3>The <code class="literal">"format"</code> property</h3>
243
321
<pre class="programlisting"> "format" <span class="type">GstMpeg2encFormat</span> : Read / Write</pre>
244
322
<p>Encoding profile format.</p>
245
323
<p>Default value: Generic MPEG-1</p>
248
<div class="refsect2" title='The "framerate" property'>
326
<div class="refsect2">
249
327
<a name="GstMpeg2enc--framerate"></a><h3>The <code class="literal">"framerate"</code> property</h3>
250
328
<pre class="programlisting"> "framerate" <span class="type">GstMpeg2encFramerate</span> : Read / Write</pre>
251
329
<p>Output framerate.</p>
252
330
<p>Default value: Same as input</p>
255
<div class="refsect2" title='The "interlace-mode" property'>
333
<div class="refsect2">
256
334
<a name="GstMpeg2enc--interlace-mode"></a><h3>The <code class="literal">"interlace-mode"</code> property</h3>
257
335
<pre class="programlisting"> "interlace-mode" <span class="type">GstMpeg2encInterlaceMode</span> : Read / Write</pre>
258
336
<p>MPEG-2 motion estimation and encoding modes.</p>
259
337
<p>Default value: Progressive</p>
262
<div class="refsect2" title='The "intra-dc-prec" property'>
340
<div class="refsect2">
263
341
<a name="GstMpeg2enc--intra-dc-prec"></a><h3>The <code class="literal">"intra-dc-prec"</code> property</h3>
264
342
<pre class="programlisting"> "intra-dc-prec" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write</pre>
265
343
<p>Number of bits precision for DC (base colour) in MPEG-2 blocks.</p>
267
345
<p>Default value: 9</p>
270
<div class="refsect2" title='The "keep-hf" property'>
348
<div class="refsect2">
271
349
<a name="GstMpeg2enc--keep-hf"></a><h3>The <code class="literal">"keep-hf"</code> property</h3>
272
350
<pre class="programlisting"> "keep-hf" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
273
351
<p>Maximize high-frequency resolution (for high-quality sources).</p>
274
352
<p>Default value: FALSE</p>
277
<div class="refsect2" title='The "max-gop-size" property'>
355
<div class="refsect2">
278
356
<a name="GstMpeg2enc--max-gop-size"></a><h3>The <code class="literal">"max-gop-size"</code> property</h3>
279
357
<pre class="programlisting"> "max-gop-size" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write</pre>
280
358
<p>Maximal size per Group-of-Pictures (-1=default).</p>
306
384
<p>Default value: 0</p>
309
<div class="refsect2" title='The "norm" property'>
387
<div class="refsect2">
310
388
<a name="GstMpeg2enc--norm"></a><h3>The <code class="literal">"norm"</code> property</h3>
311
389
<pre class="programlisting"> "norm" <span class="type">GstMpeg2encVideoNorm</span> : Read / Write</pre>
312
390
<p>Tag output for specific video norm.</p>
313
391
<p>Default value: Unspecified</p>
316
<div class="refsect2" title='The "playback-field-order" property'>
394
<div class="refsect2">
317
395
<a name="GstMpeg2enc--playback-field-order"></a><h3>The <code class="literal">"playback-field-order"</code> property</h3>
318
396
<pre class="programlisting"> "playback-field-order" <span class="type">GstMpeg2encPlaybackFieldOrders</span> : Read / Write</pre>
319
397
<p>Force specific playback field order.</p>
320
398
<p>Default value: Unspecified</p>
323
<div class="refsect2" title='The "pulldown-3-2" property'>
401
<div class="refsect2">
324
402
<a name="GstMpeg2enc--pulldown-3-2"></a><h3>The <code class="literal">"pulldown-3-2"</code> property</h3>
325
403
<pre class="programlisting"> "pulldown-3-2" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
326
404
<p>Generate header flags for 3-2 pull down 24fps movies.</p>
327
405
<p>Default value: FALSE</p>
330
<div class="refsect2" title='The "quant-matrix" property'>
408
<div class="refsect2">
331
409
<a name="GstMpeg2enc--quant-matrix"></a><h3>The <code class="literal">"quant-matrix"</code> property</h3>
332
410
<pre class="programlisting"> "quant-matrix" <span class="type">GstMpeg2encQuantisationMatrix</span> : Read / Write</pre>
333
411
<p>Quantisation matrix to use for encoding.</p>
334
412
<p>Default value: Default</p>
337
<div class="refsect2" title='The "quant-reduction-max-var" property'>
415
<div class="refsect2">
338
416
<a name="GstMpeg2enc--quant-reduction-max-var"></a><h3>The <code class="literal">"quant-reduction-max-var"</code> property</h3>
339
417
<pre class="programlisting"> "quant-reduction-max-var" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> : Read / Write</pre>
340
418
<p>Maximal luma variance below which quantisation boost is used.</p>
382
460
<p>Default value: 2</p>
385
<div class="refsect2" title='The "sequence-header-every-gop" property'>
463
<div class="refsect2">
386
464
<a name="GstMpeg2enc--sequence-header-every-gop"></a><h3>The <code class="literal">"sequence-header-every-gop"</code> property</h3>
387
465
<pre class="programlisting"> "sequence-header-every-gop" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
388
466
<p>Include a sequence header in every GOP.</p>
389
467
<p>Default value: FALSE</p>
392
<div class="refsect2" title='The "sequence-length" property'>
470
<div class="refsect2">
393
471
<a name="GstMpeg2enc--sequence-length"></a><h3>The <code class="literal">"sequence-length"</code> property</h3>
394
472
<pre class="programlisting"> "sequence-length" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write</pre>
395
473
<p>Place a sequence boundary after each <num> MB (0=disable).</p>