Originally committed as revision 2142 to svn://svn.ffmpeg.org/ffmpeg/trunk
Fabrice Bellard authored on 2003/08/25 00:22:26... | ... |
@@ -153,12 +153,16 @@ specified for the inputs. |
153 | 153 |
@table @option |
154 | 154 |
@item -L |
155 | 155 |
show license |
156 |
+ |
|
156 | 157 |
@item -h |
157 | 158 |
show help |
159 |
+ |
|
158 | 160 |
@item -formats |
159 | 161 |
show available formats, codecs, protocols, ... |
162 |
+ |
|
160 | 163 |
@item -f fmt |
161 | 164 |
force format |
165 |
+ |
|
162 | 166 |
@item -i filename |
163 | 167 |
input file name |
164 | 168 |
|
... | ... |
@@ -181,22 +185,55 @@ set the copyright |
181 | 181 |
@item -comment string |
182 | 182 |
set the comment |
183 | 183 |
|
184 |
+@item -hq |
|
185 |
+activate high quality settings |
|
186 |
+ |
|
184 | 187 |
@end table |
185 | 188 |
|
186 | 189 |
@section Video Options |
187 | 190 |
|
188 | 191 |
@table @option |
189 |
-@item -s size |
|
190 |
-set frame size [160x128] |
|
191 |
-@item -r fps |
|
192 |
-set frame rate [25] |
|
193 | 192 |
@item -b bitrate |
194 |
-set the video bitrate in kbit/s [200] |
|
193 |
+set the video bitrate in kbit/s (default = 200 kb/s) |
|
194 |
+@item -r fps |
|
195 |
+set frame rate (default = 25) |
|
196 |
+@item -s size |
|
197 |
+set frame size. The format is @samp{WxH}. (default 160x128) |
|
198 |
+The following abbreviations are regognized: |
|
199 |
+@table @sampe |
|
200 |
+@item sqcif |
|
201 |
+128x96 |
|
202 |
+@item qcif |
|
203 |
+176x144 |
|
204 |
+@item cif |
|
205 |
+352x288 |
|
206 |
+@item 4cif |
|
207 |
+704x576 |
|
208 |
+@end table |
|
209 |
+ |
|
210 |
+@item -aspect aspect |
|
211 |
+set aspect ratio (4:3, 16:9 or 1.3333, 1.7777) |
|
212 |
+@item -croptop size |
|
213 |
+set top crop band size (in pixels) |
|
214 |
+@item -cropbottom size |
|
215 |
+set bottom crop band size (in pixels) |
|
216 |
+@item -cropleft size |
|
217 |
+set left crop band size (in pixels) |
|
218 |
+@item -cropright size |
|
219 |
+set right crop band size (in pixels) |
|
195 | 220 |
@item -vn |
196 |
-disable video recording [no] |
|
221 |
+disable video recording |
|
197 | 222 |
@item -bt tolerance |
198 | 223 |
set video bitrate tolerance (in kbit/s) |
199 |
-@item -sameq |
|
224 |
+@item -maxrate bitrate |
|
225 |
+set max video bitrate tolerance (in kbit/s) |
|
226 |
+@item -minrate bitrate |
|
227 |
+set min video bitrate tolerance (in kbit/s) |
|
228 |
+@item -bufsize size |
|
229 |
+set ratecontrol buffere size (in kbit) |
|
230 |
+@item -vcodec codec |
|
231 |
+force video codec |
|
232 |
+@item -sameq |
|
200 | 233 |
use same video quality as source (implies VBR) |
201 | 234 |
|
202 | 235 |
@item -pass n |
... | ... |
@@ -207,26 +244,9 @@ select two pass log file name |
207 | 207 |
|
208 | 208 |
@end table |
209 | 209 |
|
210 |
-@section Audio Options |
|
211 |
- |
|
212 |
-@table @option |
|
213 |
-@item -ab bitrate |
|
214 |
-set audio bitrate (in kbit/s) |
|
215 |
-@item -ar freq |
|
216 |
- set the audio sampling freq [44100] |
|
217 |
-@item -ab bitrate |
|
218 |
- set the audio bitrate in kbit/s [64] |
|
219 |
-@item -ac channels |
|
220 |
- set the number of audio channels [1] |
|
221 |
-@item -an |
|
222 |
- disable audio recording [no] |
|
223 |
-@end table |
|
224 |
- |
|
225 |
-@section Advanced options |
|
210 |
+@section Advanced Video Options |
|
226 | 211 |
|
227 | 212 |
@table @option |
228 |
-@item -map file:stream |
|
229 |
-set input stream mapping |
|
230 | 213 |
@item -g gop_size |
231 | 214 |
set the group of picture size |
232 | 215 |
@item -intra |
... | ... |
@@ -243,33 +263,245 @@ max difference between the quantiser scale (VBR) |
243 | 243 |
video quantiser scale blur (VBR) |
244 | 244 |
@item -qcomp compression |
245 | 245 |
video quantiser scale compression (VBR) |
246 |
-@item -vd device |
|
247 |
-set video device |
|
248 |
-@item -vcodec codec |
|
249 |
-force video codec |
|
250 |
-@item -me method |
|
251 |
-set motion estimation method |
|
252 |
-@item -bf frames |
|
246 |
+ |
|
247 |
+@item -rc_init_cplx complexity |
|
248 |
+initial complexity for 1-pass encoding |
|
249 |
+@item -b_qfactor factor |
|
250 |
+qp factor between p and b frames |
|
251 |
+@item -i_qfactor factor |
|
252 |
+qp factor between p and i frames |
|
253 |
+@item -b_qoffset offset |
|
254 |
+qp offset between p and b frames |
|
255 |
+@item -i_qoffset offset |
|
256 |
+qp offset between p and i frames |
|
257 |
+@item -rc_eq equation |
|
258 |
+set rate control equation (@pxref{FFmpeg formula evaluator}) |
|
259 |
+@item -rc_override override_string |
|
260 |
+rate control override for specific internals |
|
261 |
+@item -me method |
|
262 |
+set motion estimation method. Available methods are (from lower to best quality): |
|
263 |
+@table @samp |
|
264 |
+@item zero |
|
265 |
+Try just (0, 0) vector. |
|
266 |
+@item phods |
|
267 |
+@item log |
|
268 |
+@item x1 |
|
269 |
+@item epzs |
|
270 |
+(default method) |
|
271 |
+@item full |
|
272 |
+exhaustive search (slow and marginally better than epzs) |
|
273 |
+@end table |
|
274 |
+ |
|
275 |
+@item -dct_algo algo |
|
276 |
+set dct algo |
|
277 |
+@table @samp |
|
278 |
+@item 0 |
|
279 |
+FF_DCT_AUTO (default) |
|
280 |
+@item 1 |
|
281 |
+FF_DCT_FASTINT |
|
282 |
+@item 2 |
|
283 |
+FF_DCT_INT |
|
284 |
+@item 3 |
|
285 |
+FF_DCT_MMX |
|
286 |
+@item 4 |
|
287 |
+FF_DCT_MLIB |
|
288 |
+@item 5 |
|
289 |
+FF_DCT_ALTIVEC |
|
290 |
+@end table |
|
291 |
+ |
|
292 |
+@item -idct_algo algo |
|
293 |
+set idct algo |
|
294 |
+@table @samp |
|
295 |
+@item 0 |
|
296 |
+FF_IDCT_AUTO (default) |
|
297 |
+@item 1 |
|
298 |
+FF_IDCT_INT |
|
299 |
+@item 2 |
|
300 |
+FF_IDCT_SIMPLE |
|
301 |
+@item 3 |
|
302 |
+FF_IDCT_SIMPLEMMX |
|
303 |
+@item 4 |
|
304 |
+FF_IDCT_LIBMPEG2MMX |
|
305 |
+@item 5 |
|
306 |
+FF_IDCT_PS2 |
|
307 |
+@item 6 |
|
308 |
+FF_IDCT_MLIB |
|
309 |
+@item 7 |
|
310 |
+FF_IDCT_ARM |
|
311 |
+@item 8 |
|
312 |
+FF_IDCT_ALTIVEC |
|
313 |
+@item 9 |
|
314 |
+FF_IDCT_SH4 |
|
315 |
+@item 10 |
|
316 |
+FF_IDCT_SIMPLEARM |
|
317 |
+@end table |
|
318 |
+ |
|
319 |
+@item -er n |
|
320 |
+set error resilience to 'n' |
|
321 |
+@table @samp |
|
322 |
+@item 1 |
|
323 |
+FF_ER_CAREFULL |
|
324 |
+@item 2 |
|
325 |
+FF_ER_COMPLIANT (default) |
|
326 |
+@item 3 |
|
327 |
+FF_ER_AGGRESSIVE |
|
328 |
+@item 4 |
|
329 |
+FF_ER_VERY_AGGRESSIVE |
|
330 |
+@end table |
|
331 |
+ |
|
332 |
+@item -ec n |
|
333 |
+set error concealment to n |
|
334 |
+@table @samp |
|
335 |
+@item 1 |
|
336 |
+FF_EC_GUESS_MVS |
|
337 |
+@item 2 |
|
338 |
+FF_EC_DEBLOCK |
|
339 |
+@end table |
|
340 |
+ |
|
341 |
+@item -bf frames |
|
253 | 342 |
use 'frames' B frames (only MPEG-4) |
254 |
-@item -hq |
|
255 |
-activate high quality settings |
|
256 |
-@item -4mv |
|
343 |
+@item -mbd mode |
|
344 |
+macroblock decision |
|
345 |
+@table @samp |
|
346 |
+@item 0 |
|
347 |
+FF_MB_DECISION_SIMPLE: use mb_cmp (cannot change it yet in ffmpeg) |
|
348 |
+@item 1 |
|
349 |
+FF_MB_DECISION_BITS: chooses the one which needs the fewest bits |
|
350 |
+@item 2 |
|
351 |
+FF_MB_DECISION_RD: rate distoration |
|
352 |
+@end table |
|
353 |
+ |
|
354 |
+@item -4mv |
|
257 | 355 |
use four motion vector by macroblock (only MPEG-4) |
258 |
-@item -ad device |
|
259 |
-set audio device |
|
356 |
+@item -part |
|
357 |
+use data partitioning (only MPEG-4) |
|
358 |
+@item -bug param |
|
359 |
+workaround not auto detected encoder bugs |
|
360 |
+@item -strict strictness |
|
361 |
+how strictly to follow the standarts |
|
362 |
+ |
|
363 |
+@item -deinterlace |
|
364 |
+deinterlace pictures |
|
365 |
+@item -psnr |
|
366 |
+calculate PSNR of compressed frames |
|
367 |
+@item -vstats |
|
368 |
+dump video coding statistics to file |
|
369 |
+@item -vhook module |
|
370 |
+insert video processing @var{module}. @var{module} contains the module |
|
371 |
+name and its parameters separated by spaces. |
|
372 |
+@item -aic |
|
373 |
+enable Advanced intra coding (h263+) |
|
374 |
+@item -umv |
|
375 |
+enable Unlimited Motion Vector (h263+) |
|
376 |
+@end table |
|
377 |
+ |
|
378 |
+@section Audio Options |
|
379 |
+ |
|
380 |
+@table @option |
|
381 |
+@item -ab bitrate |
|
382 |
+set audio bitrate (in kbit/s) |
|
383 |
+@item -ar freq |
|
384 |
+ set the audio sampling freq (default = 44100 Hz) |
|
385 |
+@item -ab bitrate |
|
386 |
+ set the audio bitrate in kbit/s (default = 64) |
|
387 |
+@item -ac channels |
|
388 |
+ set the number of audio channels (default = 1) |
|
389 |
+@item -an |
|
390 |
+ disable audio recording |
|
260 | 391 |
@item -acodec codec |
261 | 392 |
force audio codec |
262 |
-@item -deinterlace |
|
263 |
-deinterlace pictures |
|
393 |
+@end table |
|
394 |
+ |
|
395 |
+@section Audio/Video grab options |
|
396 |
+ |
|
397 |
+@table @option |
|
398 |
+@item -vd device |
|
399 |
+set video grab device (e.g. @file{/dev/video0}) |
|
400 |
+@item -vc channel |
|
401 |
+set video grab channel (DV1394 only) |
|
402 |
+@item -tvstd standard |
|
403 |
+set television standard (NTSC, PAL (SECAM)) |
|
404 |
+@item -dv1394 |
|
405 |
+set DV1394 grab |
|
406 |
+@item -ad device |
|
407 |
+set audio device (e.g. @file{/dev/dsp}) |
|
408 |
+@end table |
|
409 |
+ |
|
410 |
+@section Advanced options |
|
411 |
+ |
|
412 |
+@table @option |
|
413 |
+@item -map file:stream |
|
414 |
+set input stream mapping |
|
415 |
+@item -debug |
|
416 |
+print specific debug info |
|
264 | 417 |
@item -benchmark |
265 | 418 |
add timings for benchmarking |
266 | 419 |
@item -hex |
267 | 420 |
dump each input packet |
268 |
-@item -psnr |
|
269 |
-calculate PSNR of compressed frames |
|
270 |
-@item -vstats |
|
271 |
-dump video coding statistics to file |
|
421 |
+@item -bitexact |
|
422 |
+only use bit exact algorithms (for codec testing) |
|
423 |
+@item -ps size |
|
424 |
+set packet size in bits |
|
272 | 425 |
@end table |
426 |
+ |
|
427 |
+@node FFmpeg formula evaluator |
|
428 |
+@section FFmpeg formula evaluator |
|
429 |
+ |
|
430 |
+When evaluating a rate control string, FFmpeg uses an internal formula |
|
431 |
+evaluator. |
|
432 |
+ |
|
433 |
+The following binary operators are available: @code{+}, @code{-}, |
|
434 |
+@code{*}, @code{/}, @code{^}. |
|
435 |
+ |
|
436 |
+The following unary operators are available: @code{+}, @code{-}, |
|
437 |
+@code{(...)}. |
|
438 |
+ |
|
439 |
+The following functions are available: |
|
440 |
+@table @var |
|
441 |
+@item sinh(x) |
|
442 |
+@item cosh(x) |
|
443 |
+@item tanh(x) |
|
444 |
+@item sin(x) |
|
445 |
+@item cos(x) |
|
446 |
+@item tan(x) |
|
447 |
+@item exp(x) |
|
448 |
+@item log(x) |
|
449 |
+@item squish(x) |
|
450 |
+@item gauss(x) |
|
451 |
+@item abs(x) |
|
452 |
+@item max(x, y) |
|
453 |
+@item min(x, y) |
|
454 |
+@item gt(x, y) |
|
455 |
+@item lt(x, y) |
|
456 |
+@item eq(x, y) |
|
457 |
+@item bits2qp(bits) |
|
458 |
+@item qp2bits(qp) |
|
459 |
+@end table |
|
460 |
+ |
|
461 |
+The following constants are available: |
|
462 |
+@table @var |
|
463 |
+@item PI |
|
464 |
+@item E |
|
465 |
+@item iTex |
|
466 |
+@item pTex |
|
467 |
+@item tex |
|
468 |
+@item mv |
|
469 |
+@item fCode |
|
470 |
+@item iCount |
|
471 |
+@item mcVar |
|
472 |
+@item var |
|
473 |
+@item isI |
|
474 |
+@item isP |
|
475 |
+@item isB |
|
476 |
+@item avgQP |
|
477 |
+@item qComp |
|
478 |
+@item avgIITex |
|
479 |
+@item avgPITex |
|
480 |
+@item avgPPTex |
|
481 |
+@item avgBPTex |
|
482 |
+@item avgTex |
|
483 |
+@end table |
|
484 |
+ |
|
273 | 485 |
@c man end |
274 | 486 |
|
275 | 487 |
@ignore |