GPURenderPassEncoder: свойство label

Ограниченная доступность

Эта функция не является базовой, так как она не работает во всех широко используемых браузерах.

Экспериментально: Это экспериментальная технология
Перед использованием в продакшене тщательно ознакомьтесь со таблицей совместимости браузеров.

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или во всех поддерживающих браузерах.

Примечание: Эта функция доступна в Web Workers.

Свойство label только для чтения интерфейса GPURenderPassEncoder — это строка, предоставляющая метку, которую можно использовать для идентификации объекта, например, в сообщениях GPUError или предупреждениях консоли.

Это свойство можно задать, указав свойство label в объекте описателя, переданном в исходный вызов GPUCommandEncoder.beginRenderPass(), или можно получить и установить его напрямую в объекте GPURenderPassEncoder.

Значение

Строка. Если ранее не было установлено значение метки, получение метки возвращает пустую строку.

Примеры

Установка и получение метки через GPURenderPassEncoder.label:

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"

Установка метки через исходный вызов GPUCommandEncoder.beginRenderPass(), а затем получение её через GPURenderPassEncoder.label:

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"

Спецификации

Спецификация
WebGPU # dom-gpuobjectbase-label

Совместимость браузеров

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`label`	113 В настоящее время поддерживается только на ChromeOS, macOS и Windows.	113 В настоящее время поддерживается только на ChromeOS, macOS и Windows.	предварительная версия В настоящее время поддерживается только на Linux и Windows.	99 В настоящее время поддерживается только на ChromeOS, macOS и Windows.	предварительная версия	121	Нет	81	Нет	25.0	121

См. также

API WebGPU

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/GPURenderPassEncoder/label