Documentation Archive

Developer

Asset Catalog Format Reference

On This Page

Texture Type

A 2D texture.

Extension

.textureset

Folder Contents

Mipmaps for the different trait configurations. For information on the mipmap type, see Mipmap Type.

Contents.json File

Metadata, on-demand resource tags, texture information, and properties for the texture are shown in (Table 29-1).

Table 29-1Texture 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 texture.

   interpretation

String

Interpret the file as an image or as data. For the values, see interpretation below.

   on-demand-resource-tags

Array of strings

The on-demand resource tags for the texture.

   origin

String

The origin of the coordinate system. For the values, see origin below.

textures

Array of dictionaries

The mipmap sets for each trait combination.

   color-space

Slot component

The color space for the data item. For the values, see color-space in Image Set Type.

   display-gamut

Slot component

The color gamut of the device display. For the values, see display-gamut in Image Set Type.

   filename

String

The name of the folder containing the mipmap for the trait variation.

For information on the mipmap type, see Mipmap Type.

   graphics-feature-set

Slot component

The graphics features required for the item. For the values, see graphics-feature-set in Image Set Type.

   idiom

Slot component

The device type for the image. For the values, see idiom in Image Set Type.

   memory

Slot component

The memory required by the data item. For the values, see memory in Image Set Type.

   pixel-format

String

The format of the pixels in the image. For the values, see pixel-format below.

   scale

Slot Component

The scale of the image. For the values, see scale in Image Set Type.

Values for Enumerated Tags

color-space

See color-space in Image Set Type.

display-gamut

See display-gamut in Image Set Type.

graphics-feature-set

See graphics-feature-set in Image Set Type.

idiom

See idiom in Image Set Type.

interpretation

How to interpret the contents of the file (Table 29-2).

Table 29-2interpretation values

Value

Description

Tag not included

The contents of the file are an image.

colors

The contents of the file are an image.

data

The contents of the file are data such as a normal map.

memory

See memory in Image Set Type.

origin

The origin of the image coordinate system. Values are shown in (Table 29-3).

Table 29-3origin values

Value

Description

Tag not included

The coordinate system originates at the top-left.

bottom-left

The coordinate system originates at the bottom-left.

pixel-format

The pixel format for a texture. Values are shown in (Table 29-4).

Table 29-4pixel-format values

Value

Description

Tag not included

Format is determined automatically.

r-8-unorm

The pixels are in normalized 8-bit red format.

rg-8-unorm

The pixels are in normalized 8-bit red, green format.

rgba-8-unorm

The pixels are in normalized 8-bit RGB alpha format.

rgba-8-unorm-sRGB

The pixels are in normalized 8-bit RGB alpha format for the sRGB color space.

r-16-float

The pixels are in 16-bit floating point red format.

rg-16-float

The pixels are in 16-bit floating point red, green format.

rgba-16-float

The pixels are in 16-bit floating point RGB alpha format.

rbg-10-extended-range-sRGB

The pixels are in 10-bit extended range sRGB format.

astc-4x4

The pixels are in ASTC 4x4 RGB alpha format.

astc-4x4-sRGB

The pixels are in ASTC 4x4 sRGB format.

astc-8x8

The pixels are in ASTC 8x8 RGB alpha format.

astc-8x8-sRGB

The pixels are in ASTC 8x8 sRGB format.

scale

See scale in Image Set Type.

Sample Contents.json File

  1. {
  2. "properties" : {
  3. "interpretation" : "colors"
  4. },
  5.   "textures" : [
  6.     {
  7.       "filename" : "HighFidelityLlama.mipmapset",
  8.       "idiom" : "Universal",
  9.       "memory" : "4GB",
  10.       "pixel-format" : "rbg-10-extended-range-sRGB"
  11.     },
  12.     {
  13.       "filename" : "LowFidelityLlama.mipmapset",
  14.       "idiom" : "Universal",
  15.       "memory" : "1GB",
  16.       "pixel-format" : "rgba-8-unorm"
  17.     }
  18.   ]
  19.   "info" : {
  20.       "author" : "com.developerName",
  21.       "version" : 1
  22.    }
  23. }