GPURenderPassEncoder: 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 schreibgeschützte label-Eigenschaft der GPURenderPassEncoder-Schnittstelle ist eine Zeichenkette, die ein Label bereitstellt, das zur Identifikation des Objekts verwendet werden kann, beispielsweise in GPUError-Meldungen oder Konsolenwarnungen.

Dieses kann festgelegt werden, indem ein label-Eigenschaft im Deskriptorobjekt angegeben wird, das an den ursprünglichen Aufruf von GPUCommandEncoder.beginRenderPass() übergeben wird, oder Sie können es direkt auf dem GPURenderPassEncoder-Objekt setzen und abrufen.

Wert

Eine Zeichenkette. Wenn zuvor kein Labelwert festgelegt wurde, wird beim Abrufen des Labels eine leere Zeichenkette zurückgegeben.

Beispiele

Festlegen und Abrufen eines Labels über GPURenderPassEncoder.label:

js
const commandEncoder = device.createCommandEncoder();

const renderPassDescriptor = {
  colorAttachments: [
    {
      clearValue: clearColor,
      loadOp: "clear",
      storeOp: "store",
      view: context.getCurrentTexture().createView(),
    },
  ],
};

const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);
passEncoder.label = "my_render_pass_encoder";

console.log(passEncoder.label); // "my_render_pass_encoder"

Festlegen eines Labels über den ursprünglichen Aufruf von GPUCommandEncoder.beginRenderPass() und anschließendes Abrufen über GPURenderPassEncoder.label:

js
const commandEncoder = device.createCommandEncoder();

const renderPassDescriptor = {
  colorAttachments: [
    {
      clearValue: clearColor,
      loadOp: "clear",
      storeOp: "store",
      view: context.getCurrentTexture().createView(),
    },
  ],
  label: "my_render_pass_encoder",
};

const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);

console.log(passEncoder.label); // "my_render_pass_encoder"

Spezifikationen

Specification
WebGPU
# dom-gpuobjectbase-label

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch