GPURenderBundleEncoder: phương thức finish()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Note: This feature is available in Web Workers.
Phương thức finish() của giao diện GPURenderBundleEncoder hoàn thành việc ghi lại chuỗi lệnh gói kết xuất hiện tại, trả về một đối tượng GPURenderBundle có thể được truyền vào lệnh gọi GPURenderPassEncoder.executeBundles() để thực thi các lệnh đó trong một lần thực thi kết xuất cụ thể.
Cú pháp
finish(descriptor)
Tham số
descriptorOptional-
Một đối tượng chứa các thuộc tính sau:
labelOptional-
Một chuỗi cung cấp nhãn có thể được dùng để nhận dạng đối tượng, ví dụ trong các thông báo
GPUErrorhoặc cảnh báo console.
Giá trị trả về
Một đối tượng GPURenderBundle.
Xác thực
Các tiêu chí sau phải được đáp ứng khi gọi finish(), nếu không GPUValidationError sẽ được tạo ra và GPURenderBundleEncoder sẽ không hợp lệ:
GPURenderBundleEncoderđang mở (tức là chưa kết thúc bằng lệnh gọifinish()).- Ngăn xếp gỡ lỗi cho lần thực thi kết xuất hiện tại trống (tức là không có nhóm gỡ lỗi lần thực thi kết xuất nào đang mở, như được mở bởi
pushDebugGroup()).
Ví dụ
const renderBundleEncoder = device.createRenderBundleEncoder({
colorFormats: [presentationFormat],
});
recordRenderPass(renderBundleEncoder);
const renderBundle = renderBundleEncoder.finish();
Đoạn mã trên được lấy từ ví dụ WebGPU Samples Animometer example.
Thông số kỹ thuật
| Specification |
|---|
| WebGPU # dom-gpurenderbundleencoder-finish |