doc/fftools-common-opts.texi

   1 All the numerical options, if not specified otherwise, accept in input
   2 a string representing a number, which may contain one of the
   3 International System number postfixes, for example 'K', 'M', 'G'.
   4 If 'i' is appended after the postfix, powers of 2 are used instead of
   5 powers of 10. The 'B' postfix multiplies the value for 8, and can be
   6 appended after another postfix or used alone. This allows using for
   7 example 'KB', 'MiB', 'G' and 'B' as postfix.
   8
   9 Options which do not take arguments are boolean options, and set the
  10 corresponding value to true. They can be set to false by prefixing
  11 with "no" the option name, for example using "-nofoo" in the
  12 commandline will set to false the boolean option with name "foo".
  13
  14 @section Generic options
  15
  16 These options are shared amongst the ff* tools.
  17
  18 @table @option
  19
  20 @item -L
  21 Show license.
  22
  23 @item -h, -?, -help, --help
  24 Show help.
  25
  26 @item -version
  27 Show version.
  28
  29 @item -formats
  30 Show available formats.
  31
  32 The fields preceding the format names have the following meanings:
  33 @table @samp
  34 @item D
  35 Decoding available
  36 @item E
  37 Encoding available
  38 @end table
  39
  40 @item -codecs
  41 Show available codecs.
  42
  43 The fields preceding the codec names have the following meanings:
  44 @table @samp
  45 @item D
  46 Decoding available
  47 @item E
  48 Encoding available
  49 @item V/A/S
  50 Video/audio/subtitle codec
  51 @item S
  52 Codec supports slices
  53 @item D
  54 Codec supports direct rendering
  55 @item T
  56 Codec can handle input truncated at random locations instead of only at frame boundaries
  57 @end table
  58
  59 @item -bsfs
  60 Show available bitstream filters.
  61
  62 @item -protocols
  63 Show available protocols.
  64
  65 @item -filters
  66 Show available libavfilter filters.
  67
  68 @item -pix_fmts
  69 Show available pixel formats.
  70
  71 @item -sample_fmts
  72 Show available sample formats.
  73
  74 @item -loglevel @var{loglevel}
  75 Set the logging level used by the library.
  76 @var{loglevel} is a number or a string containing one of the following values:
  77 @table @samp
  78 @item quiet
  79 @item panic
  80 @item fatal
  81 @item error
  82 @item warning
  83 @item info
  84 @item verbose
  85 @item debug
  86 @end table
  87
  88 By default the program logs to stderr, if coloring is supported by the
  89 terminal, colors are used to mark errors and warnings. Log coloring
  90 can be disabled setting the environment variable
  91 @env{FFMPEG_FORCE_NOCOLOR} or @env{NO_COLOR}, or can be forced setting
  92 the environment variable @env{FFMPEG_FORCE_COLOR}.
  93 The use of the environment variable @env{NO_COLOR} is deprecated and
  94 will be dropped in a following Libav version.
  95
  96 @end table
  97
  98 @section AVOptions
  99
 100 These options are provided directly by the libavformat, libavdevice and
 101 libavcodec libraries. To see the list of available AVOptions, use the
 102 @option{-help} option. They are separated into two categories:
 103 @table @option
 104 @item generic
 105 These options can be set for any container, codec or device. Generic options are
 106 listed under AVFormatContext options for containers/devices and under
 107 AVCodecContext options for codecs.
 108 @item private
 109 These options are specific to the given container, device or codec. Private
 110 options are listed under their corresponding containers/devices/codecs.
 111 @end table
 112
 113 For example to write an ID3v2.3 header instead of a default ID3v2.4 to
 114 an MP3 file, use the @option{id3v2_version} private option of the MP3
 115 muxer:
 116 @example
 117 ffmpeg -i input.flac -id3v2_version 3 out.mp3
 118 @end example
 119
 120 You can precisely specify which stream(s) should the codec AVOption apply to by
 121 appending a stream specifier of the form
 122 @option{[:@var{stream_type}][:@var{stream_index}]} to the option name.
 123 @var{stream_type} is 'v' for video, 'a' for audio and 's' for subtitle streams.
 124 @var{stream_index} is a global stream index when @var{stream_type} isn't
 125 given, otherwise it counts streams of the given type only. As always, the index
 126 is zero-based. For example
 127 @example
 128 -foo -- applies to all applicable streams
 129 -foo:v -- applies to all video streams
 130 -foo:a:2 -- applies to the third audio stream
 131 -foo:0 -- applies to the first stream
 132 @end example
 133
 134 Note -nooption syntax cannot be used for boolean AVOptions, use -option
 135 0/-option 1.
 136
 137 Note2 old undocumented way of specifying per-stream AVOptions by prepending
 138 v/a/s to the options name is now obsolete and will be removed soon.