GPUTexture: dimension 属性

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

注意:此功能在 Web Workers 中可用。

dimensionGPUTexture 接口的一个只读属性,表示每个 GPUTexture 子资源纹理单元(texel)集合的维度。

此属性通过传递给初始 GPUDevice.createTexture() 调用的描述符对象中的 dimension 属性进行设置,如果省略,则默认为 "2d"

这是一个枚举值。可能的值有:

  • "1d": 一维纹理,只有一个维度:宽度。
  • "2d": 二维纹理,具有宽度和高度,还可以包含图层。只有 "2d" 纹理可以拥有 mipmaps、多重采样、使用压缩或深度/模板格式,并且可以用作渲染附件。
  • "3d": 三维纹理,具有宽度、高度和深度。

示例

js
// …

const depthTexture = device.createTexture({
  size: [canvas.width, canvas.height],
  format: "depth24plus",
  usage: GPUTextureUsage.RENDER_ATTACHMENT,
});

console.log(depthTexture.dimension); // "2d"

规范

规范
WebGPU
# dom-gputexture-dimension

浏览器兼容性

另见