Asset Catalog Format Reference: Mipmap Type

A series of images at different resolutions for the same texture.

Extension

.mipmapset

Folder Contents

Images for each resolution of the texture.

Contents.json File

Metadata and level mapping information for the mipmap is show in (Table 23-1).

**Table 23-1**Mipmap tags
Key	Type	Description
`info`	Dictionary	Versioning information for the asset catalog.
`author`	String	The application that authored the asset catalog.
`version`	Number	The version of the asset catalog.
`properties`	Dictionary	Properties for the mipmap atlas.
`level-mode`	String	How the images levels in the mipmap apply to the texture. For the values, see level-mode below.
`levels`	Array of dictionaries	The different levels of resolutions for the mipmap.
`display-gamut`	Slot component	The color gamut of the device display. For the values, see display-gamut in Image Set Type.
`filename`	String	The `HEIF`, `.png` or `.jpg` file for the image.
`idiom`	Slot Component	The idiom of the icon. For the values, see idiom in Image Set Type.
`mipmap-level`	String	The mipmap texture level for the image. For the values, see mipmap-level below.

Values for Enumerated Tags

display-gamut

See display-gamut in Image Set Type.

level-mode

How the images levels in the mipmap apply to the texture. For the values, see (Table 23-2).

**Table 23-2**`level-mode` values
Value	Description
Tag not included	Metal generates all the mipmap levels from the base image.
`none`	Metal does not generate mipmap levels from the base image.
`all`	Metal generates all the mipmap levels from the base image.
`fixed`	Metal generates all the mipmap levels between the base image and the maximum mipmap level provided in mipmap-level.

mipmap-level

The level for an image in the mipmap. For the values, see (Table 23-3).

**Table 23-3**`mipmap-level` values
Value	Description
`base`	The base level image of the mip map.
`mipmap-level-[1…16]`	The image for a numbered level of the mip map. For example, for the level three mipmap, set the key to `mipmap-level-3`.

Sample Contents.json File

        {
   "properties" : {
       "level-mode" : base
   },
   "levels" : [
      {
         "filename" : "WalkingLlamaBase.png",
         "mipmap-level" : "base"
      }
   ],
   "info" : {
      "author" : "com.developerName",
      "version" : 1
   }
}

      