GPURenderPassEncoder

Thuộc tính phiên bản

label

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 GPUError hoặc cảnh báo console.

Phương thức phiên bản

beginOcclusionQuery()

Bắt đầu một truy vấn occlusion tại chỉ mục được chỉ định của GPUQuerySet liên quan (được cung cấp làm giá trị của thuộc tính descriptor occlusionQuerySet khi gọi GPUCommandEncoder.beginRenderPass() để chạy lần thực thi kết xuất).

draw()

Vẽ các nguyên thủy dựa trên các bộ đệm đỉnh được cung cấp bởi setVertexBuffer().

drawIndexed()

Vẽ các nguyên thủy có chỉ mục dựa trên các bộ đệm đỉnh và chỉ mục được cung cấp bởi setVertexBuffer() và setIndexBuffer().

drawIndirect()

Vẽ các nguyên thủy sử dụng các tham số được đọc từ GPUBuffer.

drawIndexedIndirect()

Vẽ các nguyên thủy có chỉ mục sử dụng các tham số được đọc từ GPUBuffer.

end()

Hoàn thành việc ghi lại chuỗi lệnh của lần thực thi kết xuất hiện tại.

endOcclusionQuery()

Kết thúc một truy vấn occlusion đang hoạt động đã được bắt đầu trước đó bằng beginOcclusionQuery().

executeBundles()

Thực thi các lệnh đã được ghi lại trước đó vào GPURenderBundle được tham chiếu, như một phần của lần thực thi kết xuất này.

insertDebugMarker()

Đánh dấu một điểm cụ thể trong một loạt các lệnh đã được mã hóa bằng một nhãn.

popDebugGroup()

Kết thúc một nhóm gỡ lỗi, được bắt đầu bằng lệnh gọi pushDebugGroup().

pushDebugGroup()

Bắt đầu một nhóm gỡ lỗi được đánh dấu bằng nhãn được chỉ định và sẽ chứa tất cả các lệnh được mã hóa tiếp theo cho đến khi phương thức popDebugGroup() được gọi.

setBindGroup()

Đặt GPUBindGroup để sử dụng cho các lệnh kết xuất tiếp theo, cho một chỉ mục nhất định.

setBlendConstant()

Đặt giá trị màu sắc và alpha pha trộn hằng số được dùng với các hệ số pha trộn "constant" và "one-minus-constant" (như được đặt trong descriptor của phương thức GPUDevice.createRenderPipeline(), trong thuộc tính blend).

setIndexBuffer()

Đặt GPUBuffer hiện tại sẽ cung cấp dữ liệu chỉ mục cho các lệnh vẽ tiếp theo.

setPipeline()

Đặt GPURenderPipeline để sử dụng cho lần thực thi kết xuất này.

setScissorRect()

Đặt hình chữ nhật cắt được sử dụng trong giai đoạn rasterization. Sau khi biến đổi sang tọa độ viewport, bất kỳ mảnh nào nằm ngoài hình chữ nhật cắt sẽ bị loại bỏ.

setStencilReference()

Đặt giá trị tham chiếu stencil được sử dụng trong các bài kiểm tra stencil với thao tác stencil "replace" (như được đặt trong descriptor của phương thức GPUDevice.createRenderPipeline(), trong các thuộc tính định nghĩa các thao tác stencil khác nhau).

setVertexBuffer()

Đặt hoặc bỏ đặt GPUBuffer hiện tại sẽ cung cấp dữ liệu đỉnh cho các lệnh vẽ tiếp theo.

setViewport()

Đặt viewport được sử dụng trong giai đoạn rasterization để ánh xạ tuyến tính từ tọa độ thiết bị chuẩn hóa sang tọa độ viewport.

Ví dụ

Trong demo kết xuất cơ bản của chúng tôi, một số lệnh được ghi lại thông qua GPUCommandEncoder. Hầu hết các lệnh này xuất phát từ GPURenderPassEncoder được tạo thông qua GPUCommandEncoder.beginRenderPass().

// …

const renderPipeline = device.createRenderPipeline(pipelineDescriptor);

// Create GPUCommandEncoder to issue commands to the GPU
// Note: render pass descriptor, command encoder, etc. are destroyed after use, fresh one needed for each frame.
const commandEncoder = device.createCommandEncoder();

// Create GPURenderPassDescriptor to tell WebGPU which texture to draw into, then initiate render pass
const renderPassDescriptor = {
  colorAttachments: [
    {
      clearValue: clearColor,
      loadOp: "clear",
      storeOp: "store",
      view: context.getCurrentTexture().createView(),
    },
  ],
};

const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);

// Draw the triangle
passEncoder.setPipeline(renderPipeline);
passEncoder.setVertexBuffer(0, vertexBuffer);
passEncoder.draw(3);

// End the render pass
passEncoder.end();

// End frame by passing array of command buffers to command queue for execution
device.queue.submit([commandEncoder.finish()]);

// …

Thông số kỹ thuật

Tương thích trình duyệt

Xem thêm

• WebGPU API