WebGPU API
The finish() method of the
GPURenderBundleEncoder interface completes recording of the current render bundle command sequence, returning a GPURenderBundle object that can be passed into a GPURenderPassEncoder.executeBundles() call to execute those commands in a specific render pass.
Syntax
finish(descriptor)
Parameters
descriptor- : An object containing the following properties:
label- : A string providing a label that can be used to identify the object, for example in GPUError messages or console warnings.
- : An object containing the following properties:
Return value
A GPURenderBundle object instance.
Validation
The following criteria must be met when calling finish(), otherwise a GPUValidationError is generated and the GPURenderBundleEncoder becomes invalid:
- The GPURenderBundleEncoder is open (i.e., not already ended via a
finish()call). - The debug stack for the current render pass is empty (i.e., no render pass debug group is currently open, as opened by GPURenderBundleEncoder.pushDebugGroup).
Examples
const renderBundleEncoder = device.createRenderBundleEncoder({
colorFormats: [presentationFormat],
});
recordRenderPass(renderBundleEncoder);
const renderBundle = renderBundleEncoder.finish();
The above snippet is taken from the WebGPU Samples Animometer example.
Specifications
Browser compatibility
See also
- The WebGPU API
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
