Английская Википедия:Apple Icon Image format

Шаблон:Short description Шаблон:Use mdy dates Шаблон:Infobox file format The Apple Icon Image format (.icns) is an icon format used in Apple Inc.'s macOS. It supports icons of 16 × 16, 32 × 32, 48 × 48, 128 × 128, 256 × 256, 512 × 512 points at 1x and 2x scale, with both 1- and 8-bit alpha channels and multiple image states (example: open and closed folders). The fixed-size icons can be scaled by the operating system and displayed at any intermediate size.

As of macOS 11, asset catalogs are the preferred file format for macOS custom icons instead.^[1]

File structure

The file format consists of an 8 byte header, followed by any number of icons.

Header

Offset	Size	Purpose
0	4	Magic literal, must be "icns" (0x69, 0x63, 0x6e, 0x73)
4	4	Length of file, in bytes, msb first

Icon data

Offset	Size	Purpose
0	4	Icon type, see OSType below.
4	4	Length of data, in bytes (including type and length), msb first
8	Variable	Icon data

Icon types

OSType	Length (bytes)	Size (pixels)	Supported OS Version	Description
Шаблон:Mono	128	32×32	1.0	1-bit mono icon
Шаблон:Mono	256	32×32	6.0	1-bit mono icon with 1-bit mask
Шаблон:Mono	48	16×12	6.0	1 bit mono icon with 1-bit mask
Шаблон:Mono	96	16×12	7.0	4 bit icon
Шаблон:Mono	192	16×12	7.0	8 bit icon
Шаблон:Mono	64	16×16	6.0	1-bit mono icon with 1-bit mask
Шаблон:Mono	128	16×16	7.0	4-bit icon
Шаблон:Mono	256	16×16	7.0	8 bit icon
Шаблон:Mono	variesШаблон:Sup (768)	16×16	8.5	24-bit RGB icon
Шаблон:Mono	256	16×16	8.5	8-bit mask
Шаблон:Mono	512	32×32	7.0	4-bit icon
Шаблон:Mono	1024	32×32	7.0	8-bit icon
Шаблон:Mono	variesШаблон:Sup (3072)	32×32	8.5	24-bit RGB icon
Шаблон:Mono	1024	32×32	8.5	8-bit mask
Шаблон:Mono	576	48×48	8.5	1-bit mono icon with 1-bit mask
Шаблон:Mono	1152	48×48	8.5	4-bit icon
Шаблон:Mono	2304	48×48	8.5	8-bit icon
Шаблон:Mono	variesШаблон:Sup (6912)	48×48	8.5	24-bit RGB icon
Шаблон:Mono	2304	48×48	8.5	8-bit mask
Шаблон:Mono	variesШаблон:Sup (49152 + 4)Шаблон:Sup	128×128	10.0	24-bit RGB icon
Шаблон:Mono	16384	128×128	10.0	8-bit mask
Шаблон:Mono	varies	16x16	10.7	JPEG 2000 Шаблон:Sup or PNG Шаблон:Sup format or 24-bit RGB icon^[2]
Шаблон:Mono	varies	32x32	10.7	JPEG 2000 Шаблон:Sup or PNG Шаблон:Sup format or 24-bit RGB icon^[2]
Шаблон:Mono	varies	48x48	10.7	JPEG 2000 Шаблон:Sup or PNG Шаблон:Sup format
Шаблон:Mono	varies	128x128	10.7	JPEG 2000 or PNG format
Шаблон:Mono	varies	256x256	10.5	JPEG 2000 or PNG format
Шаблон:Mono	varies	512x512	10.5	JPEG 2000 or PNG format
Шаблон:Mono	varies	1024x1024	10.7	JPEG 2000 or PNG format (512x512@2x "retina" in 10.8)
Шаблон:Mono	varies	32x32	10.8	JPEG 2000 or PNG format (16x16@2x "retina")
Шаблон:Mono	varies	64x64	10.8	JPEG 2000 or PNG format (32x32@2x "retina")
Шаблон:Mono	varies	256x256	10.8	JPEG 2000 or PNG format (128x128@2x "retina")
Шаблон:Mono	varies	512x512	10.8	JPEG 2000 or PNG format (256x256@2x "retina")
Шаблон:Mono	variesШаблон:Sup (1024)	16x16		ARGB or JPEG 2000 Шаблон:Sup or PNG Шаблон:Sup format
Шаблон:Mono	variesШаблон:Sup (4096)	32x32		ARGB or JPEG 2000 Шаблон:Sup or PNG Шаблон:Sup format (16x16@2x "retina")
Шаблон:Mono	variesШаблон:Sup (1296)	18x18		ARGB or JPEG 2000 Шаблон:Sup or PNG Шаблон:Sup format
Шаблон:Mono	varies	36x36		JPEG 2000 or PNG format (18x18@2x "retina")
Шаблон:Mono	varies	24x24		JPEG 2000 or PNG format
Шаблон:Mono	varies	48x48		JPEG 2000 or PNG format (24x24@2x "retina")

Шаблон:Sup The value inside the parenthesis is the uncompressed length for ARGB and 24-bit RGB icons.
Шаблон:Sup Шаблон:Mono data always starts with a header of four zero-bytes (tested all icns files in macOS 10.15.7 and macOS 11). Usage unknown, the four zero-bytes can be any value and are quietly ignored.
Шаблон:Sup These formats are supported in standalone icns files but do not display properly if used as application icon inside a Шаблон:Mono package.

Image data format

Mono icons with alpha mask can display three colors: white, black, and transparent.
The 4-bit an 8-bit icons use a fixed color palette with 16 colors and 256 colors, respectively.
The 24-bit RGB format consists of the three compressed channels tightly packed (see Compression). The Шаблон:Mono icon must start with a four-byte header, see footnote above.
The ARGB format consists of the ascii values for 'ARGB' and the four compressed channels tightly packed (see Compression).

Compatibility

the ARGB fields also accept files in PNG format – but not vice versa, you can not put ARGB images in any of the PNG-only fields (tested on macOS 11).
ARGB images are only supported in macOS 11 and newer – macOS 10.15.7 does not display ARGB images. Yet, even the ARGB keys can be displayed on macOS 10.15 if you set a JPEG 2000 or PNG image (see footnote on usage in app packages above).
The 24-bit RGB icons (Шаблон:Mono, Шаблон:Mono, Шаблон:Mono, Шаблон:Mono) also allow images in JPEG 2000 and PNG format (tested on macOS 10.15.7 and macOS 11).
The support for newer image types seems to be introduced later than the key field (see previous two points). Therefore, the supported OS version may not be accurate or adjusted based on file format.

Other types

OSType	Description
Шаблон:Code	"Table of Contents" a list of all image types in the file, and their sizes (added in Mac OS X 10.7). A TOC is written out as an identifier (4 bytes) and size (4 bytes). Each subsequent record (8 bytes each) maps to the icon formats found in the file. The data isn't included in this phase.
Шаблон:Code	4-byte big endian float - equal to the bundle version number of Icon Composer.app that created the icon
Шаблон:Code	Usage unknown (all tested files use either "icon"^[3] or "template"^[4]).
Шаблон:Code	Info binary plist. Usage unknown (only name field seems to be used).
Шаблон:Code	Nested "template" icns file. Usage unknown.
Шаблон:Code	Nested "selected" icns file. Usage unknown.
Шаблон:Nowrap	Nested "dark" icns file. Allows automatic icon switching in Dark mode. (added in macOS 10.14). Note: The contents of this record is a full .icns file with multiple formats. If the record bytes are written out to disk, the icns file header and file size are still required to see the full dark mode icon.

The table of contents is a list of all contained types (4 byte type-name + 4 byte length).
The data for all nested icns files does not contain the icns file-header. So, if you want to save the data to a file you have to prepend the icns header.

Non-PNG / JPEG2000 Element Types

Element types that deal with ARGB (32-bit) or RGB (24-bit) image formats require different types of headers before the binary data. It is important to note that this header is part of the image data and is not the 4-byte big endian icon element type value (e.g. ic04 or ic05).^[5]

ARGB Elements ARGB images must have their binary portion of the image data preceded by the four byte 'ARGB' header. After that, instead of each pixel with each of its four channels stored together (e.g. ARGBARGBARGB), an image with three pixels would be stored in individual channels of pixel data (e.g. AAARRRGGGBBB). In addition, each channel of pixel data needs to be encoded as mentioned below.

RGB Elements RGB images have their binary portion of the image data preceded by four zero byte characters only when the element type is 'it32'. In all other cases, no header is needed. Channel data is separated as with the ARGB binary data (e.g. RRRGGGBBB instead of RGBRGBRGB). Each channel must also be encoded as mentioned below.

Mask Elements Mask elements are not encoded like ARGB and RGB image color channel data. The data is the same as that of an ARGB image except only the alpha channel data is provided. So for an image that has two pixels, ARGBARGB, the mask data is AA.

Compression

lead Шаблон:Small	tail Шаблон:Small	result Шаблон:Small
Шаблон:Small	Шаблон:Small	Шаблон:Small bytes
Шаблон:Small	Шаблон:Small byte	Шаблон:Small copies

Over time the format has been improved and there is support for compression of some parts of the pixel data. The 24-bit RGB (Шаблон:Mono, Шаблон:Mono, Шаблон:Mono, Шаблон:Mono, Шаблон:Mono, Шаблон:Mono) and ARGB (Шаблон:Mono, Шаблон:Mono, Шаблон:Mono) pixel data are compressed (per channel) with a format similar to PackBits.^[6] Some sources mention that the OS supports both compressed or uncompressed data chunks.Шаблон:Cn However, manually crafting icns files with uncompressed 24-bit RGB or ARGB images will not display properly – at least on newer macOS releases (tested on macOS 11).

Here is a GitHub repo with some swift code that appears to pass the test for both encoding and decoding as described here: ByteRunLengthCoder

The following pseudocode decompresses the data: Шаблон:Pre Example: Шаблон:Code should decompress to Шаблон:Code

The following pseudocode compresses the data: Шаблон:Pre Example: Шаблон:Code should compress to Шаблон:Code

Known issues

As of macOS 11, there are certain issues / bugs with the file format:

Setting Шаблон:Mono or Шаблон:Mono will display a proper icon. But setting Шаблон:Mono ignores the transparency mask and displays an icon without transparency.
Compressed ARGB data is not interpreted correctly. The last value of the blue channel (aka. the very last value) is ignored and treated as if it were all zero-bytes. Usually this is no issue since most icons will have transparency at the bottom right corner anyway. However, it can become an issue if the last value is a repeating byte (see Compression). Potentially, up to 130 pixels can lack the blue channel value.
A workaround is to append an additional byte at the end which is interpreted as a control character without following data. You can compare the difference with these two examples:
- Шаблон:Code
- Шаблон:Code
macOS 10.15.7 (likely earlier) and later versions have an issue displaying PNG and JPEG 2000 icons for the keys Шаблон:Mono (16x16), Шаблон:Mono (32x32), and Шаблон:Mono (64x64). The keys work fine in a standalone icns file but if used in an application, the icons are displayed completely scrambled. Either use the new ARGB format Шаблон:Mono and Шаблон:Mono (macOS 11+) or the old 24-bit RGB + alpha mask format. Use the latter with the old keys Шаблон:Mono and Шаблон:Mono, or with the newer keys Шаблон:Mono and Шаблон:Mono (writing RGB data into PNG fields^[2]). If using ARGB image data, make sure to provide alternative formats for macOS 10.15 and earlier. This issue is especially tricky to detect if you provide both, 16x16 and 16x16@2x icons, because if you connect your Mac to a non-retina monitor, the non-retina 16x16 icon will be used and thus the icon will be displayed scrambled. The Шаблон:Mono field does not seem to be used in application icons and can safely be ignored. Additionally, if you don't provide the smaller icon sizes at all the bug will also manifest when the OS scales down your larger PNG/JPEG 2000 icons, so make sure to render smaller sizes and include them.

Support

Various image viewers can load *.icns files, and free and open source converters from or to PNG also exist.^[7]^[8] GTK+ can load *.icns resources since 2007.^[9] Other tools supporting the format include the Apple Icon Composer and icns Browser, The Iconfactory, and IconBuilder.
MacOSШаблон:Clarify offers the built-in iconutil command line tool to pack and unpack *.icns files.

References

External links

IconFamily (last update 2013) – Open source Objective C class to read and write Apple icns files
osxiconutils (not maintained) – Command line tools to work with Apple icns files
icnsutil – Python library to read and write icns files
icns - Rust crate to read and write icns files
createicns - C library to read and write icns files
icon_records_extractor - C library to extract all icns records as their own icons include dark mode icns.

Шаблон:Mac OS X Шаблон:Graphics file formats

[1] Шаблон:Cite web

[rgb-icp4-2] 2,0 ^2,1 ^2,2 Шаблон:Citation

[3] Шаблон:Citation

[4] Шаблон:Citation

[5] Fiahfy ICNS Repo

[macdisk-6] Macintosh Icons

[7] Шаблон:Cite web

[8] Шаблон:Cite web

[9] Шаблон:Cite web

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]

[9]

Партнерские ресурсы
Криптовалюты	Обмен криптовалют - www.bestchange.ru Криптовалютная биржа CoinEx Криптовалютная биржа Binance HIVE OS - операционная система для майнинга e4pool - Мультивалютный пул для майнинга.
Магазины	AliExpress — глобальная виртуальная (в Интернете) торговая площадка, предоставляющая возможность покупать товары производителей из КНР; computeruniverse.net - Интернет-магазин компьютеров(Промо код 5 Евро на первую покупку:FWWC3ZKQ);
Хостинг	DigitalOcean - американский провайдер облачных инфраструктур, с главным офисом в Нью-Йорке и с центрами обработки данных по всему миру;
Разное	Викиум - Онлайн-тренажер для мозга Like Центр - Центр поддержки и развития предпринимательства. Gamersbay - лучший магазин по бустингу для World of Warcraft. Ноотропы OmniMind N°1 - Усиливает мозговую активность. Повышает мотивацию. Улучшает память. Санкт-Петербургская школа телевидения - это федеральная сеть образовательных центров, которая имеет филиалы в 37 городах России. Lingualeo.com — интерактивный онлайн-сервис для изучения и практики английского языка в увлекательной игровой форме. Junyschool (Джунискул) – международная школа программирования и дизайна для детей и подростков от 5 до 17 лет, где ученики осваивают компьютерную грамотность, развивают алгоритмическое и креативное мышление, изучают основы программирования и компьютерной графики, создают собственные проекты: игры, сайты, программы, приложения, анимации, 3D-модели, монтируют видео. Умназия - Интерактивные онлайн-курсы и тренажеры для развития мышления детей 6-13 лет SkillBox - это один из лидеров российского рынка онлайн-образования. Среди партнеров Skillbox ведущий разработчик сервисного дизайна AIC, медиа-компания Yoola, первое и самое крупное русскоязычное аналитическое агентство Tagline, онлайн-школа дизайна и иллюстрации Bang! Bang! Education, оператор PR-рынка PACO, студия рисования Draw&Go, агентство performance-маркетинга Ingate, scrum-студия Sibirix, имидж-лаборатория Персона. «Нетология» — это университет по подготовке и дополнительному обучению специалистов в области интернет-маркетинга, управления проектами и продуктами, дизайна, Data Science и разработки. В рамках Нетологии студенты получают ценные теоретические знания от лучших экспертов Рунета, выполняют практические задания на отработку полученных навыков, общаются с экспертами и единомышленниками. Познакомиться со всеми продуктами подробнее можно на сайте https://netology.ru, линейка курсов и профессий постоянно обновляется. StudyBay Brazil – это онлайн биржа для португалоговорящих студентов и авторов! Студент получает уникальную работу любого уровня сложности и больше свободного времени, в то время как у автора появляется дополнительный заработок и бесценный опыт. Автор24 — самая большая в России площадка по написанию учебных работ: контрольные и курсовые работы, дипломы, рефераты, решение задач, отчеты по практике, а так же любой другой вид работы. Сервис сотрудничает с более 70 000 авторов. Более 1 000 000 работ уже выполнено. StudyBay – это онлайн биржа для англоязычных студентов и авторов! Студент получает уникальную работу любого уровня сложности и больше свободного времени, в то время как у автора появляется дополнительный заработок и бесценный опыт.

Английская Википедия:Apple Icon Image format

Содержание