PHP と ImageMagick によるコンテンツに応じたリサイズ
Imagick::liquidRescaleImage() を使うと、すべてのオブジェクトを一律に引き伸ばさずに、画像の縦横比を変更できます。この手順では、PHP でローカル画像から 400 × 300 の JPEG を生成します。シームカービングは被写体の周囲の余白を取り除けますが、被写体自体が変形することもあります。
コンテンツに応じたリサイズとは?
コンテンツに応じたリサイズ(シームカービング)は、シームと呼ばれる連続したピクセルの経路を削除または挿入する処理です。視覚的な変化が少ない経路を優先します。単調な背景にある質感豊かな物体は、背景が縮んでも形状を保つ場合があります。一方、複雑な背景にある滑らかな顔は、逆に変形することがあります。アルゴリズムは、どの物体が重要かを認識しません。
前提条件
以下の構成は、Debian 13、PHP 8.4、Imagick 3.8、ImageMagick 7 を対象としています。検証に使用したバージョンは PHP 8.4.26、Imagick 3.8.0、ImageMagick 7.1.1-43、liblqr 0.4.2 です。これらのバージョン系列内で、ディストリビューションが保守する更新版を使用してください。パッチ番号は検証時の構成を示すもので、必須の最低バージョンではありません。PHP 8.4 はサポート対象です。
Debian 13 で root として、CLI と拡張機能のパッケージをインストールします。
apt-get update &&
apt-get install -y --no-install-recommends php8.4-cli php8.4-imagick imagemagick liblqr-1-0
Debian では php8.4-imagick が提供されています。この例では、書き込み可能な作業ディレクトリにある input.jpg という名前の、信頼できる破損のない単一フレームの RGB JPEG を使用します。元の画像は残しておいてください。アップロードの検証、アニメーション、カラープロファイルの変換は、このローカル CLI の例では扱いません。
追加の前提条件
liblqr をインストールするだけでは不十分です。PHP の Imagick 拡張機能がリンクする ImageMagick ライブラリも、liblqr を組み込んでビルドされている必要があります。スクリプトを保存する前に、PHP 自体から動作をテストします。
php -r '
$im = new Imagick();
$im->newImage(16, 16, "white");
$im->liquidRescaleImage(12, 16, 1, 0);
echo "Liquid rescale available\n";
'
正常終了し、Liquid rescale available が表示された場合にのみ先へ進んでください。拡張機能やデリゲートがない場合は、このメッセージが表示される前に失敗します。インストールやこの確認に失敗した場合は、前提条件を満たすよう修正し、該当する手順を繰り返してください。この時点では、記事の出力ファイルはまだ作成されていません。
PHP で liquid rescale を使う方法
次のコードを resize.php として、input.jpg と同じディレクトリに保存します。指定する縦横のサイズはピクセル単位です。必要な出力サイズに合わせて変更してください。
<?php
$image = new Imagick();
try {
$image->readImage('input.jpg');
$targetWidth = 400;
$targetHeight = 300;
$deltaX = 1; // Maximum sideways step of a seam
$rigidity = 0; // Penalty for bending a seam
$image->liquidRescaleImage($targetWidth, $targetHeight, $deltaX, $rigidity);
$image->writeImage('output.jpg');
printf("Saved output.jpg (%d x %d)\n", $image->getImageWidth(), $image->getImageHeight());
} catch (ImagickException $e) {
fwrite(STDERR, "Image resizing failed.\n");
$failed = true;
} finally {
$image->clear();
}
if (isset($failed)) {
exit(1);
}
そのディレクトリで実行します。
php resize.php
正常に実行されると、Saved output.jpg (400 x 300) が表示され、400 × 300 の JPEG が書き込まれます。元の画像と並べて開いてください。寸法から目的のサイズになったことは確認できますが、被写体の保持までは確認できません。正常に実行されると output.jpg が置き換えられます。ImagickException が発生すると、スクリプトはステータス 1 で終了し、古い出力がそのまま残る場合があります。ファイルを使用する前に終了ステータスを確認してください。
パラメーターの微調整
liquid rescale の処理は、主に次の二つのパラメーターで制御します。
- deltaX:シームが横方向に移動する最大幅です。ゼロでは直線のシームになり、値を大きくすると、画像の内容を避けてシームが移動する自由度が増します。
- rigidity:シームの曲がりに対する非負のペナルティーです。ゼロではペナルティーを加えず、値を大きくすると、より直線的なシームを優先します。顔などの重要な特徴の保持を保証するものではありません。
これらの意味は、Imagick のパラメータードキュメントに基づいています。値を選ぶ際は、代表的な画像で結果を確認してください。
パフォーマンスの考慮事項
元の画像が大きい場合は、先に通常のリサイズを行い、シームカービングに渡すピクセル数を減らせます。この別バージョンを resize-small.php として保存します。大きすぎる入力をアスペクト比を維持したまま 800 × 600 以内に収めてから、シームカービングで 400 × 300 にします。小さい入力では最初のリサイズを省略します。この条件分岐がないと、bestfit: true が小さい入力を拡大する場合があります。詳しくは resizeImage のドキュメントを参照してください。
<?php
$image = new Imagick();
try {
$image->readImage('input.jpg');
if ($image->getImageWidth() > 800 || $image->getImageHeight() > 600) {
$image->resizeImage(800, 600, Imagick::FILTER_LANCZOS, 1, true);
}
$image->liquidRescaleImage(400, 300, 1, 0);
$image->writeImage('optimized-output.jpg');
printf("Saved optimized-output.jpg (%d x %d)\n", $image->getImageWidth(), $image->getImageHeight());
} catch (ImagickException $e) {
fwrite(STDERR, "Image resizing failed.\n");
$failed = true;
} finally {
$image->clear();
}
if (isset($failed)) {
exit(1);
}
php resize-small.php
成功すると Saved optimized-output.jpg (400 x 300) が表示されます。出力の置き換えと失敗時の動作は、最初のスクリプトと同じです。最初のリサイズでは被写体も縮小するため、二つの出力は見た目が異なる場合があります。収めた画像の幅が 400 ピクセル未満、または高さが 300 ピクセル未満の場合、最後の処理でその寸法が拡大されます。このトレードオフを選ぶ前に結果を比較してください。処理の高速化や品質の向上を保証するものではありません。
よくある問題と解決策
メモリ割り当てエラー
PHP の memory_limit では、ImageMagick のネイティブなメモリ割り当てを確実には制限できません。ワークロードに合わせて、メモリ、ディスクキャッシュ、寸法、処理時間などのリソース制限とセキュリティポリシーを ImageMagick に設定してください。同じ大きすぎる画像を無限に再試行するのではなく、リソース制限による失敗を明示してください。
Liblqr 対応の欠如
拡張機能がリンクしているバージョンを、次のコマンドで確認します。
php --ri imagick
単体の ImageMagick CLI は、別のビルドを使用している場合があります。magick や ImageMagick 6 の convert にデリゲートが表示されても、PHP から使用できる証拠にはなりません。互換性のあるビルドをインストールしたら、「追加の前提条件」にある PHP の処理を再実行してください。古いライブラリを使用している長時間稼働中の PHP ワーカーは再起動してください。保存したスクリプトは、liquid rescale の呼び出しに失敗すると
Image resizing failed. を報告し、終了コード 1 で終了します。
品質の保持
JPEG のデコードでは、破損したファイルの一部を復元し、出力を生成する場合があります。これらのスクリプトは入力の完全性を検証しません。破損のない元画像を使用し、下端も含めて結果全体を確認してください。
顔、文字、直線的な輪郭、繰り返しパターンを確認してください。ImageMagick のシームカービングの例では、背景が複雑な場合に、アルゴリズムが背景ではなく前景のピクセルを削除する理由を説明しています。rigidity を高くしても、シャープ化を行っても、特定の被写体を保護することはできません。形状が重要な写真では、縦横比を維持したリサイズや明示的な切り抜きと比較し、必要な内容を保持できる結果を選んでください。
まとめ
一括処理に適用する前に、実際のワークロードから数枚の画像を選び、スクリプトを試してください。ホスト型の画像リサイズやフォーマット変換については、Transloadit の画像処理 APIをご覧ください。
