次世代エンコーダ VP9（webm）のエンコード設定について ffmpeg で使ったときの設定をまとめた。libvpx-vp9 は外部ライブラリなので別途インストールする必要がある。さらに音声のエンコーダで使われる libopus も外部ライブラリなのでこれもインストールする必要がある。
設定内容は多くあるがほとんどの設定は何も変えず、ビットレートの設定と品質・速度のトレードオフの設定を変える。VP9 は処理が遅いとよく言われるが、threads を設定することで速くなる。libx264 のように自動設定してくれないので一番下の方にある解像度に併せて設定する。
libvpx-1.7.0 から 10, 12ビット深度に対応した。
webmproject/libvpx: github.com
libvpx/CHANGELOG at master · webmproject/libvpx
基本コマンド
ffmpeg -i input -c:v libvpx-vp9 -crf 30 -qmin 3 -qmax 40 -b:v 0 -threads 3 -c:a libopus -b:a 128k output.webm
libopus をインストールしていない場合。
ffmpeg -i input -c:v libvpx-vp9 -crf 30 -qmin 3 -qmax 40 -b:v 0 -threads 3 -c:a opus -b:a 128k -strict -2 output.webm
品質指定（CQ）の 2pass エンコード例。
ffmpeg -i input -c:v libvpx-vp9 -crf 30 -qmin 3 -qmax 40 -b:v 0 -threads 3 -pass 1 -f webm -an -f null -
ffmpeg -i input -c:v libvpx-vp9 -crf 30 -qmin 3 -qmax 40 -b:v 0 -threads 3 -pass 2 -auto-alt-ref 6 -c:a libopus -b:a 128k output.webm
linux などの 1pass 目の例。
ffmpeg -i input -c:v libvpx-vp9 -crf 30 -qmin 3 -qmax 40 -b:v 0 -threads 3 -pass 1 -an -f webm /dev/null
ビットレート指定の 2pass エンコード例。
ffmpeg -i input -c:v libvpx-vp9 -b:v 2M -threads 3 -pass 1 -f webm -an -f null -
ffmpeg -i input -c:v libvpx-vp9 -b:v 2M -threads 3 -pass 2 -auto-alt-ref 6 -c:a libopus -b:a 128k output.webm
分割エンコードしてつなげるコマンド例。
ffmpeg -f concat -safe 0 -i input.txt -c copy output.webm
input.txt の内容。
file output-0.webm file output-1.webm
詳しくは 【ffmpeg】動画・音声を連結する concat の使い方 其の3
高画質にエンコードするには crf, qmin, qmax を下げて、キーフレームを適切に挿入する。
ffmpeg -i input -c:v libvpx-vp9 -crf 18 -qmin 3 -qmax 32 -keyint_min 24 -g 240 -b:v 0 -threads 3 -c:a libopus -b:a 96k output.webm
高ビット深度の場合は出力フォーマットを指定する。
ffmpeg -i input -c:v libvpx-vp9 -crf 18 -qmin 3 -qmax 32 -keyint_min 24 -g 240 -b:v 0 -threads 3 -pix_fmt yuv420p10le -c:a libopus -b:a 96k output.webm
アルファチャンネル付きの動画で出力。出力フォーマットにアルファチャンネルを含める。
ffmpeg -f lavfi -i testsrc2=d=10,chromakey=blue:.03:.1 -pix_fmt yuva420p -c:v libvpx-vp9 -crf 30 -qmin 3 -qmax 40 -b:v 0 -threads 3 output.webm
ビットレート設定
以下の設定のどれかを必ず指定する。crf を指定する場合は、qmin, qmax または minrate, maxrate の設定も必ず併用する。
- 平均ビットレート（ABR, VBR）
-c:v libvpx-vp9 -b:v 1000k - 平均ビットレート（上限と下限指定）
-c:v libvpx-vp9 -b:v 2000k -minrate 1500k -maxrate 2500k - 品質指定（CQ）
（-1 から 63 まで低い値ほど高品質）b:v 0 は必須項目
品質指定をしながら、平均ビットレートを指定せず b:v 0 に上限ビットレート maxrate の指定はできない
-c:v libvpx-vp9 -crf 30 -b:v 0 -qmin 3 -qmax 40 - 品質指定で上限ビットレートを指定
最大品質が crf 30 で平均ビットレートが 1000k になる
-c:v libvpx-vp9 -crf 30 -b:v 1000k -qmin 3 -qmax 40 - 品質指定で上限と下限ビットレートを指定
最大品質が crf 24 で平均ビットレートが 2000k になる
-c:v libvpx-vp9 -crf 24 -b:v 2000k -minrate 1500k -maxrate 2500k - 固定ビットレート、ビットレートと最小と最大の3つを一致させる（CBR）
-c:v libvpx-vp9 -b:v 1000k -minrate 1000k -maxrate 1000k - ロスレス（可逆圧縮）
-c:v libvpx-vp9 -lossless 1
エンコード設定
ffmpeg -h encoder=libvpx-vp9 で見られるエンコード設定とエンコーダ全般に指定できる設定の2つがある。以下は libvpx-1.8.0 より。
この中で重要なのがエンコード速度と品質に関わる cpu-used, speed, quality と、馴染みのある crf である。cpu-used, speed はエンコード速度と品質に大きく影響する設定である。既定値は 1 で両方とも 0 にするとものすごくエンコード速度が落ちる代わりに圧縮率が向上する。値を上げるとそれだけ速度が向上するが品質も悪くなる。品質と速度の面から 2 や 3 も候補になるが 4 の品質はよくない。マイナスも指定できるがプラスの時と出力内容は変わらない。また quality realtime を指定することで 5 以上の設定もできる。
cpu-used [int]
マイナスも指定できるがプラスの時と出力内容は変わらない。0 にすると最高品質だがものすごく遅くなる。quality の既定値である good のときは -4 から 4 までしか効果が無い。quality realtime にすると -8 から 8 まで効果がある
範囲：-8 から 8 まで
既定値：1
speed [int]
マイナスも指定できるがプラスの時と出力内容は変わらない。0 にすると最高品質だがものすごく遅くなる。quality の既定値である good のときは -4 から 4 までしか効果が無い。quality realtime にすると -8 から 8 まで効果がある
範囲：-16 から 16 までとあるが、実際は -8 から 8 まで
既定値：1
quality [int]
品質指定。cpu-used, speed の設定を受け付けない best(一番高品質一番低速度)、good 既定値、realtime の3つの指定が出来る。設定を細かく分ける場合に realtime を指定する。
指定値：best, good, realtime
既定値：good
crf [int]
品質の数値指定。小さい値ほど高画質
範囲：-1 から 63 まで
既定値：-1
auto-alt-ref [int]
パス指定の2パス目 pass 2 に指定。数値が大きいと高画質で容量も多く、速度も遅くなる
範囲：-1 から 6 まで
既定値：-1
libvpx-vp9 の設定以外に品質の上限下限の指定と、キーフレーム間隔、色空間がある。
qmin [int]
品質の上限指定。小さい値ほど高画質になる。crf を参考に設定する
既定値：-1
qmax [int]
品質の下限指定。大きい値ほど低画質になる。crf を参考に設定する
既定値：-1
g [int]
group of picture size で、keyint のこと
既定値：-1
keyint_min [int]
既定値：-1
threads [int]
下にある解像度に合わせて設定しないと速度が上がらない
指定値の2の累乗になるので3の場合は下のグラフの8になる
既定値：-1（自動設定ではない）
色空間関係は Command Line Options — x265 documentation を参考にした。
color_primaries [string]
- bt709
- unknown
- bt470m
- bt470bg
- smpte170m
- smpte240m
- bt2020
color_trc [string]
- bt709
- unknown
- bt470m
- bt470bg
- smpte170m
- smpte240m
- bt2020-10
- bt2020-12
- smpte2084：HDR
- arib-std-b67：signal HLG
colorspace [string]
- rgb
- bt709
- unspecified
- bt470bg
- smpte170m
- smpte240m
- bt2020_ncl
SD以下
ffmpeg -i input -c:v libvpx-vp9 -crf 30 -b:v 0 -qmin 3 -qmax 40 -color_primaries smpte170m -color_trc smpte170m -colorspace smpte170m -c:a libopus -b:a 96k output.webm
HD以上
ffmpeg -i input -c:v libvpx-vp9 -crf 30 -b:v 0 -qmin 3 -qmax 40 -color_primaries bt709 -color_trc bt709 -colorspace bt709 -c:a libopus -b:a 96k output.webm
色空間を明示する場合に ffmpeg 4.1 からは bsf:v vp9_metadata からでも設定できる。
ffmpeg -h bsf=vp9_metadata
color_space[int]
- unknown
- bt601
- bt709
- smpte170
- smpte240
- bt2020
- rgb
color_range[int]
- tv
- pc
ffmpeg -i input -c:v libvpx-vp9 -crf 30 -b:v 0 -qmin 3 -qmax 40 -bsf:v vp9_metadata=color_space=bt709:color_range=tv -c:a libopus -b:a 96k output.webm
推奨ビットレートと品質、スレッド数の設定
Recommended Settings for VOD | Google Developers より
ビットレートの下限は指定ビットレートの50%、上限は145%としている
| Frame Size/Frame Rate | Target Bitrate (VOD, kbps) | Min Bitrate (50%) | Max Bitrate (145%) |
| 320x240p @ 24,25,30 | 150 | 75 | 218 |
| 640x360p @ 24,25,30 | 276 | 138 | 400 |
| 640x480p @ 24,25,30 | 512 (LQ), 750 (MQ) | 256 (LQ) 375 (MQ) | 742 (LQ) 1088 (MQ) |
| 1280x720p @ 24,25,30 | 1024 | 512 | 1485 |
| 1280x720p @ 50,60 | 1800 | 900 | 2610 |
| 1920x1080p @ 24,25,30 | 1800 | 900 | 2610 |
| 1920x1080p @ 50,60 | 3000 | 1500 | 4350 |
| 2560x1440p @ 24,25,30 | 6000 | 3000 | 8700 |
| 2560x1440p @ 50,60 | 9000 | 4500 | 13050 |
| 3840x2160p @ 24,25,30 | 12000 | 6000 | 17400 |
| 3840x2160p @ 50,60 | 18000 | 9000 | 26100 |
縦解像度と品質指定(crf)
| Frame Height | Target Quality (CQ) |
| 240 | 37 |
| 360 | 36 |
| 480 | 34 (LQ) or 33 (MQ) |
| 720 | 32 |
| 1080 | 31 |
| 1440 | 24 |
| 2160 | 15 |
tile-columns と threads の指定
| Frame Size | Number of tile-columns | Number of threads |
| 320x240p | 1 (-tile-columns 0) | 2 (-threads 1) |
| 640x360p | 2 (-tile-columns 1) | 4 (-threads 2) |
| 640x480p | 2 (-tile-columns 1) | 4 (-threads 2) |
| 1280x720p | 4 (-tile-columns 2) | 8 (-threads 3) |
| 1920x1080p | 4 (-tile-columns 2) | 8 (-threads 3) |
| 2560x1440p | 8 (-tile-columns 3) | 16 (-threads 4) |
| 3840x2160p | 16 (-tile-columns 4) | 24 (-threads 5?) |
HDR エンコード
VP9 HDR Encoding | Google Developers より Youtube に投稿できる HDR 動画のエンコード。SMPTE 2086 のメタデータ書き込みに対応してないのでエンコードが終わったら mkvmerge を使う。mkvmerge は mkvtoolnix のアプリケーションの一つ。
ハイ ダイナミック レンジ（HDR）動画をアップロードする – YouTube ヘルプ
サンプル動画：strobe_scientist.mkv
以下のサンプルコマンドは Google が2パス指定をしているのを参考にしているが、1パスの品質指定や固定ビットレートで YouTube に投稿しても HDR 形式にエンコードされる。どちらにしろ再エンコードされるのでビットレートをたくさん盛っておけば良さそう。
18Mbps 4k 2-pass
ffmpeg -y -report -i strobe_scientist.webm -b:v 18000000 -pass 1 -pix_fmt yuv420p10le -color_primaries 9 -color_trc 16 -colorspace 9 -color_range 1 -maxrate 26800000 -minrate 8040000 -profile:v 2 -vcodec libvpx-vp9 -an -f null -
ffmpeg -y -report -i strobe_scientist.webm -b:v 18000000 -pass 2 -pix_fmt yuv420p10le -color_primaries 9 -color_trc 16 -colorspace 9 -color_range 1 -maxrate 26800000 -minrate 8040000 -profile:v 2 -vcodec libvpx-vp9 strobe_scientist_18Mbps.webm
6Mbps 4k 2-pass
ffmpeg -y -report -i strobe_scientist.mkv -b:v 6000000 -speed 4 -pass 1 -pix_fmt yuv420p10le -color_primaries 9 -color_trc 16 -colorspace 9 -color_range 1 -maxrate 8000000 -minrate 4000000 -profile:v 2 -vcodec libvpx-vp9 -f webm -an -f null -
ffmpeg -y -report -i strobe_scientist.mkv -b:v 6000000 -pass 2 -pix_fmt yuv420p10le -color_primaries 9 -color_trc 16 -colorspace 9 -color_range 1 -maxrate 8000000 -minrate 4000000 -profile:v 2 -vcodec libvpx-vp9 2pass_HDR_strobe_scientist_6Mbps-static.webm
18Mbps 1080p 2-pass
ffmpeg -y -report -i strobe_scientist.mkv -b:v 18000000 -speed 4 -pass 1 -pix_fmt yuv420p10le -color_primaries 9 -color_trc 16 -colorspace 9 -color_range 1 -maxrate 20800000 -minrate 15040000 -profile:v 2 -vf scale=-2:1080 -vcodec libvpx-vp9 -f webm -an -f null -
ffmpeg -y -report -i strobe_scientist.mkv -b:v 18000000 -pass 2 -pix_fmt yuv420p10le -color_primaries 9 -color_trc 16 -colorspace 9 -color_range 1 -maxrate 20800000 -minrate 15040000 -profile:v 2 -vf scale=-2:1080 -vcodec libvpx-vp9 1080_2pass_HDR_strobe_scientist_18Mbps-static.webm
18Mbps 4k HDR to SDR with LUT。lut3d フィルタで色を指定する。
ffmpeg -i strobe_scientist.mkv -y -b:v 18000000 -speed 4 -pass 1 -pix_fmt yuv420p -color_primaries 1 -color_trc 1 -colorspace 1 -color_range 1 -maxrate 26800000 -minrate 8040000 -profile:v 0 -vf scale=-1:-1:in_color_matrix=bt2020,format=rgb48,lut3d=bt2020_to_bt709_example.cube,scale=-1:-1:out_color_matrix=bt709 -vcodec libvpx-vp9 -f webm -an -f null -
ffmpeg -i strobe_scientist.mkv -y -b:v 18000000 -pass 2 -pix_fmt yuv420p -color_primaries 1 -color_trc 1 -colorspace 1 -color_range 1 -maxrate 26800000 -minrate 8040000 -profile:v 0 -vf scale=-1:-1:in_color_matrix=bt2020,format=rgb48,lut3d=bt2020_to_bt709_example.cube,scale=-1:-1:out_color_matrix=bt709 -vcodec libvpx-vp9 -f webm SDR_strobe_scientist_18Mbps-static.webm
18Mbps 4k 2-Pass HLG。HLG は元動画が HLG に対応していなければならない。
サンプル動画：strobe_scientist_hlg.mkv
ffmpeg -y -i strobe_scientist_hlg.mkv -b:v 18000000 -pass 1 -speed 4 -pix_fmt yuv420p10le -color_primaries 9 -color_trc 18 -colorspace 9 -color_range 1 -maxrate 26800000 -minrate 8040000 -profile:v 2 -vcodec libvpx-vp9 -f webm -an -f null -
ffmpeg -y -i strobe_scientist_hlg.mkv -b:v 18000000 -pass 2 -pix_fmt yuv420p10le -color_primaries 9 -color_trc 18 -colorspace 9 -color_range 1 -maxrate 26800000 -minrate 8040000 -profile:v 2 -vcodec libvpx-vp9 HLG_strobe_scientist_18Mbps-static.webm
MKVToolNix Downloads – Matroska tools for Linux/Unix and Windows
mkvmerge Doc — Merge multimedia streams into a Matroska file
mkvmerge -o HDR_strobe_scientist_18Mbps.mkv--colour-matrix 0:9 --colour-range 0:1 --colour-transfer-characteristics 0:16 --colour-primaries 0:9 --max-content-light 0:1000 --max-frame-light 0:300 --max-luminance 0:1000 --min-luminance 0:0.01 --chromaticity-coordinates 0:0.68,0.32,0.265,0.690,0.15,0.06 --white-colour-coordinates 0:0.3127,0.3290 HLG_HDR_strobe_scientist_18Mbps.webm
アルファチャンネル付き動画を読み込む
yuv420p, yuva420p, yuv422p, yuv440p, yuv444p, gbrp と高ビット深度に対応しているが特に yuva420p のアルファチャンネルは注意が必要で ffmpeg ではデコーダに libvpx-vp9 を指定しないとアルファチャンネルを読み込んでくれない。
アルファチャンネルのある PNG からのエンコード例（画像は連番のファイル名 img-001.png 形式）
ffmpeg -i img-%03d.png -vf format=yuva420p -c:v libvpx-vp9 -crf 30 -qmin 3 -qmax 40 -b:v 0 -threads 3 output.webm
デコード例（入力ファイルの前にコーデックを指定する）
ffmpeg -c:v libvpx-vp9 -i output.webm
どうりでアルファチャンネルが読み込めないわけだ "apparently the native VPx decoders still don't decode alpha" https://t.co/VtGgWpCeJ4
— ロべルト (@nico_lab) December 23, 2017
バイナリを読む
RAW ファイルコンテナには入れられないが lightweight IVFフォーマットに入れると32バイトグローバルヘッダとフレーム毎の12バイトヘッダで読みやすくなる。ffrprobe で見るときは動画時間が長いと莫大なデータ量になる。
ffmpeg – How to extract raw VP9 stream from WebM file? – Stack Overflow
ffmpeg -i input.webm -c copy stream.ivf
ffprobe -show_packets -show_data -i stream.ivf > show_data.txt
ハードウェアの対応
エンコードでコードのハードウェアの対応
SoCs Supporting VP8/VP9 : wiki.webmproject.org
VP9 の解説記事(英語)
- VP9 – Wikipedia VP9 の解説
- How VP9 works, technical details & diagrams – Doom9’s Forum VP9 の解説
- Do VP9 have B-frame or P-frame ? – Doom9’s Forum VP9 には B-frame がない代わりに altref, golden frame がある
- Instructions to playback Adaptive WebM using DASH – wiki DASH向けにエンコード
- Encode/VP9 – FFmpeg エンコード設定
- VP9 Encoding Guide – wiki エンコード設定
- The WebM Project | VP8 Encode Parameter Guide エンコード設定