全般ドキュメント

1 外部ライブラリ

FFmpeg は多くの外部ライブラリと連携させて、対応フォーマットを増やせます。いずれも既定では使われず、利用するには ./configure に対応するフラグを渡して明示的に指定する必要があります。

1.1 Alliance for Open Media (AOM)

FFmpeg は AOM ライブラリを使って AV1 のデコードとエンコードを行えます。

http://aomedia.org/ にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libaom を configure に渡すと有効になります。

1.2 AMD AMF/VCE

FFmpeg は AMD Advanced Media Framework ライブラリを使い、Video Coding Engine (VCE) を備えたハードウェア上で H.264 および HEVC(Windows のみ)のエンコードを高速化できます。

対応を有効にするには、https://github.com/GPUOpen-LibrariesAndSDKs/AMF.git から AMF フレームワークのヘッダファイル(バージョン 1.4.9 以降)を入手する必要があります。

システムのインクルードパスに AMF/ ディレクトリを作成し、AMF/amf/public/include/ の中身をそのディレクトリへコピーします。その後 --enable-amf を付けて FFmpeg を configure します。

amf encoder の初期化は次の順序で行われます。1) dx11(Windows のみ)での初期化を試みる 2) dx9(Windows のみ)での初期化を試みる 3) vulkan での初期化を試みる

linux で h.264(AMD VCE)エンコーダを使うには、amdgru-pro バージョン 19.20 以降と amf-amdgpu-pro パッケージ(amdgru-pro に含まれるが自動ではインストールされない)が必要となります。

このドライバは、公式の amd ドライバアーカイブに含まれる amdgpu-pro-install スクリプトでインストールできます。

1.3 AviSynth

FFmpeg は AviSynth スクリプトを入力として読み込めます。対応を有効にするには、AviSynth+ が提供するヘッダをインストールしたうえで、--enable-avisynth を configure に渡します。AviSynth+ は、通常の CMake ベースのビルドシステムに -DHEADERS_ONLY:bool=on を渡すか、付属の GNUmakefile を使うことで、ヘッダのみをインストールするよう構成できます。

Windows では、対応する AviSynth は、32 ビットビルド向けの AviSynth 2.6 RC1 以降 と、32 ビットおよび 64 ビットビルド向けの AviSynth+ r1718 以降 です。

Linux、macOS、BSD で対応する AviSynth は AviSynth+ のみで、バージョン 3.5 以降が対象となります。

2016 年、AviSynth+ は GCC でのビルドに対応しました。ただし Windows の呼び出し規約に独特な事情があるため、AviSynth+ の 32 ビット GCC ビルドは、一般的な FFmpeg の 32 ビットビルドと互換性がありません。

FFmpeg は既定で、AviSynth+ の 32 ビット MSVC ビルドとの互換性を前提とします。これが最も広く使われ定着したビルド構成だからです。これを上書きして AviSynth+ の 32 ビット GCC ビルドへの対応を有効にするには、FFmpeg の configure 時に --extra-cflags へ -DAVSC_WIN32_GCC32 を渡します。

FFmpeg の 64 ビットビルドはこの影響を受けず、特別なフラグなしで AviSynth+ の MSVC ビルドと GCC ビルドのどちらも利用できます。

AviSynth(+) は動的に読み込まれます。配布者は --enable-avisynth を付けて FFmpeg をビルドでき、そのバイナリはエンドユーザーが AviSynth をインストールしているかどうかに関係なく動作します。エンドユーザーが AviSynth スクリプトを使いたくなったときには、AviSynth(+) をインストールすれば、FFmpeg がそれを見つけてスクリプトを開くのに利用できます。

1.4 Chromaprint

FFmpeg は Chromaprint ライブラリを使って音声フィンガープリントを生成できます。--enable-chromaprint を configure に渡すと有効になります。https://acoustid.org/chromaprint を参照してください。

1.5 codec2

FFmpeg は codec2 ライブラリを使って codec2 のデコードとエンコードを行えます。現時点ではネイティブの decoder がないため、デコードには libcodec2 を使う必要があります。

http://freedv.org/ にアクセスし、「Codec 2 source archive」をダウンロードします。CMake でビルドしてインストールします。Debian ユーザーは代わりに libcodec2-dev パッケージをインストールすれば済みます。libcodec2 をインストールしたら、--enable-libcodec2 を configure に渡すと有効になります。

codec2 を最も手軽に使う方法は .c2 ファイルを用いることです。デコードに必要なモード情報をファイル自身が含んでいるからです。そのようなファイルを作るには、拡張子を .c2 にして、libcodec2 encoder に -mode オプションを与えます。例: ffmpeg -i input.wav -mode 700C output.c2。再生は ffplay output.c2 と打つだけで済みます。対応モードの一覧は ffmpeg -h encoder=libcodec2 で確認できます。生の codec2 ファイルにも対応しています。これらを正しく扱うには、使用するモードをフォーマットオプションとして指定する必要があります。例: ffmpeg -f codec2raw -mode 1300 -i input.raw output.wav。

1.6 dav1d

FFmpeg は dav1d ライブラリを使って AV1 映像のデコードを行えます。

https://code.videolan.org/videolan/dav1d にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libdav1d を configure に渡すと有効になります。

1.7 davs2

FFmpeg は davs2 ライブラリを使って AVS2-P2/IEEE1857.4 映像のデコードを行えます。

https://github.com/pkuvcl/davs2 にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libdavs2 を configure に渡すと有効になります。

libdavs2 は GNU Public License Version 2 以降のもとで提供されています(詳細は http://www.gnu.org/licenses/old-licenses/gpl-2.0.html を参照)。利用するには FFmpeg のライセンスを GPL に引き上げる必要があります。

1.8 uavs3d

FFmpeg は uavs3d ライブラリを使って AVS3-P2/IEEE1857.10 映像のデコードを行えます。

https://github.com/uavs3/uavs3d にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libuavs3d を configure に渡すと有効になります。

1.9 Game Music Emu

FFmpeg は Game Music Emu ライブラリを使い、対応するビデオゲーム音楽ファイル形式から音声を読み込めます。--enable-libgme を configure に渡すと有効になります。https://bitbucket.org/mpyne/game-music-emu/overview を参照してください。

1.10 Intel QuickSync Video

FFmpeg は Intel QuickSync Video (QSV) を使い、複数の codec のデコードとエンコードを高速化できます。QSV を使うには、実際のデコードライブラリを読み込む libmfx ディスパッチャに FFmpeg をリンクする必要があります。

このディスパッチャはオープンソースで、https://github.com/lu-zero/mfx_dispatch.git からダウンロードできます。FFmpeg は --enable-libmfx オプションを付けて configure する必要があり、また pkg-config がディスパッチャの .pc ファイルを見つけられる状態でなければなりません。

1.11 Kvazaar

FFmpeg は Kvazaar ライブラリを使って HEVC のエンコードを行えます。

https://github.com/ultravideo/kvazaar にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libkvazaar を configure に渡すと有効になります。

1.12 LAME

FFmpeg は LAME ライブラリを使って MP3 のエンコードを行えます。

http://lame.sourceforge.net/ にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libmp3lame を configure に渡すと有効になります。

1.13 LCEVCdec

FFmpeg は liblcevc_dec ライブラリを使い、対応する bitstream で LCEVC エンハンスメントレイヤのデコードを行えます。

https://github.com/v-novaltd/LCEVCdec にアクセスし、ライブラリのインストール手順に従います。その後 --enable-liblcevc-dec を configure に渡すと有効になります。

LCEVCdec は BSD-3-Clause-Clear ライセンスのもとで提供されています。

1.14 libilbc

iLBC は狭帯域の音声 codec で、Google が WebRTC プロジェクトの一部として無償公開したものです。libilbc は iLBC codec をパッケージ化しやすい形にした複製です。FFmpeg は libilbc ライブラリを使って iLBC のデコードとエンコードを行えます。

https://github.com/TimothyGu/libilbc にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libilbc を configure に渡すと有効になります。

1.15 libjxl

JPEG XL は、従来の JPEG を長期にわたって完全に置き換えることを狙った画像フォーマットです。詳細は https://jpegxl.info/ を、ライブラリのソースは https://github.com/libjxl/libjxl を参照してください。libjxl ラッパーを有効にするには --enable-libjxl を configure に渡します。

1.16 libvpx

FFmpeg は libvpx ライブラリを使って VP8/VP9 のデコードとエンコードを行えます。

http://www.webmproject.org/ にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libvpx を configure に渡すと有効になります。

1.17 ModPlug

FFmpeg は、Modplug-XMMS に由来するこのライブラリを使い、MOD 系の音楽ファイルを読み込めます。https://github.com/Konstanty/libmodplug を参照してください。--enable-libmodplug を configure に渡すと有効になります。

1.18 ONNX Runtime

FFmpeg は ONNX Runtime ライブラリを、DNN ベースのフィルタのバックエンドとして利用できます。

https://onnxruntime.ai/ にアクセスし、ライブラリのインストール手順に従います。さまざまなプラットフォーム向けにビルド済みパッケージが用意されています。

ONNX Runtime 対応を付けて FFmpeg を configure します。

./configure \
    --enable-libonnxruntime \
    --extra-cflags="-I/path/to/onnxruntime/include" \
    --extra-ldflags="-L/path/to/onnxruntime/lib"

ELF ベースのシステム(Linux、BSD)では、LD_LIBRARY_PATH を設定しなくてもインストール済みの ffmpeg バイナリが実行時に共有ライブラリを見つけられるよう、ライブラリ検索パスを埋め込んでおくとよいでしょう。

./configure \
    --enable-libonnxruntime \
    --extra-cflags="-I/path/to/onnxruntime/include" \
    --extra-ldflags="-L/path/to/onnxruntime/lib -Wl,-rpath,/path/to/onnxruntime/lib"

-Wl,-rpath フラグは ELF 固有のものであり、他のプラットフォーム(Windows、macOS)では省くべきです。

MinGW GCC ビルドでは、ONNX Runtime ヘッダとの互換性のために -D_stdcall=__stdcall フラグを追加します。

1.19 OpenCORE・VisualOn・Fraunhofer の各ライブラリ

Google Android のソースから派生した OpenCore、VisualOn、Fraunhofer の各ライブラリは、多くの音声 codec 向けのエンコーダを提供します。

OpenCORE と VisualOn のライブラリは Apache License 2.0 のもとで提供されており(詳細は http://www.apache.org/licenses/LICENSE-2.0 を参照)、これは LGPL version 2.1 および GPL version 2 と互換性がありません。利用するには、--enable-version3 を configure に渡して、FFmpeg のライセンスを LGPL version 3(GPL コンポーネントを有効にしている場合は GPL version 3)に引き上げる必要があります。

Fraunhofer AAC ライブラリのライセンスは GPL と互換性がありません。そのため GPL ビルドでこれを使うには、--enable-nonfree を configure に渡す必要があります。私たちの知る限り、LGPL とは互換性があります。

1.19.1 OpenCORE AMR

FFmpeg は OpenCORE ライブラリを使い、AMR-NB のデコード/エンコードと AMR-WB のデコードを行えます。

http://sourceforge.net/projects/opencore-amr/ にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libopencore-amrnb と --enable-libopencore-amrwb のいずれか、または両方を configure に渡すと有効になります。

1.19.2 VisualOn AMR-WB encoder ライブラリ

FFmpeg は VisualOn AMR-WBenc ライブラリを使って AMR-WB のエンコードを行えます。

http://sourceforge.net/projects/opencore-amr/ にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libvo-amrwbenc を configure に渡すと有効になります。

1.19.3 Fraunhofer AAC ライブラリ

FFmpeg は Fraunhofer AAC ライブラリを使って AAC のデコードとエンコードを行えます。

http://sourceforge.net/projects/opencore-amr/ にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libfdk-aac を configure に渡すと有効になります。

1.19.4 Fraunhofer MPEG-H 3D Audio decoder ライブラリ

FFmpeg は Fraunhofer MPEG-H decoder ライブラリを使って MPEG-H 3DA のデコードを行えます。

https://github.com/Fraunhofer-IIS/mpeghdec にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libmpeghdec --enable-nonfree を configure に渡すと有効になります。

1.19.5 LC3 ライブラリ

FFmpeg は Google LC3 ライブラリを使って LC3 のデコードとエンコードを行えます。

https://github.com/google/liblc3/ にアクセスし、ライブラリのインストール手順に従います。その後 --enable-liblc3 を configure に渡すと有効になります。

1.20 OpenH264

FFmpeg は OpenH264 ライブラリを使って H.264 のデコードとエンコードを行えます。

http://www.openh264.org/ にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libopenh264 を configure に渡すと有効になります。

デコードに関しては、このライブラリは libavcodec 内蔵の decoder よりはるかに機能が限られています。現時点では、B フレームのデコードや、その他いくつかの main/high プロファイルの機能に対応していません(現状は constrained baseline プロファイルと CABAC のみ対応)。主に、テスト用途や、Cisco の特許ポートフォリオライセンス(http://www.openh264.org/BINARY_LICENSE.txt)を活用する目的で役立ちます。

1.21 OpenJPEG

FFmpeg は OpenJPEG ライブラリを使って J2K 映像のデコード/エンコードを行えます。http://www.openjpeg.org/ にアクセスしてライブラリを入手し、インストール手順に従います。FFmpeg で OpenJPEG を使えるようにするには、--enable-libopenjpeg を ./configure に渡します。

1.22 rav1e

FFmpeg は rav1e (Rust AV1 Encoder) を、その C バインディング経由で使って映像をエンコードできます。https://github.com/xiph/rav1e/ にアクセスし、C ライブラリのビルド手順に従います。FFmpeg で rav1e を使えるようにするには、--enable-librav1e を ./configure に渡します。

1.23 SVT-AV1

FFmpeg は Scalable Video Technology for AV1 ライブラリを使って AV1 のエンコードを行えます。

https://gitlab.com/AOMediaCodec/SVT-AV1/ にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libsvtav1 を configure に渡すと有効になります。

1.24 SVT-JPEG-XS

FFmpeg は Scalable Video Technology for JPEG-XS ライブラリを使って JPEG-XS のデコードとエンコードを行えます。

https://github.com/OpenVisualCloud/SVT-JPEG-XS にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libsvtjpegxs を configure に渡すと有効になります。

1.25 TwoLAME

FFmpeg は TwoLAME ライブラリを使って MP2 のエンコードを行えます。

http://www.twolame.org/ にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libtwolame を configure に渡すと有効になります。

1.26 VapourSynth

FFmpeg は VapourSynth スクリプトを入力として読み込めます。対応を有効にするには、--enable-vapoursynth を configure に渡します。Vapoursynth は pkg-config 経由で検出されます。バージョン 42 以降に対応しています。http://www.vapoursynth.com/ を参照してください。

セキュリティ上の懸念から、Vapoursynth スクリプトは自動検出されないので、入力フォーマットを強制的に指定する必要があります。ff* 系の CLI ツールでは、入力 -i yourscript.vpy の前に -f vapoursynth を加えます。

1.27 x264

FFmpeg は x264 ライブラリを使って H.264 のエンコードを行えます。

http://www.videolan.org/developers/x264.html にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libx264 を configure に渡すと有効になります。

x264 は GNU Public License Version 2 以降のもとで提供されています(詳細は http://www.gnu.org/licenses/old-licenses/gpl-2.0.html を参照)。利用するには FFmpeg のライセンスを GPL に引き上げる必要があります。

1.28 x265

FFmpeg は x265 ライブラリを使って HEVC のエンコードを行えます。

http://x265.org/developers.html にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libx265 を configure に渡すと有効になります。

x265 は GNU Public License Version 2 以降のもとで提供されています(詳細は http://www.gnu.org/licenses/old-licenses/gpl-2.0.html を参照)。利用するには FFmpeg のライセンスを GPL に引き上げる必要があります。

1.29 xavs

FFmpeg は xavs ライブラリを使って AVS のエンコードを行えます。

http://xavs.sf.net/ にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libxavs を configure に渡すと有効になります。

1.30 xavs2

FFmpeg は xavs2 ライブラリを使って AVS2-P2/IEEE1857.4 映像のエンコードを行えます。

https://github.com/pkuvcl/xavs2 にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libxavs2 を configure に渡すと有効になります。

libxavs2 は GNU Public License Version 2 以降のもとで提供されています(詳細は http://www.gnu.org/licenses/old-licenses/gpl-2.0.html を参照)。利用するには FFmpeg のライセンスを GPL に引き上げる必要があります。

1.31 eXtra-fast Essential Video Encoder (XEVE)

FFmpeg は XEVE ライブラリを使って EVC 映像のエンコードを行えます。

https://github.com/mpeg5/xeve にアクセスし、XEVE ライブラリのインストール手順に従います。その後 --enable-libxeve を configure に渡すと有効になります。

1.32 eXtra-fast Essential Video Decoder (XEVD)

FFmpeg は XEVD ライブラリを使って EVC 映像のデコードを行えます。

https://github.com/mpeg5/xevd にアクセスし、XEVD ライブラリのインストール手順に従います。その後 --enable-libxevd を configure に渡すと有効になります。

1.33 ZVBI

ZVBI は VBI デコードライブラリで、FFmpeg から DVB テレテキストのページや DVB テレテキスト字幕のデコードに利用できます。

http://sourceforge.net/projects/zapping/ にアクセスし、ライブラリのインストール手順に従います。その後 --enable-libzvbi を configure に渡すと有効になります。

2 対応するファイルフォーマット・codec・機能

-formats と -codecs オプションを使うと、網羅的な一覧を得られます。

2.1 ファイルフォーマット

FFmpeg は libavformat ライブラリを通じて、次のファイルフォーマットに対応しています。

X はその列(エンコード/デコード)の機能に対応していることを表します。

2.2 画像フォーマット

FFmpeg は映像シーケンスの各フレームを画像として読み書きできます。対応する画像フォーマットは次のとおりです。

X はその列(エンコード/デコード)の機能に対応していることを表します。

E は外部ライブラリによって対応が提供されることを表します。

2.3 映像 codec

X はその列(エンコード/デコード)の機能に対応していることを表します。

E は外部ライブラリによって対応が提供されることを表します。

2.4 音声 codec

X はその列(エンコード/デコード)の機能に対応していることを表します。

E は外部ライブラリによって対応が提供されることを表します。

I は整数演算のみのバージョンも利用できることを表す(ハードウェア浮動小数点演算をもたないシステムでも高い性能を確保します)。

2.5 字幕フォーマット

X はその機能に対応していることを表します。

E は外部ライブラリによって対応が提供されることを表します。

2.6 ネットワークプロトコル

X はそのプロトコルに対応していることを表します。

E は外部ライブラリによって対応が提供されることを表します。

2.7 入出力デバイス

X は入出力に対応していることを表します。

2.8 タイムコード

ホスティング提供: telepoint.bg