失敗を隠さずに jpegtran で JPEG を一括最適化
jpegtran を使うと、非可逆圧縮を再度行わずに、既存の JPEG のエンコード方式を変更できます。ローカルで一括処理する際は、新しいディレクトリに書き込み、すべての変換の終了ステータスを確認します。以下の Bash スクリプトは元の画像とメタデータを保持し、プログレッシブ JPEG を作成します。選択した画像のいずれかで処理に失敗すると、失敗を示すステータスを返します。
保持する情報の選択
jpegtran は、ピクセルをデコードして再圧縮するのではなく、圧縮された DCT 係数を処理します。これにより既存の JPEG の画像データを保持しますが、最初のエンコードで失われた細部は復元できません。この違いは libjpeg-turbo の使用ガイドで説明されています。
このワークフローでは、ハフマン符号化に -optimize を、複数回の画像スキャンに -progressive を使用します。対応ビューアーでは、プログレッシブ JPEG 全体の受信前に初期プレビューを表示できます。どちらのフラグもファイルサイズの縮小を保証しないため、アセットを置き換える前にバイト数を比較してください。
メタデータの保持方針には -copy all を使用し、EXIF や ICC プロファイルを含む追加マーカーを保持します。EXIF の向き情報とカラープロファイルはビューアーでの画像表示に影響するため、重要です。ただし、GPS 座標などの機密性のある情報も保持されます。これらの出力はローカルでの確認用であり、自動的に公開アップロードするためのものではありません。
-copy none を使用すると、これらのマーカーが破棄されます。係数は保持されても、表示時の向きや色が変わる可能性があります。-copy icc はカラープロファイルを保持しますが、EXIF の向き情報は削除します。メタデータの削除が必要な場合は、別のワークフローを選んでください。この一括処理では、ピクセルの回転や向きの正規化は行いません。マーカーのコピーオプションを参照してください。
ツールの確認
Linux 上で Bash と libjpeg-turbo の jpegtran を使用します。一般的なユーティリティである mkdir、mv、rm、wc も必要です。この例は Bash 5.3.15 と libjpeg-turbo 3.2.0 でテストしています。ディストリビューション、またはプロジェクトのリリースパッケージから
libjpeg-turbo のコマンドラインツールをインストールし、使用している実装を確認してください。
bash --version
jpegtran -version
2 番目のコマンドでは、libjpeg-turbo であることが表示されるはずです。ほかのプロジェクトも jpegtran という名前のプログラムを配布しており、オプションや出力が異なる場合があります。ここでの入力対象は、シーケンシャル形式とプログレッシブ形式を含む、一般的な 8 ビットの DCT ベースの JPEG です。
新しいディレクトリへの一括処理
次のスクリプトを、JPEG があるディレクトリに optimize_images.sh として保存してください。sh ではなく Bash で実行します。拡張子が .jpg または .jpeg の通常ファイルを選択します。大文字の拡張子や隠しファイルも対象ですが、サブディレクトリは走査せず、シンボリックリンクもたどりません。空白、先頭のハイフン、リテラルの % 文字を含むファイル名に対応しています。
出力ディレクトリは、まだ存在していない必要があります。成功した各出力は、元のファイル名のまま optimized/ の下に保存されます。各変換結果は jpegtran が成功するまで一時ファイルに保持されるため、失敗した変換が完成済みの出力になることはありません。自身で管理しているディレクトリで実行し、一括処理中にほかのプロセスがファイルを変更しないようにしてください。
#!/usr/bin/env bash
set -u
if (( $# != 0 )); then
printf 'Run this script without arguments in your JPEG directory.\n' >&2
exit 2
fi
if ! command -v jpegtran >/dev/null; then
printf 'jpegtran is not installed or is missing from PATH.\n' >&2
exit 2
fi
shopt -s nullglob nocaseglob dotglob
images=()
for img in ./*.jpg ./*.jpeg; do
if [[ -f "$img" && ! -L "$img" ]]; then
images+=("$img")
fi
done
if (( ${#images[@]} == 0 )); then
printf 'No JPEG files selected.\n' >&2
exit 1
fi
if ! mkdir -- ./optimized; then
printf 'Cannot create optimized; move any previous results aside before rerunning.\n' >&2
exit 1
fi
temporary=./optimized/.jpegtran.tmp
trap 'rm -f -- "$temporary"' EXIT
trap 'exit 130' INT
trap 'exit 143' TERM
status=0
for img in "${images[@]}"; do
output="./optimized/${img#./}"
if jpegtran -strict -copy all -optimize -progressive -outfile "$temporary" "$img" &&
mv -- "$temporary" "$output"; then
printf 'Wrote %q\n' "$output"
else
printf 'Failed: %q\n' "$img" >&2
status=1
fi
done
exit "$status"
同じディレクトリから実行してください。
bash optimize_images.sh
終了ステータスがゼロなら、選択されたすべてのファイルの変換と出力先への移動が完了しています。-strict により、不正な画像や変換時の警告も失敗として扱われます。診断メッセージは表示されたままとなり、残りの画像の処理は継続しますが、最終ステータスはゼロ以外になります。成功と失敗が混在する一括処理でも、成功した出力は確認用に残ります。対象ファイルがない場合もゼロ以外を返し、出力ディレクトリは作成しません。
再実行時に optimized というディレクトリ、ファイル、シンボリックリンクが存在すると、処理を拒否し、既存のものは変更しません。再試行する前に、以前の結果を自分で確認し、別の場所に移してください。ビルドジョブでは、上記の呼び出しを、失敗したらデプロイを停止する処理として使用してください。|| echo ... を追加すると、その失敗が再び隠されてしまいます。これはローカルアセット用のワークフローであり、信頼できないアップロードを処理するサンドボックスではありません。
結果の測定
入力ファイル名が photo.jpg の場合、一括処理の成功後に 2 つのファイルを比較します。
wc -c -- ./photo.jpg ./optimized/photo.jpg
最初の 2 行は元のファイルと出力のバイト数で、最後の行はその合計です。一定の削減率が得られるわけではありません。小さな JPEG や最適化済みのファイルは、プログレッシブ形式でエンコードすると大きくなる場合があります。このスクリプトは、黙って元のファイルに差し替えるのではなく、その結果を確認用に保持します。代表的な画像の組を利用者が使うビューアーで開き、サイズに加えて向きと色も確認してください。デコードした画像データが一致していても、それだけではビューアーのメタデータ処理を検証できません。
失敗と -perfect の制約の理解
破損した JPEG や途中で切れた JPEG では、診断メッセージを確認し、元の画像を復旧してから再実行してください。何らかのデータが書き込まれたからといって、標準エラー出力を破棄したり、不完全なファイルを受け入れたりしないでください。出力ディレクトリを作成できない場合は、すでに存在していないか、親ディレクトリへの書き込み権限があるかを確認してください。
-perfect は幾何変換のチェックであり、追加の画質設定やファイルの完全性チェックではありません。この一括処理で行うエントロピー最適化とプログレッシブ変換には不要です。回転や反転では、端のブロックを完全に変換できない変換を拒否します。一般的な 4:2:0 サンプリングでは、iMCU は 16 × 16 ピクセルです。時計回りの 90 度回転では高さが、270 度回転では幅が、180 度回転では両方が 16 で割り切れる必要があります。サンプリング係数が異なると、これらの境界も変わります。これらの条件は libjpeg-turbo の変換コードに明記されています。
-trim は変換できない端のピクセルを破棄するため、クロップを選ぶことになります。-perfect が回転を拒否した後で、画像全体を保持するための手段ではありません。また、ピクセルを回転させる場合は、EXIF の向き情報とサムネイルの扱いを明確に決める必要があります。既存のメタデータをコピーしても、向きが自動修正されるわけではありません。
再エンコードを選ぶ基準
測定した削減量が小さすぎる場合、画像の寸法変更、JPEG の画質低下、WebP や AVIF への変換は別の作業です。これらを選ぶ場合は、適切な画像ツールでデコードとエンコードを行い、結果の見た目を評価する必要があります。既存の JPEG 画像データを保持することが条件なら、この jpegtran の一括処理を使用してください。画像データの変更を許容できる場合は、別の再エンコード用ワークフローを使用してください。
