ImageMagick CLI で画像コラージュを作成
ImageMagick に画像リストを明示的に渡すと、指定どおりの順序でコラージュを作成できます。以下の Bash スクリプトは PNG のグリッド画像を作成し、元ファイルを変更せず、指定したファイルだけを読み込みます。既存の出力先は拒否するため、再実行してもコラージュを上書きしません。
ImageMagick のセットアップ
Linux と Bash、および JPEG と PNG に対応した ImageMagick 7 のインストール環境を使用します。この手順は GNU Bash 5.3.15 と ImageMagick 7.1.2-31 Q16-HDRI でテストしました。ImageMagick 6 と他の OS は、この例のテスト対象外です。
コマンドが失敗したときにプロンプトへ制御が戻るように、errexit を無効にした Bash シェルにコマンドブロックを貼り付けます。後述の保存用スクリプトでは、独自のエラー処理を設定します。
ツールが PATH 上にあることを確認します。
bash --version && magick --version
リソース制限の設定
インストール環境の既存のセキュリティポリシーは維持してください。これらの小規模な例では、グローバルポリシーを編集する必要はありません。現在の制限は次のコマンドで確認できます。
magick -list resource
サムネイルが小さくても、先にデコードが行われるため、大きな画像では設定済みの制限に達することがあります。ポリシーを変更する前に、元画像の数やサイズを減らしてください。各設定については、ImageMagick のリソースポリシーのドキュメントを参照してください。
画像の準備
書き込み可能なディレクトリから始めます。このブロックは、新しい
collage-demo ディレクトリにサンプルの JPEG を三つ作成し、別の出力ディレクトリも作成します。collage-demo がすでに存在する場合は失敗し、シェルの作業ディレクトリは元のまま維持されます。
(
mkdir collage-demo || exit 1
cd collage-demo || exit 1
mkdir photos collages || exit 1
magick -size 320x160 xc:red photos/red.jpg &&
magick -size 160x320 xc:lime photos/green.jpg &&
magick -size 240x240 xc:blue photos/blue.jpg
)
次のスクリプトを collage-demo/make-collage.sh として保存します。引数には、新しい .png 出力先に続けて、一つ以上のローカルの静止画 JPEG または PNG ファイルを指定します。各パスを引用符で囲み、表示したい順序でファイルを並べてください。生成済みの画像があるディレクトリでは *.jpg を使わないでください。シェルがそれらの画像も含めてしまいます。
ImageMagick には、ワイルドカードやフレームセレクターなどの独自のファイル名構文があります。シェルの引用符で囲むだけでは、この構文は無効になりません。スクリプトは各入力を通常のファイル名の一時ファイルにコピーしてからデコードし、完成した PNG を指定されたとおりの出力先にコピーします。これにより、空白、角括弧、パーセント記号を含むパスも扱えます。
#!/usr/bin/env bash
set -euo pipefail
if (( $# < 2 )); then
printf 'Usage: bash make-collage.sh OUTPUT.png INPUT [INPUT ...]\n' >&2
exit 2
fi
output=$1
shift
if [[ "$output" != *.png ]]; then
printf 'Output must end in .png: %q\n' "$output" >&2
exit 2
fi
if [[ -e "$output" || -L "$output" ]]; then
printf 'Refusing existing output: %q\n' "$output" >&2
exit 1
fi
work=$(mktemp -d)
trap 'rm -rf -- "$work"' EXIT
tiles=()
for input in "$@"; do
if [[ ! -f "$input" || ! -r "$input" ]]; then
printf 'Not a readable file: %q\n' "$input" >&2
exit 1
fi
if ! cp -- "$input" "$work/source"; then
printf 'Cannot copy input: %q\n' "$input" >&2
exit 1
fi
tile="tile-${#tiles[@]}.png"
if ! (
cd -- "$work" &&
magick -regard-warnings 'source[0]' -auto-orient -colorspace sRGB \
-thumbnail 200x200 -background white -gravity center -extent 200x200 \
-alpha remove -alpha off -strip -depth 8 "$tile"
); then
printf 'Cannot decode input: %q\n' "$input" >&2
exit 1
fi
tiles+=("$tile")
done
(
cd -- "$work" &&
magick montage -regard-warnings "${tiles[@]}" -tile 3x \
-geometry 200x200+2+2 -background white -strip result.png
)
cp -- "$work/result.png" "$output"
printf 'Created %q\n' "$output"
各画像は切り抜きや引き伸ばしをせずに 200×200 のタイル内に収め、残りの領域を白い余白で埋めます。半透明のピクセルも含め、透明部分は白に合成します。スクリプトはリサイズ前に画像の向きを示すメタデータを適用し、合成前に色を sRGB に変換します。これは汎用的な変換です。特に CMYK 画像や ICC タグ付き画像など、正確な色合わせが重要な場合は、適切なカラープロファイルのワークフローを使用してください。
信頼できる、欠損のないローカル画像を使用してください。-regard-warningsは、一部のデコード警告をエラーとして扱いますが、画像の完全性を検証するものではありません。テストしたビルドでは、ペイロードが途中で切れた JPEG でもコラージュが生成され、成功として終了しましたが、そのタイルの下部付近には不正なピクセルがありました。破損の可能性がある場合は、入力と出力されたタイル全体を確認してください。入力にシーケンスが含まれる場合は、最初のフレームだけを使用します。
montage によるコラージュの作成
collage-demo があるディレクトリで、次を実行します。
(
cd collage-demo &&
bash make-collage.sh collages/example.png \
photos/red.jpg photos/green.jpg photos/blue.jpg
)
collage-demo/collages/example.png を開きます。612×204 ピクセルで、左から赤、緑、青のタイルが並んでいるはずです。横長の画像には上下に、縦長の画像には左右に白い余白が付きます。各タイルの周囲には 2 ピクセルの余白があり、隣接するタイル間は 4 ピクセルになります。実際の写真を使う場合は、端も含めてすべてのタイルを確認してください。
同じコマンドを繰り返すと「Refusing existing output」で失敗し、PNG は変更されません。別のコラージュを作成するには、新しい出力先を選んでください。スクリプトは、すべてのタイルと montage の処理が成功した後にだけ結果をコピーします。ただし、最後のコピー中にファイルシステムエラーが起きると、不完全な出力が残ることがあります。ジョブは順番に実行してください。存在確認では、同じ出力先への同時書き込みを防げません。ジョブの実行中は元ファイルを変更しないでください。
レイアウトのカスタマイズ
グリッドはスクリプトの
montage オプションで制御します。-tile 3x は三列分を確保し、必要な数の行を使用します。-geometry 200x200+2+2 は、準備済みの 200×200 のタイルを使い、周囲に 2 ピクセルの余白を設けます。入力が四つの場合は 612×408 の画像になり、最終行の未使用セルは白になります。入力が一つまたは二つでも、三列分を確保します。サムネイルのサイズを変更するには、-thumbnail、-extent、および -geometry 内のサイズを揃えてください。
エラー処理を伴うバッチ処理
このブロックは、明示的に選択した入力セットから二つのコラージュを作成します。ジョブが失敗しても処理を続け、最後のジョブが成功した場合でも、どちらかが失敗していればゼロ以外のステータスを返します。
(
cd collage-demo || exit 1
status=0
bash make-collage.sh collages/warm.png \
photos/red.jpg photos/green.jpg || status=1
bash make-collage.sh collages/cool.png \
photos/green.jpg photos/blue.jpg || status=1
exit "$status"
)
入力ファイルが存在しない場合、空の場合、またはデコードエラーが発生する場合は、そのジョブが失敗し、エラーに選択したパスが示されます。復旧可能な破損には、前述の制約があります。入力パスを渡さなければ、使用方法のメッセージが表示されます。既存の出力もジョブの失敗として扱われますが、成功したジョブの結果はそのまま利用できます。
トラブルシューティング
magick が見つからない場合は、バージョン 7 がインストールされており、その実行ファイルのディレクトリが PATH 上にあることを確認してください。JPEG または PNG のデコーダーがない場合は、その形式を有効にしたビルドが必要です。ヘッダーパッケージをインストールするだけでは、既存のバイナリにデコーダーは追加されません。
入力の処理が失敗した場合は、元のパスを含む診断メッセージを読み、そのファイルを調べてください。リソースポリシーのエラーでは、処理量を減らし、インストール環境のポリシーを確認します。最後のコピーが失敗した場合は、出力ディレクトリが存在し、書き込み可能であることを確認してから、新しい出力先で再試行してください。スクリプトは出力ディレクトリを自動作成しません。
動作例を確認できたら、サンプルのパスを実際に使う画像リストに置き換えてください。入力順序を明示し、コラージュごとに新しい PNG 出力先を選びます。
