MDN self-hosted library · e01.org

GPUTexture: depthOrArrayLayers property

WebGPU API

Open notebook · 1 cells web-api-instance-property upstream source

WebGPU API

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