GPUExternalTexture: label-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 label-Eigenschaft der GPUExternalTexture-Schnittstelle bietet ein Label, das verwendet werden kann, um das Objekt zu identifizieren, beispielsweise in GPUError-Meldungen oder Konsolenwarnungen.

Dies kann gesetzt werden, indem man eine label-Eigenschaft im Deskriptionsobjekt bereitstellt, das im ursprünglichen GPUDevice.importExternalTexture()-Aufruf übergeben wird. Alternativ kann es direkt auf dem GPUExternalTexture-Objekt gesetzt und ausgelesen werden.

Wert

Ein String. Falls dies nicht wie oben beschrieben zuvor gesetzt wurde, wird es ein leerer String sein.

Beispiele

Setzen und Abrufen eines Labels über GPUExternalTexture.label:

js
// ...

const externalTexture = device.importExternalTexture({
  source: video,
});

externalTexture.label = "my_ext_texture";

console.log(externalTexture.label); // "my_ext_texture"

Setzen eines Labels über den ursprünglichen GPUDevice.importExternalTexture()-Aufruf und das anschließende Abrufen über GPUExternalTexture.label:

js
// ...

const externalTexture = device.importExternalTexture({
  source: video,
  label: "my_ext_texture",
});

console.log(externalTexture.label); //  "my_ext_texture"

Spezifikationen

Specification
WebGPU
# dom-gpuobjectbase-label

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch