ICNS ファイルとは?
ICNS ファイルは、アプリケーションのアイコンリソースを格納する Apple のコンテナです。macOS で使用する、サイズ、解像度、ピクセル表現の異なる複数のアイコンを格納できます。
ICNS ファイルの仕組み
ICNS ファイルは、表示サイズやピクセル密度が異なる、単一の macOS アイコンの各種表現をまとめます。Pillow の読み込み処理では、ファイルの先頭に四バイトの icns と、ビッグエンディアンの全体長があり、その後に要素が続きます。各要素の先頭には、四文字の型コードと長さがあります。型コードは表現を識別します。たとえば、ic07 は
128 ポイントのアイコン、ic10 は
2x スケールの 512 ポイントのアイコンです。Apple のツールは、ポイントサイズとスケールに基づく名前の PNG を格納した、拡張子が .iconset のフォルダーからファイルを作成します。iconutil コマンドで、そのフォルダーと ICNS ファイルを相互に変換できます。Apple のアーカイブにある 2012 年のガイドによると、Xcode 4.4 はプロジェクトのビルド時に、プロジェクト内の iconset フォルダーを自動変換します。バンドルの Info.plist では、CFBundleIconFile キーでアイコンファイルを指定します。
要点
- ファイルにはどのサイズを含めるのでしょうか?Apple の iconset 規約では、五つのポイントサイズ(16、32、128、256、512)を、それぞれ標準スケールと
@2xスケールで使用します。そのため、最大の画像は幅 1024、高さ 1024 ピクセルで、名前はicon_512x512@2x.pngです。すべてを揃える必要はありません。Apple のガイドによると、提供されていないサイズについては、システムが最適な表現を選択します。また、icon_16x16@2x.pngとicon_32x32.pngはピクセル数が同じでも、画面上の表示サイズが異なり、必要な細部の表現も異なる場合があるため、同等ではないとしています。このガイドは 2012 年のもので、Apple のドキュメントアーカイブにあります。 - 各要素には何が入っているのでしょうか?型コードによって異なるため、パーサーは複数のペイロード形式を扱う必要があります。Pillow の読み込み処理では、
ic07からic14までと、icp4からicp6までの要素に、それぞれ完全な PNG または JPEG 2000 画像が格納されています。一方、is32やil32などの古い型には、生データまたはランレングス符号化された RGB データが格納されます。アルファチャンネルは、s8mkやl8mkなどの、独立した 8 ビットのマスク要素に格納されます。これは、ICNS ファイルを画像ソースとして再利用するツールで重要です。electron-builder のドキュメントによると、別のプラットフォーム用アイコンのソースが ICNS ファイルの場合、埋め込まれた最大の PNG フレームを抽出します。あるユーザーは、ツールのアイコンコンバーターが変更された後、Linux ビルドが「Could not extract a PNG frame from ICNS file」というメッセージで停止したと報告し、Linux ビルド用に PNG を指定して回避しました。この報告では、ファイル内の何が失敗の原因だったかは明らかになっていません。その後、メンテナーは、コンバーターの新しいリリースで修正されるはずだと述べています。 - 作成や内容の確認はどうすればよいのでしょうか?macOS では、
iconutil -c icnsで.iconsetフォルダーを ICNS ファイルに変換し、iconutil -c iconsetで ICNS ファイルを元の PNG 群に戻せます。Apple のガイドでは、iconset の画像は正方形で、寸法がファイル名と一致する必要があるとしています。macOS 以外でも、Pillow はバージョン 8.3.0 以降、どのオペレーティングシステムでも ICNS ファイルを書き込めます。書き込み処理では、append_imagesで渡されていない各サイズについて、保存対象の画像をそのサイズの正方形に拡大縮小します。保存コードは、ソースが正方形かどうかや、幅が 1024 ピクセルかどうかを確認しません。append_images内の画像はピクセル幅で照合するため、ピクセルサイズが同じ二つの要素は一つの画像を共有します。書き込むのはic07からic14までの要素のみで、幅は 32 から 1024 ピクセルです。32 ピクセルの画像は、2x スケールの 16 ポイントのアイコンとして格納されます。標準スケールの 16 ポイントおよび 32 ポイントのアイコン用の要素はありません。Apple のガイドでは、まず大きなアイコンをデザインし、その後で縮小方法を決め、表示サイズやピクセル密度に応じて必要な調整を加えることを推奨しています。
ICNS ファイルが重要になる場面
ICNS ファイルは、クロスプラットフォームのパッケージングツールなどを使い、Xcode のアセットパイプライン外で
macOS アプリケーションバンドルを組み立てる際に重要です。自分でファイルを作成する必要はない場合もあります。electron-builder のドキュメントによると、作成済みの .icns ファイルをそのまま使用できるほか、PNG または SVG のソースを変換し、その単一の入力からすべてのサイズを生成できます。ツールがファイルを必要とする場合や、サイズごとにアートワークを調整したい場合は、独自のファイルを用意してください。一方、Xcode では、Apple の現行ドキュメントは、アセットカタログまたは Icon Composer ファイルを通じてアプリアイコンを指定するよう案内しています。Apple のアーカイブ済みの 2012 年のガイダンスでは、すべてのサイズを揃えることを推奨していますが、必須とはしていません。省略したサイズについては、macOS が利用可能な表現の中から最適なものを選ぶため、別のサイズ向けに描かれたアートワークが表示されます。
出典
- Apple ドキュメントアーカイブ:高解像度向けの最適化(iconset のサイズ、iconutil、Xcode による変換)
- Apple:情報プロパティリストの CFBundleIconFile キー
- Apple:アセットカタログを使ったアプリアイコンの設定
- Apple:Icon Composer を使ったアプリアイコンの作成
- Pillow ソース:IcnsImagePlugin.py(ICNS の要素型とペイロード)
- Pillow ハンドブック:ICNS の読み込みと保存
- electron-builder ドキュメント(v26):アイコンと画像(受け付けるアイコン入力、ICNS 変換)
- electron-builder の課題 9876:ICNS ファイルから PNG フレームを抽出できない