GPUTexture: dimension-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die dimension-Eigenschaft des GPUTexture-Interfaces ist eine schreibgeschützte Eigenschaft, die die Dimension der Texelmengen für jede GPUTexture-Subressource darstellt.

Diese wird über die dimension-Eigenschaft im Deskripturobjekt festgelegt, das in den ursprünglichen Aufruf von GPUDevice.createTexture() übergeben wird und standardmäßig auf "2d" gesetzt wird, wenn sie nicht angegeben wird.

Wert

Ein enumerierter Wert. Mögliche Werte sind:

  • "1d": Eine eindimensionale Textur mit einer einzigen Dimension, der Breite.
  • "2d": Eine zweidimensionale Textur mit Breite und Höhe, die auch Schichten haben kann. Nur "2d"-Texturen können Mipmaps haben, multisampled sein, ein komprimiertes oder Tiefen-/Stencil-Format verwenden und als Render-Anhang verwendet werden.
  • "3d": Eine dreidimensionale Textur mit Breite, Höhe und Tiefe.

Beispiele

js
// ...

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

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

Spezifikationen

Specification
WebGPU
# dom-gputexture-dimension

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch