GPUTexture: dimension-Eigenschaft

Limited availability

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

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 schreibgeschützte dimension-Eigenschaft des GPUTexture-Interfaces repräsentiert die Dimension des Texel-Satzes für jede GPUTexture-Subressource.

Diese wird über die dimension-Eigenschaft im Descriptor-Objekt festgelegt, das in den ursprünglichen Aufruf von GPUDevice.createTexture() übergeben wird. Wenn sie weggelassen wird, ist der Standardwert "2d".

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 genutzt 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

Siehe auch