GPUTexture

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

Specification
WebGPU # gputexture

Browser-Kompatibilität

Siehe auch

Die WebGPU API

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden