Browse code

added all options

Originally committed as revision 2142 to svn://svn.ffmpeg.org/ffmpeg/trunk

Fabrice Bellard authored on 2003/08/25 00:22:26
Showing 1 changed files
... ...
@@ -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