FFmpeg で画像と動画を切り抜く方法
FFmpeg の crop フィルターを使うと、画像や動画の各フレームから矩形領域を切り抜けます。たとえば、crop=200:200:50:50 は左端から 50 ピクセル、上端から 50 ピクセルの位置を起点とする 200×200 の領域を切り抜きます。以下では JPEG と MP4 を切り抜いて寸法を確認し、Bash でディレクトリ内の画像にも同じ切り抜きを適用します。
FFmpeg とファイルの準備
サンプルは macOS または Linux の Bash で実行してください。FFmpeg ダウンロードページのプラットフォーム別リンクから、ffmpeg、ffprobe、および libx264 エンコーダーを含むビルドをインストールします。コマンドは macOS の FFmpeg 9.0.1 と Ubuntu 24.04 の FFmpeg 6.1.1 でテスト済みです。
インストールを確認します。
ffmpeg -version && ffprobe -version && ffmpeg -hide_banner -h encoder=libx264
最後のコマンドでエンコーダーの機能が表示されるはずです。不明なエンコーダーというエラーが出た場合は、先に libx264 を含むビルドをインストールしてください。
作業ディレクトリに、正しい向きの JPEG input.jpg と
MP4 input.mp4 を配置します。画像のサンプルには少なくとも 250×250 ピクセル、固定領域の動画切り抜きには少なくとも 1280×720 が必要です。動画のサンプルは、正方形ピクセルを使用し、回転メタデータのない通常の SDR 動画を前提としています。HDR やアナモルフィック映像の切り抜きには、色やアスペクト比に関する追加処理が必要です。
単一ファイル用のコマンドでは -y を使うため、再実行すると、指定した出力ファイルが上書きされます。以前の結果を残すには別の出力名を選び、入力とは異なる名前にしてください。-nostdin はキーボード操作を無効にするため、無人実行にも対応できます。FFmpeg のコマンドオプションも参照してください。
切り抜く矩形領域の選択
フィルターの構文は crop=width:height:x:y です。座標は左上隅の (0,0) を起点とし、x は右方向、y は下方向に増加します。切り抜きでは矩形の外側のピクセルが除去され、内側の内容は拡大縮小されません。
矩形を入力の範囲内に収めるには、寸法を正の値、オフセットを非負の値にし、x + width が入力の幅以下、y + height が高さ以下になるようにします。これらの範囲は自分で確認してください。FFmpeg はエラーを報告する代わりに、範囲外のオフセットを調整して矩形を収めることがあります。
x と y を省略すると、中央を切り抜けます。クロマサブサンプリングされた入力では、通常、座標と寸法がサブサンプリングのグリッドに合わせて切り下げられます。以下のサンプルでは、一般的な 4:2:0 形式に合わせて偶数を使用します。FFmpeg の crop リファレンスには、これらの既定の動作と、奇数の座標が必要な切り抜き用の exact オプションが記載されています。
FFmpeg による画像の切り抜き
上記の矩形領域を切り抜き、cropped.png として保存します。
ffmpeg -hide_banner -nostdin -y -pattern_type none -i input.jpg \
-vf "crop=200:200:50:50" -frames:v 1 -update 1 cropped.png
-frames:v 1 は画像を一枚書き出します。PNG を使うと、切り抜き後に JPEG の非可逆エンコードを重ねずに済みます。-pattern_type none は入力ファイル名を文字どおりに扱い、-update 1 は出力ファイル名を同様に扱います。これらのオプションは、ファイル名に %03d が含まれる場合にも重要です。指定しないと、FFmpeg はそれを連番画像のパターンとして扱います。これらの動作については、画像入力オプションと画像出力オプションに記載されています。
ffprobe で出力の寸法を確認します。
ffprobe -v error -select_streams v:0 -show_entries stream=width,height \
-of csv=p=0:s=x cropped.png
200x200 と表示されるはずです。PNG も開いてください。寸法だけでは、意図した被写体が残っているかどうかは確認できません。
FFmpeg による動画の切り抜き
input.mp4 の各フレームから、左上の 1280×720 の領域を切り抜きます。
ffmpeg -hide_banner -nostdin -y -i input.mp4 \
-map 0:v:0 -map '0:a:0?' -vf "crop=1280:720:0:0" \
-c:v libx264 -crf 18 -pix_fmt yuv420p -c:a aac -b:a 128k cropped.mp4
出力には H.264 動画と、音声がある場合は AAC にエンコードされた最初の音声トラックが含まれます。引用符で囲まれた ? は音声のマッピングを任意にするため、音声のない入力でも動作します。追加の動画トラック、音声トラック、字幕は除外されます。ストリームマッピングのドキュメントを参照してください。
切り抜きには動画のデコードと再エンコードが必要なため、-c:v copy はこのフィルターと併用できません。-crf 18 は非可逆 H.264 エンコードの品質設定です。-pix_fmt yuv420p は 4:2:0 出力を選択します。このエンコーダーでは幅と高さが偶数である必要があります。
中央の正方形の切り抜き
横長・縦長どちらの動画でも、入力の幅と高さのうち小さい方を選び、偶数に切り下げます。
ffmpeg -hide_banner -nostdin -y -i input.mp4 \
-map 0:v:0 -map '0:a:0?' -vf "crop=w='trunc(min(iw,ih)/2)*2':h=ow" \
-c:v libx264 -crf 18 -pix_fmt yuv420p -c:a aac -b:a 128k square.mp4
ここで、iw と ih は入力の寸法、ow は計算された切り抜き幅です。x と y を省略すると正方形が中央に配置されますが、前述のクロマグリッドに合わせた丸め処理が適用されます。1920×1080 の入力からは 1080×1080 ピクセルの出力が得られます。中央の固定領域を切り抜くため、端に近い被写体は見切れることがあります。
動画出力の確認
ffprobe の項目選択機能を使って、寸法とコーデックを確認します。
ffprobe -v error -show_entries stream=codec_type,codec_name,width,height \
-of json cropped.mp4
幅 1280、高さ 720 の
h264 動画ストリームと、入力に音声があれば
aac ストリームが含まれるはずです。正方形の切り抜きを確認するには、cropped.mp4 を square.mp4 に置き換えます。結果を再生して、クリップ全体の構図と音声を確認してください。
JPEG 画像の一括切り抜き
次の内容を crop-images.sh として保存し、JPEG があるディレクトリから
bash crop-images.sh を実行します。そのディレクトリ内で、小文字の .jpg で終わる隠しファイル以外のファイルを処理し、(50,50) を起点とする同じ 200×200 の領域を切り抜きます。各入力は、この矩形に必要な最小寸法 250×250 を満たす必要があります。
#!/usr/bin/env bash
set -euo pipefail
shopt -s nullglob
images=(./*.jpg)
if (( ${#images[@]} == 0 )); then
printf '%s\n' 'No .jpg files found.' >&2
exit 1
fi
mkdir ./cropped
for image in "${images[@]}"; do
name=${image##*/}
ffmpeg -hide_banner -loglevel error -nostdin -y \
-pattern_type none -i "$image" -vf "crop=200:200:50:50" \
-frames:v 1 -update 1 "./cropped/${name%.jpg}.png"
done
このスクリプトには、新しい cropped ディレクトリが必要です。すでに存在する場合は mkdir が失敗し、処理を始める前にスクリプトが停止します。そのディレクトリの結果は残しておき、再実行する際はスクリプト内で新しい出力ディレクトリを指定してください。出力はサブディレクトリ内の PNG なので、次回の実行で入力になることはありません。
引用符と ./ 接頭辞は、ファイル名の空白や先頭のハイフンに対応します。画像用オプションは、入力と出力の両方でパーセント記号を含むパターンを文字どおりに扱います。ディレクトリが空の場合はエラーになります。読み取れない画像や切り抜き領域に対して小さすぎる入力で FFmpeg が失敗すると、スクリプトは停止します。書き込み済みのファイルは cropped に残るため、再試行する前に途中までの結果を確認してください。
