DieGPUTexture-Schnittstelle derWebGPU 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.

EinGPUTexture-Objekt wird mit der MethodeGPUDevice.createTexture() erstellt.

Instanz-Eigenschaften

depthOrArrayLayersSchreibgeschützt

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

dimensionSchreibgeschützt

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

formatSchreibgeschützt

Ein enumerierter Wert, der das Format derGPUTexture darstellt. Siehe den AbschnittTexture formats der Spezifikation für alle möglichen Werte. Siehe auchTier 1 and Tier 2 texture formats.

heightSchreibgeschützt

Eine Zahl, die die Höhe derGPUTexture in Pixeln darstellt.

label

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

mipLevelCountSchreibgeschützt

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

sampleCountSchreibgeschützt

Eine Zahl, die die Anzahl der Samples derGPUTexture darstellt.

usageSchreibgeschützt

Diebitweisen Flags, die die erlaubten Nutzungen derGPUTexture darstellen.

widthSchreibgeschützt

Eine Zahl, die die Breite derGPUTexture in Pixeln darstellt.

Instanz-Methoden

createView()

Erstellt eineGPUTextureView, die eine spezifische Ansicht derGPUTexture darstellt.

destroy()

Zerstört dieGPUTexture.

Beispiele

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

• Das Bild in einHTMLImageElement geladen und ein Image-Bitmap mitcreateImageBitmap() erstellt wird.
• Eine neueGPUTexture mitcreateTexture() erstellt wird.
• Das Image-Bitmap mittelsGPUQueue.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

• DieWebGPU API