Documentation Archive

Developer

Asset Catalog Format Reference

On This Page

Sprite Atlas Type

A named sprite atlas created from the image sets contained in the folder. The sprite atlas can be loaded using the textureNamed: method of SKTextureAtlas. Individual images can be loaded using imageNamed: in iOS 9 and later.

Extension

.spriteatlas

Folder Contents

Image sets for each sprite in the atlas.

Contents.json File (Optional)

Metadata, on-demand resource tags, App Slicing properties, and properties for the sprite atlas (Table 25-1).

Table 25-1Sprite atlas 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 sprite atlas.

   compression-type

Slot component

The compression used on the item. For the values, see compression-type in Image Set Type.

   provides-namespace

Boolean

Use the name of the atlas as a path element for accessing any sprites.

The name of the atlas is the portion of the folder name before .spriteatlas.

   on-demand-resource-tags

Array of strings

The on-demand resource tags for the sprite atlas.

Sample Contents.json File

  1. {
  2. "properties" : {
  3. "provides-namespace" : true
  4. },
  5.   "info" : {
  6.       "author" : "com.developerName",
  7.       "version" : 1
  8.    }
  9. }