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 des GPUExternalTexture-Interfaces bietet ein Label, das verwendet werden kann, um das Objekt zu identifizieren, beispielsweise in GPUError-Nachrichten oder Konsolenwarnungen.

Dies kann durch Bereitstellung einer label-Eigenschaft im Descriptor-Objekt, das in den ursprünglichen GPUDevice.importExternalTexture()-Aufruf übergeben wird, festgelegt werden, oder es kann direkt am GPUExternalTexture-Objekt abgerufen und gesetzt werden.

Wert

Ein String. Wenn dies nicht zuvor wie oben beschrieben 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 dann 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

Siehe auch