Documentation Archive

Developer

Asset Catalog Format Reference

On This Page

Cube Texture Type

A 3D cube mapped texture.

Extension

.cubetextureset

Folder Contents

Mipmaps for the different trait configurations of each of the six cube faces. For information on the mipmap type, see Mipmap Type.

Contents.json File

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

Table 11-1Cube texture 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 2D texture.

   interpretation

String

Interpret the file as an image or as data. For the values, see interpretation in Texture Type.

   on-demand-resource-tags

Array of strings

The on-demand resource tags for the 2D texture.

   origin

String

The origin of the coordinate system. For the values, see origin in Texture Type.

textures

Array of dictionaries

The mipmap sets for each trait combination.

The array must contain at least one texture for each of the 6 cube-face values: x+, x-, y+, y-, z+, z-.

   color-space

Slot component

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

   cube-face

String

The cube face for the mipmap. For the values, see cube-face below.

   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 in Texture Type.

   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.

cube-face

The name of the cube face as a string. Values are shown in (Table 11-2).

Table 11-2cube-face values

Value

Description

x-

The cube face on the negative x axis.

x+

The cube face on the positive x axis.

y-

The cube face on the negative y axis.

y+

The cube face on the positive y axis.

z-

The cube face on the negative z axis.

z+

The cube face on the positive z axis.

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

See interpretation in Texture Type.

memory

See memory in Image Set Type.

origin

See origin in Texture Type.

pixel-format

See pixel-format in Texture Type.

scale

See scale in Image Set Type.

Sample Contents.json File

  1. {
  2. "properties" : {
  3. "interpretation" : "colors"
  4. },
  5.   "textures" : [
  6.     {
  7.       "filename" : "LlamaFront.mipmapset",
  8.       "cube-face" : "x+",
  9.       "idiom" : "Universal",
  10.       "memory" : "4GB",
  11.       "pixel-format" : "rbg-10-extended-range-sRGB"
  12.     },
  13.     {
  14.       "filename" : "LlamaBack.mipmapset",
  15.       "cube-face" : "x-",
  16.       "idiom" : "Universal",
  17.       "memory" : "4GB",
  18.       "pixel-format" : "rbg-10-extended-range-sRGB"
  19.     },
  20.     {
  21.       "filename" : "LlamaLeft.mipmapset",
  22.       "cube-face" : "y+",
  23.       "idiom" : "Universal",
  24.       "memory" : "4GB",
  25.       "pixel-format" : "rbg-10-extended-range-sRGB"
  26.     },
  27.     {
  28.       "filename" : "LlamaRight.mipmapset",
  29.       "cube-face" : "y-",
  30.       "idiom" : "Universal",
  31.       "memory" : "4GB",
  32.       "pixel-format" : "rbg-10-extended-range-sRGB"
  33.     },
  34.     {
  35.       "filename" : "LlamaTop.mipmapset",
  36.       "cube-face" : "z+",
  37.       "idiom" : "Universal",
  38.       "memory" : "4GB",
  39.       "pixel-format" : "rbg-10-extended-range-sRGB"
  40.     },
  41.     {
  42.       "filename" : "LlamaBottom.mipmapset",
  43.       "cube-face" : "x+",
  44.       "idiom" : "Universal",
  45.       "memory" : "4GB",
  46.       "pixel-format" : "rbg-10-extended-range-sRGB"
  47.     },
  48.     {
  49.       "filename" : "LlamaFront.mipmapset",
  50.       "cube-face" : "z+",
  51.       "idiom" : "Universal",
  52.       "memory" : "4GB",
  53.       "pixel-format" : "rbg-10-extended-range-sRGB"
  54.     }
  55.   ]
  56.   "info" : {
  57.       "author" : "com.developerName",
  58.       "version" : 1
  59.    }
  60. }