boxblurフィルタでボックスブラーをかける

この記事でわかること

• boxblur フィルタでボックスブラーをかけるコマンド
• 半径（luma_radius）と繰り返し（luma_power）の意味
• 輝度・彩度を独立して制御する方法
• 映像全体と特定領域（crop+overlay）へのぼかし適用

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

基本コマンド

軽いぼかし

ffmpeg -i input.mp4 -vf "boxblur=2:1" output.mp4

引数の順序は luma_radius:luma_power です。2:1 は軽いぼかし。

強いぼかし

ffmpeg -i input.mp4 -vf "boxblur=10:3" output.mp4

半径 10、繰り返し 3 で強めのぼかしになります。

パラメータ詳細

boxblur=luma_radius:luma_power[:chroma_radius:chroma_power[:alpha_radius:alpha_power]]

輝度だけぼかして色情報を保持する

ffmpeg -i input.mp4 -vf "boxblur=luma_radius=10:luma_power=3:chroma_radius=0:chroma_power=0" output.mp4

chroma_radius=0 にすると彩度はぼかされません。細かなテクスチャだけを消したいときに有効です。

名前付き引数で書く

数値だけの省略形は順序を間違えやすいため、名前付き引数が推奨です。

ffmpeg -i input.mp4 \
  -vf "boxblur=luma_radius=5:luma_power=2" \
  output.mp4

繰り返し回数（power）の効果

ボックスブラーを複数回繰り返すと、ガウシアンブラーに近い滑らかなぼかしになります。

映像全体をぼかす（プライバシー保護・背景ぼかし）

ffmpeg -i input.mp4 -vf "boxblur=20:5" output.mp4

SNSへの投稿前に背景をぼかす場合などに使えます。

特定領域だけをぼかす

crop で切り出した領域にぼかしを適用し、overlay で元映像に重ねます。

ffmpeg -i input.mp4 \
  -vf "split[a][b]; \
    [a]crop=200:100:50:50,boxblur=15:3[blurred]; \
    [b][blurred]overlay=50:50" \
  output.mp4

• crop=W:H:X:Y — 幅200・高さ100、座標(50,50)から切り出し
• overlay=X:Y — 元映像の(50,50)に重ねる

静止画への適用

ffmpeg -i input.jpg -vf "boxblur=5:2" output.jpg

gblur（ガウシアンブラー）との比較

シンプルで高速なぼかしには boxblur、品質重視なら gblur が選択肢です。

NG例

NG例: 半径に 0 を指定する（luma_radius=0 はエラー）
ffmpeg -i input.mp4 -vf "boxblur=0:1" output.mp4

luma_radius に 0 を指定するとエラーになります。最小値は 1 です。

関連フィルタ

• gblur — ガウシアンブラー
• unsharp — アンシャープマスク（ブラーとしても使用可能）
• smartblur — エッジを保ちながらぼかす
• pixelize — ピクセレート（モザイク）効果

関連リソース

よく使うオプション・フィルタ・コーデック設定をまとめた PDF チートシートです。手元に置いておくと調べる時間を短縮できます。

FFmpeg チートシート