Image Set Type
The graphical image files for a named image asset used for instances of UIImage
and NSImage
.
Extension
.imageset
Folder Contents
.avci
, .heic
, .heif
, .png
, .jpg
, and .pdf
files.
Contents.json File (Required)
Metadata, on-demand resource tags, App Slicing properties, and attributes for the individual resource files (Table 18-1).
Key |
Type |
Description |
---|---|---|
|
Dictionary |
Versioning information for the asset catalog. |
|
String |
The application that authored the asset catalog. |
|
Number |
The version of the asset catalog. |
|
Dictionary |
Properties for the image set. |
|
Array of strings |
The on-demand resource tags for the image set. |
|
Boolean |
Set to |
|
Array of dictionaries |
The images in the image set. |
|
Slot component |
The color space for the item. For the values, see color-space below. |
|
Slot component |
The compression used on the item. For the values, see compression-type below. |
|
Slot component |
The color gamut of the device display. For the values, see display-gamut below. |
|
String |
The |
|
Slot component |
The graphics features required for the image. For the values, see graphics-feature-set below. |
|
Slot component |
The device type for the image. For the values, see idiom below. |
|
String |
The horizontal display direction for the image. For the values, see language-direction below. |
|
Slot component |
The memory required by the data item. For the values, see memory below. |
|
Slot component |
The scale of the image. For the values, see scale below. |
|
Slot component |
The Apple Watch screen width for the image. For the values, see screen-width below. |
|
String |
Specifies if the image is a template for use with visual effects such as replacing colors. For the values, see template-rendering-intent below. |
|
Slot component |
The size class for the width of the image. For the values, see width-class below. |
|
Slot component |
The size class for the height of the image. For the values, see height-class below. |
|
Boolean |
Used by Xcode. |
|
Dictionary |
The insets for |
|
Number |
The top inset in pixels. |
|
Number |
The bottom inset in pixels. |
|
Number |
The left inset in pixels. |
|
Number |
The right inset in pixels. |
|
Dictionary |
The attributes for a resizable image. Only included with resizable images. |
|
Enum |
The resizing mode of the image. For the values, see resizing mode below. |
|
Dictionary |
Used for resizing the image. |
|
Enum |
The center resizing mode for the image. For the values, see center mode below. |
|
Number |
The width in pixels of the rectangle for the resizable area of the image.
Only valid for modes of |
|
Number |
The height in pixels of the rectangle for the resizable area of the image.
Only valid for modes of |
|
Dictionary |
The inset from the edges of the image to the resizable area. |
|
Number |
The height in pixels of the non-resizable slice on the top of the image. |
|
Number |
The height in pixels of the non-resizable slice on the bottom of the image. |
|
Number |
The width in pixels of the non-resizable slice on the left of the image. |
|
Number |
The width in pixels of the non-resizable slice on the right of the image. |
Values for Enumerated Tags
color-space
The color space for the image (Table 18-2).
compression-type
The type of compression used for the item (Table 18-3).
Value |
Description |
---|---|
Tag not included |
The compression type inherits from the parent. The type is set to lossless compression if there is no parent. |
|
The image uses an automatic lossy compression. |
|
The image uses a lossy GPU compression format optimized for quality. |
|
The image uses a lossy GPU compression format optimized for memory size. |
|
The image uses lossless compression.
This is the default if the |
|
The image uses basic lossy compression. |
display-gamut
The color gamut for the device display (Table 18-4).
graphics-feature-set
The graphics feature set required for the item. The values correspond to values in the MTLFeatureSet
enumerated type. The keys are based on the iOS types. tvOS uses the GPU and OS revision level equivalent keys. For example, metal2v3
corresponds to MTLFeatureSet_iOS_GPUFamily2_v3
on iOS and to MTLFeatureSet_tvOS_GPUFamily1_v2
on tvOS.
For values, see (Table 18-5).
Value |
Description |
---|---|
Tag not included |
The item works with any device that has at least OpenGL ES 2.0. |
|
The item requires features in |
|
The item features in |
|
The item requires features in |
|
The item requires features in |
|
The item requires features in |
|
The item requires features in |
|
The item requires features in |
idiom
The device family (Table 18-6).
Value |
Description |
---|---|
|
An image shown app launcher on watchOS |
|
An image for the Apple Watch Settings app |
|
An image for the App Store icon |
|
The image is for iPhone devices. |
|
The image is for iPad devices. |
|
The image is for Mac computers. |
|
An image for the notification center on watchOS. |
|
An image used for a long look on watchOS. |
|
The image is for Apple TV. |
|
The image works on any device and platform. |
|
The image is for the Apple Watch devices. |
|
An image for the App Store icon. |
Tag not included |
Same as specifying |
language-direction
The horizontal display direction of the image for left-to-right and right-to-left languages. (Table 18-7).
Value |
Description |
---|---|
Tag not included |
The image has a fixed horizontal orientation and will display in the same direction. |
|
The image is used for display in left-to-right languages. The image is mirrored in right-to-left languages unless a right-to-left version of the image is provided. |
|
The image is used for display in right-to-left languages. The image is mirrored in left-to-right languages unless a left-to-right version of the image is provided. |
memory
The minimum device memory configuration required by the data item (Table 18-8).
Value |
Description |
---|---|
Tag not included |
The data item works on any device. |
|
The device needs at least a 1GB memory configuration. |
|
The device needs at least a 2GB memory configuration. |
|
The device needs at least a 3GB memory configuration. |
|
The device needs at least a 4GB device memory configuration. |
scale
The targeted display scale for the image (Table 18-9).
screen-width
The screen width for the Apple Watch (Table 18-10).
template-rendering-intent
Indicates if the image is a renderable image or is a template for. (Table 18-11).
Value |
Description |
---|---|
Tag not included |
If the name of the image ends in "Template", use the image as a template, otherwise render it as the original image. |
|
Render as the original image. |
|
Use the image as a template for visual effects such as replacing colors. |
width-class
The size class for the image width (Table 18-12).
height-class
The size class for the image height (Table 18-13).
resizing mode
The mode for a sliced resizable image (Table 18-14).
Value |
Description |
---|---|
Tag not included |
The entire image is resized. |
|
The image is divided into three horizontal parts. The outer portions are fixed-width. The central portion resizes in the horizontal dimension. |
|
The image is divided into three vertical parts. The outer portions are fixed-height. The central portion resizes in the vertical dimension. |
|
The image is divided into nine parts. There is a central area that resizes in the horizontal and vertical dimensions, fixed-width vertical caps at the left and right of the central area, fixed-height caps at the top and bottom of the central area, and four fixed-size corner parts. |
center mode
The resizing mode of the central area of a resizing image (Table 18-15).
Sample Contents.json File
{
"images" : [
{
"idiom" : "universal",
"scale" : "1x"
},
{
"graphics-feature-set" : "metal1v2",
"idiom" : "universal",
"filename" : "Llama.png"
"scale" : "2x"
},
{
"graphics-feature-set" : "metal2v2",
"idiom" : "universal",
"memory" : "2GB",
"scale" : "3x"
}
],
"info" : {
"author" : "com.developerName",
"version" : 1
},
"properties" : {
"on-demand-resources : [
"llama",
"mountain"
]
}
}
Copyright © 2018 Apple Inc. All rights reserved. Terms of Use | Privacy Policy | Updated: 2018-04-09