GPUTexture

Die GPUTexture-Schnittstelle der WebGPU API stellt einen Container dar, der zur Speicherung von 1D-, 2D- oder 3D-Datenarrays genutzt wird, wie beispielsweise Bilder, die in GPU-Rendering-Operationen verwendet werden.

Ein GPUTexture-Objekt wird mit der Methode GPUDevice.createTexture() erstellt.

Instanz-Eigenschaften

depthOrArrayLayers Schreibgeschützt

Eine Zahl, die die Tiefe oder die Anzahl der Schichten der GPUTexture (in Pixeln oder Anzahl der Schichten) darstellt.

dimension Schreibgeschützt

Ein enumerierter Wert, der die Dimension des Satzes der Texels für jede GPUTexture-Subressource darstellt.

format Schreibgeschützt

Ein enumerierter Wert, der das Format der GPUTexture darstellt. Siehe den Abschnitt Texture formats der Spezifikation für alle möglichen Werte. Siehe auch Tier 1 and Tier 2 texture formats.

height Schreibgeschützt

Eine Zahl, die die Höhe der GPUTexture in Pixeln darstellt.

label

Ein String, der eine Bezeichnung bietet, um das Objekt zu identifizieren, beispielsweise in GPUError-Nachrichten oder Konsolenwarnungen.

mipLevelCount Schreibgeschützt

Eine Zahl, die die Anzahl der Mip-Level der GPUTexture darstellt.

sampleCount Schreibgeschützt

Eine Zahl, die die Anzahl der Samples der GPUTexture darstellt.

usage Schreibgeschützt

Die bitweisen Flags, die die erlaubten Nutzungen der GPUTexture darstellen.

width Schreibgeschützt

Eine Zahl, die die Breite der GPUTexture in Pixeln darstellt.

Instanz-Methoden

createView()

Erstellt eine GPUTextureView, die eine spezifische Ansicht der GPUTexture darstellt.

destroy()

Zerstört die GPUTexture.

Beispiele

Im WebGPU-Beispiel Textured Cube sample wird eine Textur erstellt, die auf den Seiten eines Würfels verwendet wird, indem:

• Das Bild in ein HTMLImageElement geladen und ein Image-Bitmap mit createImageBitmap() erstellt wird.
• Eine neue GPUTexture mit createTexture() erstellt wird.
• Das Image-Bitmap mittels GPUQueue.copyExternalImageToTexture() in die Textur kopiert wird.

// ...
let cubeTexture;
{
 const img = document.createElement("img");
 img.src = new URL(
 "../../../assets/img/Di-3d.png",
 import.meta.url,
 ).toString();
 await img.decode();
 const imageBitmap = await createImageBitmap(img);
 cubeTexture = device.createTexture({
 size: [imageBitmap.width, imageBitmap.height, 1],
 format: "rgba8unorm",
 usage:
 GPUTextureUsage.TEXTURE_BINDING |
 GPUTextureUsage.COPY_DST |
 GPUTextureUsage.RENDER_ATTACHMENT,
 });
 device.queue.copyExternalImageToTexture(
 { source: imageBitmap },
 { texture: cubeTexture },
 [imageBitmap.width, imageBitmap.height],
 );
}
// ...

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Die WebGPU API