The options that determine how a texture will be used.
SDKs
Framework
typedef enum MTLTextureUsage : NSUInteger {
...
} MTLTextureUsage;
You can combine multiple usage options if the texture serves multiple uses during its life cycle. The texture can be used only in the ways specified by its usage options; otherwise, an error occurs. Setting appropriate usage options allows Metal to optimize GPU operations for the texture.
MTLTextureAn option that specifies that the texture usage is unknown.
MTLTextureAn option that enables reading or sampling from the texture.
MTLTextureAn option that enables writing to the texture.
MTLTextureAn option that enables using the texture as a color, depth, or stencil render target in a render pass descriptor.
MTLTextureAn option that enables using the texture to create texture views.
textureThe dimension and arrangement of the texture image data.
Required.
pixelThe format of pixels in the texture.
Required.
widthThe width of the texture image for the base level mipmap, in pixels.
Required.
heightThe height of the texture image for the base level mipmap, in pixels.
Required.
depthThe depth of the texture image for the base level mipmap, in pixels.
Required.
mipmapThe number of mipmap levels in the texture.
Required.
arrayThe number of slices in the texture array.
Required.
sampleThe number of samples in each pixel.
Required.
framebufferA Boolean value that indicates whether the texture can only be used as a render target.
Required.
usageA description of how the texture can be accessed in shaders.
Required.
allowA Boolean value indicating whether the GPU is allowed to adjust the contents of the texture to improve GPU performance.
Required.
shareableA Boolean indicating whether this texture can be shared with other processes.
Required.
MTLTextureThe dimension of each image, including whether multiple images are arranged into an array or a cube.