この記事でわかること

  • eq フィルタで明度・コントラスト・ガンマ・彩度を変更するコマンド
  • 各パラメータの意味と値の範囲
  • 複数パラメータを組み合わせた実用的な補正
  • 動的に変化するパラメータの指定方法

テスト済みバージョン: FFmpeg 6.1(ubuntu-latest / CI検証済み)
対象 OS: Windows / macOS / Linux


基本コマンド

明度を上げる

ffmpeg -i input.mp4 -vf "eq=brightness=0.1" output.mp4

brightness の範囲は -1.01.0、デフォルトは 0。正の値で明るく、負の値で暗くなります。

コントラストを上げる

ffmpeg -i input.mp4 -vf "eq=contrast=1.5" output.mp4

contrast の範囲は -1000.01000.0、デフォルトは 11 で変化なし、大きいほどコントラストが強くなります。

ガンマ補正する

ffmpeg -i input.mp4 -vf "eq=gamma=1.5" output.mp4

gamma の範囲は 0.110.0、デフォルトは 11 で変化なし、1.5 以上でシャドウが持ち上がります。

彩度を調整する

ffmpeg -i input.mp4 -vf "eq=saturation=1.5" output.mp4

saturation の範囲は 0.03.0、デフォルトは 10 でグレースケール、1.5 で鮮やかに。


パラメータ一覧

パラメータ説明デフォルト範囲
contrastコントラスト1.0-1000 〜 1000
brightness明度オフセット0.0-1.0 〜 1.0
saturation彩度倍率1.00.0 〜 3.0
gammaガンマ補正1.00.1 〜 10.0
gamma_r赤チャンネルのガンマ1.00.1 〜 10.0
gamma_g緑チャンネルのガンマ1.00.1 〜 10.0
gamma_b青チャンネルのガンマ1.00.1 〜 10.0
gamma_weightハイライト保護の重み1.00.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 フィルタとの違い

機能eqhue
明度✓(乗算)✓(加算)
コントラスト
ガンマ
彩度
色相回転

細かなトーン調整には eq、色相の変更には hue が適しています。


関連フィルタ

  • hue — 色相・彩度・輝度の調整
  • curves — トーンカーブベースの色補正
  • colorbalance — シャドウ・ミッド・ハイライトの色調補正