Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

GPURenderPassEncoder: label-Eigenschaft

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more browser support for this feature? Tell us why.

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 Schnittstelle GPURenderPassEncoder ist ein String, der eine Bezeichnung bereitstellt, mit der das Objekt identifiziert werden kann, beispielsweise in GPUError-Meldungen oder Konsolenwarnungen.

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

Wert

Ein String. Wenn zuvor kein Bezeichnungswert festgelegt wurde, gibt das Abrufen der Bezeichnung einen leeren String zurück.

Beispiele

Festlegen und Abrufen einer Bezeichnung ü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 einer Bezeichnung ü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

Spezifikation
WebGPU
# dom-gpuobjectbase-label

Browser-Kompatibilität

Siehe auch