GPUTexture: depthOrArrayLayers property
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Note: This feature is available in Web Workers.
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
Specification |
---|
WebGPU # dom-gputexture-depthorarraylayers |
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
depthOrArrayLayers |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Partial support
- Partial support
- In development. Supported in a pre-release version.
- In development. Supported in a pre-release version.
- No support
- No support
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- User must explicitly enable this feature.
- Has more compatibility info.
See also
- The WebGPU API