CLI と Rust から Oxipng で PNG を最適化
Oxipng で元のファイルを残しながら PNG を圧縮するには、--out に別のファイル名を指定します。以下では、結果のプレビュー、最適化したコピーの保存、Rust からの同じ処理の実行を説明します。通常のアニメーションなしの PNG を使用し、任意の非可逆変換は無効のままにします。
PNG の可逆最適化では、デコード後のピクセル値を変えずに、圧縮、フィルタリング、パレット構成、色表現を変更できます。そのため、ファイルのハッシュが変わっても、画質が低下したとは限りません。ただし、すべてのメタデータが残った証拠にもなりません。アーカイブ用の原本が必要な場合は、元のファイルを保持してください。
Oxipng のインストール
これらの Bash の例は、Linux 上で Rust と Cargo 1.98.1、および Oxipng 10.2.1 を使って検証しました。PATH 上の Cargo、ネイティブ圧縮依存関係用の C コンパイラーとリンカー、および PATH に登録した Cargo のバイナリディレクトリが必要です。Oxipng 10.2.1 は、最小 Rust バージョンとして 1.88.0 を宣言しています。
cargo install oxipng --version 10.2.1 --locked &&
oxipng --version
バージョン確認コマンドでは oxipng 10.2.1 が表示されるはずです。別のバージョンが表示された場合は、続行する前にシェルが見つけるバイナリを確認してください。cargo install は、デフォルトでリリースモードでビルドします。--locked は、クレートに同梱された依存関係ロックファイルを使用します。
単一の PNG の最適化
PNG をカレントディレクトリに input.png として配置します。まず、何も書き込まずに最適化をプレビューします。
oxipng -o 4 --dry-run -v -- input.png
--dry-run でも最適化処理は実行されます。省略されるのは結果の書き込みだけです。バージョン 10 では、従来の --pretend フラグが置き換えられました。結果を別のファイルに保存してファイルサイズを比較するには、次のように実行します。
oxipng -o 4 -v --out optimized.png -- input.png &&
wc -c input.png optimized.png
この処理では input.png は変更されません。既存の optimized.png は、確認なしで置き換えられます。非対話的な再実行でも同様です。以前の出力を残す必要がある場合は、新しい保存先名を選んでください。保存先の親ディレクトリは、あらかじめ存在している必要があります。
プリセット 4 は開始点であり、サイズ削減を約束するものではありません。利用できるレベルは 0 から 6 までで、デフォルトは 2 です。高いプリセットほど探索に多くの処理を費やしますが、結果が小さくなる保証はありません。最適化済みの PNG では、サイズが減らない場合があります。この設定では、Oxipng が改善できない場合も元のバイト列を使い、別の出力ファイルを書き込みます。別の保存先を指定しない場合、この状況では入力ファイルを変更しません。
Oxipng は、デフォルトで利用可能な論理 CPU を使用します。共有マシンでワーカースレッド数を制限するには、--threads 4 を追加します。全オプションは、バージョン別 CLI マニュアルを参照してください。
保持する情報の選択
ここでは、保持対象として次の 3 種類を区別することが重要です。
| 設定 | 意味 |
|---|---|
--alpha なし | 完全に透明なピクセルも RGB 値を保持します。--alpha を追加すると、圧縮のためにこれらの見えない色を変更できます。見た目は変わりませんが、ピクセルデータは変わります。 |
--strip なし | 以下の例外を除き、最適化後も有効な PNG メタデータを保持します。 |
--preserve | ファイルシステムのアクセス許可と更新日時の保持を試みます。PNG メタデータは制御せず、アクセス日時も保持しません。 |
ライブラリのオプションも、デフォルトではアルファ最適化と、16 ビットから 8 ビットへの非可逆なスケーリングを無効にしています。ピクセル値の可逆性が必要な場合は、--scale16 を追加しないでください。
デフォルトのメタデータ保持は、アーカイブ用途の厳密な保持ではありません。Oxipng は、色タイプやビット深度の変更によって無効になった場合、bKGD、sBIT、hIST を削除します。また、デフォルトで C2PA の caBX と Apple の
iDOT チャンクも削除します。埋め込み ICC プロファイルは再圧縮される場合があります。これらの動作は、チャンク処理の実装と CLI マニュアルに記載されています。
--strip safe は、テキストや EXIF などの補助情報を破棄する場合にのみ使用してください。sRGB と pHYs など、一部の表示関連チャンクは保持しますが、すべてのメタデータの保持を約束するものではありません。--strip all はさらに広範囲に削除し、カラーマネジメント情報も削除する場合があるため、画像の表示が変わることがあります。ここで紹介する例では、どちらのオプションも不要です。
ファイルのアクセス許可と更新日時を保持しながら、意図的に入力を置き換える場合は、次のように実行します。
oxipng -o 4 --preserve -- input.png
これは元のファイルを直接変更する処理です。実行前にバックアップを保存してください。属性の保持はベストエフォートであり、属性を復元できない場合は Oxipng が警告します。
フォルダーの一括処理
置き換えてもよい PNG アセットのディレクトリでは、次のように実行します。
find ./images -type f -name '*.png' -exec oxipng -o 4 --preserve -- {} +
この処理は入れ子のディレクトリも走査し、空白を含むファイル名も安全に渡します。小文字の .png 拡張子に一致するファイルを直接変更し、再実行時も同じファイルを処理します。プレビューするには、Oxipng の引数に
--dry-run を追加します。元のファイルを保持する必要がある場合は、コピーしたアセットディレクトリを使用してください。
Rust コードへの Oxipng の組み込み
新しいプロジェクトを作成し、同じクレートバージョンに固定します。
cargo new --bin --vcs none png-optimize &&
cd png-optimize &&
cargo add oxipng@=10.2.1
成功したことを確認してから続行してください。png-optimize ディレクトリがすでに存在すると、cargo new は失敗します。既存のプロジェクトを削除せず、新しいプロジェクト名を選んでください。解決済みの依存関係のバージョンを維持するため、生成された Cargo.lock を保持します。
このプロジェクトディレクトリに、PNG のコピーを input.png として配置します。生成された src/main.rs を、次の完全なプログラムで置き換えます。
use oxipng::{optimize, InFile, Options, OutFile};
use std::path::PathBuf;
fn main() -> Result<(), oxipng::PngError> {
let input = InFile::Path(PathBuf::from("input.png"));
let output = OutFile::from_path(PathBuf::from("output.png"));
let options = Options::from_preset(4);
let (before, after) = optimize(&input, &output, &options)?;
println!("{before} -> {after} bytes: output.png");
Ok(())
}
png-optimize から、次のように実行します。
cargo run --release
このプログラムは、カレントディレクトリを基準に input.png を読み込み、output.png に書き込んで、optimize が返す入力と出力のバイト数を表示します。既存の output.png は、確認なしで置き換えられます。バイト数が同じでも有効な結果であり、失敗ではありません。
OutFile::from_path は、別のファイルを選択し、属性の保持は要求しません。ライブラリでドライランを行うには OutFile::None を使用します。入力のアクセス許可と更新日時を出力に引き継ぐ必要がある場合は、OutFile::Path { path: Some(PathBuf::from("output.png")), preserve_attrs: true } を使用します。
ビルドでの入力エラーの処理
入力が存在しない場合や不正な形式の場合、CLI は異常終了します。Rust の例も、PngError を ? 経由で伝播するため、異常終了し、成功時のバイト数を表示しません。input.png がない状態で一度実行すると、このエラー処理を確認できます。出力ディレクトリが存在しない場合や、書き込み権限のエラーがある場合も、処理が失敗することがあります。
出力ファイルを利用する前に、終了ステータスを確認してください。実行に失敗しても、以前の出力が残っている場合があります。また、最適化の成功とサイズの削減は別です。アセットのビルドでは、失敗をエラーとして扱い、一定のサイズ削減を必須とするのではなく、実際のバイト数を記録してください。
