Editing Icon

{{Infobox file format
| name = Icon file
| extension = .ico
| mime = image/vnd.microsoft.icon
| type code = 
| uniform type = com.microsoft.ico
| owner = Microsoft
| genre = graphics file format
}}
{{Infobox file format
| name = Cursor file
| extension = .cur
| mime = 
| owner = Microsoft
| genre = graphics file format
}}
{{Wikipedia|style=box|ICO (icon image file format)}}

The '''ICO file format''' is an image [[file format]] used for icons in [[Microsoft Windows]]. The '''CUR file format''' for cursors is almost identical, as the only differences are the identification byte and a specification of a hotspot in the [[header]].

ICO files contain one or more small images at multiple sizes and [[color depth]]s.

The official [[Internet Assigned Numbers Authority|IANA]] registered Internet media type for ico files is <code>image/vnd.microsoft.icon</code>. Before this was registered, <code>image/x-icon</code> was the accepted option that complied with the rules of using ''x-'' for unregistered tokens. However, many others are seen, including <code>image/ico</code>, <code>image/icon</code>, <code>text/ico</code>, and <code>application/ico</code>. Many [[web server]]s do not come configured with an Internet media type setting for .ico files, and may send their default Internet media type, which might be <code>text/html</code> or <code>text/plain</code>.

== Icon sizes, color depths, and transparency data ==
Originally 32×32 pixels square and using 16 colors, more recent versions of [[Microsoft Windows]] support icons at multiple sizes and [[color depth]]s. Prior to [[Windows XP]], icon images could be any size from 1×1 pixel up to 255×255 pixels (including non-square sizes), and 4-, 8-, 16-, or 24-bit color depth. Commonly an icon file would contain both 16x16 and 32x32 (for the start menu and folder "large icons" view) and 16x16 (for window title bars, submenus of the start menu and folder small icons, list and details views).

Icon image data was always made up of two [[bitmap]]s: the [[logical and|AND]] bitmap and the [[XOR]] bitmap. The AND bitmap is 1 bit per pixel and is applied first to decide which areas of the image are affected by the background. The XOR bitmap is then applied using XOR. This allows for [[transparency (graphic)|transparent]] areas in the image but also allows for inverting the background and other tricks.

[[Windows XP]] adds support for 32-bit color depth icon images, with transparency taken from the [[alpha channel]] of the image, allowing semitransparent areas like [[drop shadow|shadow]]s and [[anti-aliasing|anti-alias]]ed edges. As the AND bitmap is no longer used, these icon images contain only XOR bitmap data. Windows XP also adds the ability to display icons at up to 96×96 pixel resolution in the graphical shell; however, Microsoft only recommended icon sizes up to 48×48 pixels, so larger icon sizes are uncommon.

[[Windows Vista]] added support for 256×256 pixel icon images, and supports (but does not require) the [[data compression|compressed]] [[Portable Network Graphics|PNG]] format for that size. The PNG format encodes the image transparency data directly; it contains neither the XOR nor the AND bitmap data of the other icon image formats. It is recommended that all 256×256 icons should be stored in the ICO file in PNG format to reduce the overall size of the file. The Windows Vista graphical shell supports "zooming" the display in and out; as a result, more icon formats (including the larger, 256×256 format) are recommended.

ICO files can be edited or exported with a number of [[graphics program]]s.

== File structure ==
All values are represented in [[little-endian]] (Intel standard) format.

{| class="wikitable"
|-
| '''Icon Header'''
| Stores general information about the ICO file.
|-
| '''Directory[1..n]'''
| Stores general information about every image in the file.
|-
| '''Icon #1'''
| The actual "data" for the first image in old AND/XOR DIB format or newer PNG
|-
| '''...'''
| 
|-
| '''Icon #n'''
| Data for the last icon image
|}

=== Header ===
{{binary section
| size1 = 2 | desc1 = Reserved. Should always be 0.
| size2 = 2 | desc2 = Type: 1 is for icon, 2 is for cursor.
| size3 = 2 | desc3 = Number of images in the file.
}}

=== Directory ===
{{binary section
| size1 = 1 | desc1 = Width, should be 0 if 256 pixels
| size2 = 1 | desc2 = Height, should be 0 if 256 pixels
| size3 = 1 | desc3 = Color count, should be 0 if more than 256 colors
| size4 = 1 | desc4 = Reserved, should be 0<ref>Note: Although Microsoft's technical documentation states that this value must be zero, the icon encoder built into .NET (System.Drawing.Icon.Save) sets this value to 255. It appears that the operating system ignores this value altogether.</ref>
| size5 = 2 | desc5 = Color planes when in .ICO format, should be 0 or 1<ref>Note: Setting the color planes to 0 or 1 is treated equivalently by the operating system, but if the color planes are set higher than 1, this value should be multiplied by the bits per pixel to determine the final color depth of the image.  It is unknown if the various Windows operating system versions are resilient to different color plane values.</ref>, or the X hotspot when in .CUR format
| size6 = 2 | desc6 = Bits per pixel when in .ICO format<ref>Note: The bits per pixel might be set to zero, but can be inferred from the other data; specifically, if the bitmap is not PNG compressed, then the bits per pixel can be calculated based on the length of the bitmap data relative to the size of the image.  If the bitmap is PNG compressed, the bits per pixel are stored within the PNG data.  It is unknown if the various Windows operating system versions contain logic to infer the bit depth for all possibilities if this value is set to zero.</ref>, or the Y hotspot when in .CUR format
| size7 = 4 | desc7 = Size of the bitmap data in bytes.
| size8 = 4 | desc8 = Offset in the file.
}}

== Recommended icon sizes for Windows Vista compatibility ==
The full set of standard icon sizes which should be provided for full Windows Vista compatibility:

# 256×256, 32-bit color, PNG compressed
# 48×48, 32-bit color, uncompressed
# 48×48, 8-bit color, uncompressed
# 48×48, 4-bit color, uncompressed
# 32×32, 32-bit color, uncompressed
# 32×32, 8-bit color, uncompressed
# 32×32, 4-bit color, uncompressed
# 16×16, 32-bit color, uncompressed
# 16×16, 8-bit color, uncompressed
# 16×16, 4-bit color, uncompressed

==References==
{{reflist}}

==See also==
* [[Bitmap|Windows bitmap]], a very similar file format
* [[Apple Icon Image]], the icon format used in [[Mac OS X]].
* [[Favicon]], an icon format used for websites
* [[Icon editor]]

==External links==
* [http://www.iana.org/assignments/media-types/image/vnd.microsoft.icon IANA registration information for image/vnd.microsoft.icon]
* [http://msdn2.microsoft.com/en-us/library/ms997538.aspx Explanation of the ICO implementation from Microsoft] (Does not include the changes made in the Vista format)
* [http://msdn2.microsoft.com/en-us/library/ms997636.aspx Microsoft's Guide for creating icons]
* {{WP|Icon (computing)}}
* {{WP|Cursor (computers)}}

{{Graphics file formats}}
{{Wikipedia|ICO (icon image file format}}
[[Category:Graphics file formats]]