GPUCommandEncoder: метод finish()

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

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

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

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

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

Метод finish() интерфейса GPUCommandEncoder завершает запись последовательности команд, закодированной в этом GPUCommandEncoder, возвращая соответствующий объект GPUCommandBuffer.

Синтаксис

finish()
finish(descriptor)

Параметры

descriptor Необязательно

Объект, который может содержать следующие свойства:

label Необязательно: Строка, предоставляющая метку для возвращаемого объекта GPUCommandBuffer, которая может быть использована для его идентификации, например, в сообщениях об GPUError или предупреждениях консоли.

Возвращаемое значение

Объект GPUCommandBuffer.

Валидация

При вызове finish() должны быть выполнены следующие условия, в противном случае генерируется GPUValidationError, и GPUCommandEncoder становится недопустимым:

Нет активных групп отладки (т.е. начатых через pushDebugGroup()).
Команда GPUCommandEncoder находится в открытом состоянии — это означает, что:
- Нет активных дочерних GPUComputePassEncoder или GPURenderPassEncoder объектов, которые не были завершены (вызовом end()).
- У GPUCommandEncoder ещё не был вызван метод finish() (в противном случае его нельзя использовать для кодирования дополнительных команд).

Примеры

// ...

const commandBuffer = commandEncoder.finish();
device.queue.submit([commandBuffer]);

// ...

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

Спецификация
WebGPU # dom-gpucommandencoder-finish

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`finish`	113 В настоящее время поддерживается только на ChromeOS, macOS и Windows.	113 В настоящее время поддерживается только на ChromeOS, macOS и Windows.	preview В настоящее время поддерживается только на Linux и Windows.	99 В настоящее время поддерживается только на ChromeOS, macOS и Windows.	preview	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/GPUCommandEncoder/finish