この記事でわかること
eqフィルタで明度・コントラスト・ガンマ・彩度を変更するコマンド- 各パラメータの意味と値の範囲
- 複数パラメータを組み合わせた実用的な補正
- 動的に変化するパラメータの指定方法
テスト済みバージョン: FFmpeg 6.1(ubuntu-latest / CI検証済み)
対象 OS: Windows / macOS / Linux
基本コマンド
明度を上げる
ffmpeg -i input.mp4 -vf "eq=brightness=0.1" output.mp4
brightness の範囲は -1.0 〜 1.0、デフォルトは 0。正の値で明るく、負の値で暗くなります。
コントラストを上げる
ffmpeg -i input.mp4 -vf "eq=contrast=1.5" output.mp4
contrast の範囲は -1000.0 〜 1000.0、デフォルトは 1。1 で変化なし、大きいほどコントラストが強くなります。
ガンマ補正する
ffmpeg -i input.mp4 -vf "eq=gamma=1.5" output.mp4
gamma の範囲は 0.1 〜 10.0、デフォルトは 1。1 で変化なし、1.5 以上でシャドウが持ち上がります。
彩度を調整する
ffmpeg -i input.mp4 -vf "eq=saturation=1.5" output.mp4
saturation の範囲は 0.0 〜 3.0、デフォルトは 1。0 でグレースケール、1.5 で鮮やかに。
パラメータ一覧
| パラメータ | 説明 | デフォルト | 範囲 |
|---|---|---|---|
contrast | コントラスト | 1.0 | -1000 〜 1000 |
brightness | 明度オフセット | 0.0 | -1.0 〜 1.0 |
saturation | 彩度倍率 | 1.0 | 0.0 〜 3.0 |
gamma | ガンマ補正 | 1.0 | 0.1 〜 10.0 |
gamma_r | 赤チャンネルのガンマ | 1.0 | 0.1 〜 10.0 |
gamma_g | 緑チャンネルのガンマ | 1.0 | 0.1 〜 10.0 |
gamma_b | 青チャンネルのガンマ | 1.0 | 0.1 〜 10.0 |
gamma_weight | ハイライト保護の重み | 1.0 | 0.0 〜 1.0 |
複数パラメータを同時指定する
ffmpeg -i input.mp4 -vf "eq=brightness=0.05:contrast=1.2:saturation=1.3:gamma=1.1" output.mp4
コロン(:)で区切って複数パラメータを同時指定できます。
チャンネル別ガンマ補正でホワイトバランスを調整する
ffmpeg -i input.mp4 -vf "eq=gamma_r=0.9:gamma_g=1.0:gamma_b=1.1" output.mp4
赤チャンネルを少し下げ、青を上げることで冷たい色味に調整できます。
グレースケール変換
ffmpeg -i input.mp4 -vf "eq=saturation=0" output.mp4
saturation=0 でグレースケール変換ができます。
動的パラメータ(時間で変化)
eq フィルタは FFmpeg 式(expression)に対応しています。
ffmpeg -i input.mp4 -vf "eq=brightness='0.1*sin(t)'" output.mp4
t は現在のタイムスタンプ(秒)です。明度が正弦波状に変化するエフェクトになります。
実用的な補正例
暗い映像を明るく補正する
ffmpeg -i input.mp4 -vf "eq=brightness=0.1:contrast=1.1:gamma=1.3" output.mp4
色あせた映像を鮮やかにする
ffmpeg -i input.mp4 -vf "eq=saturation=1.4:contrast=1.15" output.mp4
映像に硬質感を出す(シネマ風)
ffmpeg -i input.mp4 -vf "eq=contrast=1.2:saturation=0.85:gamma=0.95" output.mp4
NG例
NG例: saturatoin (スペルミス)
ffmpeg -i input.mp4 -vf "eq=saturatoin=1.5" output.mp4
パラメータ名のスペルミスは Invalid option エラーになります。
hue フィルタとの違い
| 機能 | eq | hue |
|---|---|---|
| 明度 | ✓(乗算) | ✓(加算) |
| コントラスト | ✓ | ✗ |
| ガンマ | ✓ | ✗ |
| 彩度 | ✓ | ✓ |
| 色相回転 | ✗ | ✓ |
細かなトーン調整には eq、色相の変更には hue が適しています。
関連フィルタ
hue— 色相・彩度・輝度の調整curves— トーンカーブベースの色補正colorbalance— シャドウ・ミッド・ハイライトの色調補正