ImageMagick による画像の一括リサイズと形式変換
レスポンシブなウェブサイト向けに、各画像から幅 480、960、1,440 ピクセルの画像を WebP と JPEG の両形式で生成します。この Bash スクリプトは元の画像を変更せず、新しい一括処理結果を書き出します。その後、小さな HTML ページで、生成したファイルからブラウザーが選択できるようにします。
ここでの目的は、同じウェブサイト用画像について、複数のサイズと代替形式を用意することです。ネストしたフォルダーも含め、JPEG ごとに PNG を一つ作成する場合は、JPEG から PNG への変換手順を参照してください。
ツールと入力の対象範囲を確認する
この処理には、大文字と小文字を区別するファイルシステムを備えた Linux 上で、Bash 5.3.15 と ImageMagick 7.1.2-31 を使用してください。コマンドブロックは Bash で実行します。ImageMagick 7 のインストール方法は公式ダウンロードページに掲載されています。imagemagick というパッケージではバージョン 6 が提供される場合があります。この処理ではバージョン 7 の magick 実行ファイルを使用します。Windows のネイティブシェルや macOS に付属する古い Bash は対象外です。
bash --version && magick -version && magick -list format
rw が、JPEG、PNG、WEBP の形式一覧にあることを確認してください。スクリプトは、一つの入力フォルダー直下にある静止画の JPEG(.jpg または .jpeg)、PNG、WebP を読み込みます。隠しファイルや大文字と小文字が混在する拡張子も対象です。サブディレクトリとシンボリックリンクはスキップします。各画像は、向きのメタデータを適用した後の幅が 1,440 ピクセル以上である必要があります。それより小さい画像は拡大せずに拒否します。アニメーション WebP を含め、デコーダーがシーケンスとして認識する画像も拒否します。PNG は静止画を使用してください。形式に関する注意事項にあるとおり、PNG デコーダーはアニメーション PNG(APNG)の最初のフレームしか読み込みません。このスクリプトはアニメーションを保持しません。
出力は不透明な 8 ビット画像です。どちらの形式でも、透明なピクセルは白い背景に合成します。ImageMagick の -colorspace sRGB は、合成前にデコード済みの色を変換します。これは一般的なウェブ用写真をローカルで処理するためのもので、ICC 校正用のワークフローではありません。プロファイルに依存する素材や広色域の素材では、プロファイルを削除する前に、適切な
-profile による変換が必要です。その作業のために元の画像を保持してください。
再現可能な入力を作成する
作業ディレクトリで、青と赤の領域が半分ずつを占めるサンプル画像を作成します。&& により、input-images が既に存在する場合は書き込みを停止します。このディレクトリは既存のプロジェクト内に配置してもかまいません。これらのコマンドはパッケージをインストールせず、プロジェクトの設定も変更しません。
mkdir input-images &&
magick -size 2400x1600 xc:steelblue -fill tomato \
-draw 'rectangle 1200,0 2399,1599' -depth 8 jpeg:- > input-images/hero.jpg
独自の画像を一括処理する場合は、対応する画像を入力フォルダーに配置し、スクリプトの実行中はその内容を変更しないでください。input-images フォルダーが既にある場合は、別の作業ディレクトリを使用してください。
一括処理スクリプトを保存する
次の内容を新しい batch-images.sh として、input-images と同じ階層に保存してください。各入力ファイルには、拡張子を含む完全なファイル名を使ったディレクトリを作成します。そのため、hero.jpg と hero.png は別々に扱われます。シェルのリダイレクトで ImageMagick の標準ストリームにデータを渡すため、ファイル名内の空白、先頭のハイフン、角括弧、% パターンは文字どおりに扱われます。
#!/usr/bin/env bash
set -euo pipefail
export LC_ALL=C
shopt -s nullglob dotglob
if (( $# != 2 )); then
printf 'Usage: bash batch-images.sh INPUT_DIR NEW_OUTPUT_DIR\n' >&2
exit 1
fi
# A final slash preserves directory names ending in newlines during command substitution.
input_argument=$1
[[ "$input_argument" == /* ]] || input_argument="./$input_argument"
input=$(cd -P -- "$input_argument" && printf '%s/' "$PWD")
input=${input%/}
output=$2
[[ "$output" == /* ]] || output="./$output"
files=()
for file in "$input"/*; do
[[ -f "$file" && ! -L "$file" ]] || continue
case ${file,,} in
*.jpg|*.jpeg|*.png|*.webp) files+=("$file") ;;
esac
done
if (( ${#files[@]} == 0 )); then
printf 'No supported images in %s\n' "$input" >&2
exit 1
fi
# mkdir refuses existing destinations, including existing symbolic links.
mkdir -- "$output"
stage="$output/.source.miff"
diagnostics="$output/.diagnostics"
trap 'rm -f -- "$stage" "$diagnostics"' EXIT
fail_image() {
printf 'Could not process: %s\n' "$file" >&2
cat -- "$diagnostics" >&2
exit 1
}
for file in "${files[@]}"; do
name=${file##*/}
case ${file,,} in
*.jpg|*.jpeg) coder=jpeg ;;
*.png) coder=png ;;
*.webp) coder=webp ;;
esac
# Normalize once, before resizing or discarding the source metadata.
if ! magick -regard-warnings "$coder:-" -auto-orient -colorspace sRGB \
-background white -alpha remove -alpha off -strip -depth 8 miff:- \
< "$file" 2> "$diagnostics" > "$stage" || [[ -s "$diagnostics" ]]; then
fail_image
fi
if ! dimensions=$(magick -regard-warnings miff:- -format '%n %w %h\n' info: \
< "$stage" 2> "$diagnostics") || [[ -s "$diagnostics" ]]; then
fail_image
fi
if [[ ! "$dimensions" =~ ^1\ ([0-9]+)\ ([0-9]+)$ ]]; then
printf 'Expected one still image: %s\n' "$file" >&2
exit 1
fi
if (( BASH_REMATCH[1] < 1440 )); then
printf 'Image must be at least 1440 pixels wide after orientation: %s\n' "$file" >&2
exit 1
fi
mkdir -- "$output/$name"
for width in 480 960 1440; do
for format in webp jpg; do
target="$output/$name/$width.$format"
if ! magick -regard-warnings miff:- -resize "${width}x>" -quality 82 "$format:-" \
< "$stage" 2> "$diagnostics" > "$target" || [[ -s "$diagnostics" ]]; then
rm -f -- "$target"
fail_image
fi
done
done
printf 'Created six images for %s\n' "$name"
done
printf 'Finished processing %s source image(s) in %s\n' "${#files[@]}" "$output"
スクリプトは、幅を確認する前に
-auto-orient を適用します。-resize '480x>' は、アスペクト比を保持したまま幅を制限します。ほかの二つのサイズも同じ仕組みです。入力の最小幅を設けることで、三種類の出力すべてが指定どおりの幅になります。
-quality 82 はエンコーダーの設定であり、見た目の品質が 82% であることや、ファイルサイズの削減を保証するものではありません。どちらの出力も非可逆エンコードを使用します。実際の写真に使う品質設定を決める前に、ファイルの見た目とバイト数を比較してください。
一括処理を実行して確認する
bash batch-images.sh input-images web-images
サンプルでは、成功すると Created six images for hero.jpg に続いて
Finished processing 1 source image(s) in ./web-images が表示されます。ディレクトリには hero.jpg/480.webp、hero.jpg/960.webp、hero.jpg/1440.webp と、それぞれに対応する .jpg ファイルが含まれます。元の input-images/hero.jpg は変更されません。再実行時には既存の web-images ディレクトリを拒否します。別の一括処理結果を作成するには、新しい出力先を選んでください。
スクリプトは C ロケール順でファイル名を処理し、最初のエラーで停止して、入力ファイルを識別するゼロ以外のステータスを返します。それ以前に正常に生成された派生画像は残り、失敗した派生画像は削除されます。これは一部だけが完了した一括処理結果であり、公開用のリリースではありません。内容を確認して入力ファイルを修正してから、新しいディレクトリを出力先として再実行してください。-regard-warnings がエラーに変換するのは、デコーダーの警告の一部だけです。そのため、スクリプトはステータスの確認に加え、診断メッセージも失敗として扱います。ただし、デコーダーが診断メッセージを出さずに破損した内容を復元することもあります。変換の成功は、入力に破損がないことの証明にはなりません。
ファイル名をパターンとして解釈させないよう、バイト列を読み込んで、サンプルから生成した六つの派生画像すべてを確認します。
(
set -e
for width in 480 960 1440; do
for format in webp jpg; do
file="web-images/hero.jpg/$width.$format"
printf '%s: ' "$file"
magick "$format:-" -format '%m %wx%h\n' info: < "$file"
done
done
)
WEBP 480x320 と JPG 480x320 に続き、960x640 と 1440x960 でも同じ形式が表示されることを確認してください。出力画像も開き、両方の色の領域と画像の両端が残っていることを確認してください。独自の画像では、向き、端に近い被写体、透明だった部分の白い背景を確認します。これらは寸法だけでは確認できません。
生成したファイルをレスポンシブなページで使う
次の完全なドキュメントを web-images/preview.html として保存してください。実際のサンプル出力を参照しているので、そのファイルをブラウザーで直接開きます。このローカル画像プレビューにサーバーは不要です。
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Responsive image preview</title>
<style>
body { margin: 0; }
img { display: block; width: 100%; max-width: 960px; height: auto; }
</style>
<picture>
<source type="image/webp"
srcset="hero.jpg/480.webp 480w, hero.jpg/960.webp 960w, hero.jpg/1440.webp 1440w"
sizes="(max-width: 960px) 100vw, 960px">
<img src="hero.jpg/960.jpg"
srcset="hero.jpg/480.jpg 480w, hero.jpg/960.jpg 960w, hero.jpg/1440.jpg 1440w"
sizes="(max-width: 960px) 100vw, 960px"
width="1440" height="960" alt="Blue and red halves of a sample image">
</picture>
</html>
picture と srcset の規則により、WebP に対応するブラウザーは最初のソースから画像を選択できます。img は JPEG の候補とデフォルトの src を提供します。各 w 記述子は、ファイルの実際のピクセル幅を表します。sizes は表示幅を示し、CSS の上限である 960 ピクセルと一致しています。独自のページに組み込む際は、パス、代替テキスト、width/height 比、sizes を変更してください。特殊文字を含むファイル名は URL エンコードします。photo%03d.jpg というディレクトリ名は、URL 内では photo%2503d.jpg/480.webp にする必要があります。
選択されたファイルを確認するには、ブラウザーの開発者コンソールを開き、次を実行してください。
document.querySelector('img').currentSrc
狭いビューポートでページを新たに読み込み、次に広いビューポートでも試してください。デバイスピクセル比とブラウザーの選択方針も、選択結果に影響します。読み込み済みのページをリサイズしても、キャッシュされた大きな画像が使われ続ける場合があります。一時的なコピーから source 要素を削除すると、同じブラウザーで JPEG の選択を確認できます。WebP の URL が壊れていても、JPEG の代替画像が自動的に選択されるわけではありません。
マークアップをウェブサイトに移す際は、派生画像一式をまとめて保持してください。このローカルプレビューでは、ファイルの生成とブラウザーによる選択を確認できます。読み込み時間や帯域幅の改善を確かめる必要がある場合は、実際のページで測定してください。
