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

瀏覽器相容性

另見