GPUTexture: depthOrArrayLayers property

The depthOrArrayLayers read-only property of the GPUTexture interface represents the depth or layer count of the GPUTexture.

This is set based on the size property in the descriptor object passed into the originating GPUDevice.createTexture() call.

Value

A number. This represents:

• The depth in pixels, in the case of textures with a "3d" GPUTexture.dimension.
• The number of layers, in the case of layered textures with a "2d" GPUTexture.dimension.

In cases where the GPUTexture does not have a depth or layers, the value is 1.

Examples

// …

const test = device.createTexture({
  size: [128],
  format: "r8uint",
  dimension: "1d",
  usage: GPUTextureUsage.COPY_SRC,
});

console.log(test.depthOrArrayLayers); // 1

Specifications

Browser compatibility

See also

• The WebGPU API