数値のオプションは全て(そうではないと明記していない限り) 1つの数を表す入力文字列を受け取ります。それには国際単位系の接頭辞 (例えば 'K'、'M'、'G')を1つ含めてもかまいません。この接頭辞の直後に 'i' を付け加えると、10の累乗の代わりに2の累乗が使われます。 'B' という接尾辞は値を8倍し、また他の接尾辞に付け加えても単独でもどちらでも使えます。これによって例えば 'KB'、'MiB'、'G' や 'B' が接尾辞として許されます。

引数をとらないオプションはブール値のオプションであり、対応する値を true にします。オプション名の前に "no" をつけることで false にできます。例えば、コマンドラインで "-nofoo" とすることで "foo" という名前のブール値のオプションが false になります。

ストリーム指定子
========

オプションには、例えばビットレートやコーデックのように、ストリームごとに適用されるものがあります。ストリーム指定子は与えられたオプションがどのストリームに属するかを正確に指定するために使われます。

ストリーム指定子は文字列で、コロンによって区切られた省略可能なオプションの名前を追加されます。例えば -codec:a:1 ac3 というオプションは a:1 というストリーム指定子を含み、これは2番目の音声ストリームに対応します。したがってこのオプションは2番目の音声ストリームの ac3 コーデックを選択します。

ストリーム指定子はいくつかのストリームにマッチし、その場合それら全てにそのオプションは適用されます。例えば -b:a 128k でのストリーム指定子は全ての音声ストリームにマッチします。

空のストリーム指定子は全てのストリームにマッチし、例えば -codec copy あるいは -codec: copy は再エンコーディングすることなしに全てのストリームをコピーします。

可能なストリーム指定子の形は以下のとおりです:

STREAM_INDEX
     このインデックスを持つストリームにマッチします。例えば -threads:1 4 は 2番目のストリームのスレッドカウントを4に設定します。

STREAM_TYPE[:STREAM_INDEX]
     STREAM_TYPE は次のいずれかです: 映像のための 'v'、音声のための 'a'、字幕のための 's'、データのための 'd'、アタッチメントのための't'。 STREAM_INDEX が与えられていれば、その種類のストリーム番号 STREAM_INDEX のものにマッチします。さもなくばその種類の全てのストリームにマッチします。

p:PROGRAM_ID[:STREAM_INDEX]
     STREAM_INDEX が与えられていれば、id PROGRAM_ID を持つプログラムのストリーム番号 STREAM_INDEX のものにマッチします。さもなくばそのプログラムの全てのストリームにマッチします。

一般的なオプション
=========

これらのオプションは av* ツールの間で共有されます。

-L
     ライセンスを表示します。

-h, -?, -help, --help [ARG]
     ヘルプを表示します。省略可能なパラメーターで特定の項目についてのヘルプを表示するように指定できます。

     ARG に可能な値は:

     decoder=DECODER_NAME
          DECODER_NAME という名前のデコーダーについての詳細な情報を表示します。全てのデコーダーの一覧を取得するには -decoders オプションを使ってください。

     encoder=ENCODER_NAME
          ENCODER_NAME という名前のエンコーダーについての詳細な情報を表示します。全てのエンコーダーの一覧を取得するには -encoders オプションを使ってください。

     demuxer=DEMUXER_NAME
          DEMUXER_NAME という名前のデミュクサーについての詳細な情報を表示します。全てのミュクサーおよびデミュクサーの一覧を取得するには -formats オプションを使ってください。

     muxer=MUXER_NAME
          MUXER_NAME という名前のミュクサーについての詳細な情報を表示します。全てのミュクサーおよびデミュクサーの一覧を取得するには -formats オプションを使ってください。

-version
     バージョンを表示します。

-formats
     利用可能なフォーマットを表示します。

     フォーマット名の前にあるフィールドは次のような意味があります:

     D
          デコーディングが利用できる

     E
          エンコーディングが利用できる

-codecs
     libavcodec に認識される全てのコーデックを表示します。

     この文書では'コーデック'という用語はより正確にはメディアビットストリーム形式とよぶべきものの短縮名であることに注意してください。

-decoders
     利用可能なデコーダーを表示します。

-encoders
     利用可能なエンコーダーを表示します。

-bsfs
     利用可能な bitstream フィルターを表示します。

-protocols
     利用可能なプロトコルを表示します。

-filters
     利用可能な libavfilter フィルターを表示します。

-pix_fmts
     利用可能な pixel フォーマットを表示します。

-sample_fmts
     利用可能なサンプルフォーマットを表示します。

-loglevel LOGLEVEL | -v LOGLEVEL
     そのライブラリで使用されるログの冗長さを設定します。 LOGLEVEL は以下の値の1つを含んだ数値または文字列:

     quiet

     panic

     fatal

     error

     warning

     info

     verbose

     debug

     既定ではプログラムは標準エラー出力にログを出力し、端末が色付けに対応していれば、エラーと警告に印をつけるように色が使われます。ログの色付けは環境変数 AV_LOG_FORCE_NOCOLOR または NO_COLOR をセットすることで無効にでき、また環境変数 AV_LOG_FORCE_COLOR をセットすることで強制できます。環境変数 NO_COLOR の利用は非推奨で、今後の Libav のバージョンではなくなる予定です。

AVOptions
=========

これらのオプションは libavformat、libavdevice および libavcodec によって直接提供されています。利用できる AVOptions の一覧を見るには、-help オプションを使ってください。これらは2つのカテゴリーに分けられます:

generic
     これらのオプションはどのコンテナ、コーデック、またはデバイスでも設定できます。 Generic オプションはコンテナ/デバイスについては AVFormatContext オプションの下に、コーデックについては AVCodecContext オプションの下にあります。

private
     これらのオプションは特定のコンテナ、デバイス、またはコーデック専用のものです。 Private オプションは対応するコンテナ/デバイス/コーデックの下にあります。

例えば既定の ID3v2.4 の代わりに ID3v2.3 ヘッダを MP3 ファイルに書き込むには、 MP3 ミュクサーの id3v2_version という private オプションを使ってください:

     avconv -i input.flac -id3v2_version 3 out.mp3

全てのコーデックの AVOptions は明らかにストリームごとなので、ここにはストリーム指定子のチャプターの説明が適用されます。

注意として、-nooption 構文はブール値の AVOptions では使えないので、 -option 0/-option 1 を使ってください。

注意2として、v/a/s をオプション名の前に付けてストリームごとの AVOption を指定するという、従来の文書化されていない方法は、現在非推奨で近いうちに削除されます。

     [file avoptions_codec.texi not included]
     [file avoptions_format.texi not included]