GPURenderPassEncoder: endOcclusionQuery() 方法

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

注意:此功能在 Web Workers 中可用。

endOcclusionQuery() 方法是 GPURenderPassEncoder 介面的一部分,它用於結束透過 beginOcclusionQuery() 方法啟動的當前活躍的遮擋查詢。

語法

js
endOcclusionQuery()

引數

無。

返回值

無 (Undefined)。

驗證

呼叫 endOcclusionQuery() 時必須滿足以下條件,否則將生成 GPUValidationError,並且 GPURenderPassEncoder 將變得無效:

  • 此渲染通道上有一個活躍的遮擋查詢(即,透過之前的 beginOcclusionQuery() 呼叫啟動的)。

示例

js
// …

// Create a query set to hold the occlusion queries
const querySet = device.createQuerySet({
  type: "occlusion",
  count: 32,
});

// Render pass descriptor object, including the querySet
const renderPassDescriptor = {
  colorAttachments: [
    {
      clearValue: clearColor,
      loadOp: "clear",
      storeOp: "store",
      view: context.getCurrentTexture().createView(),
    },
  ],
  occlusionQuerySet: querySet,
};

// Begin the render pass
const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);

// Begin an occlusion query at index 0
passEncoder.beginOcclusionQuery(0);

// Run some rendering commands
passEncoder.setPipeline(renderPipeline);
passEncoder.setVertexBuffer(0, vertexBuffer);
passEncoder.draw(3);

// End the occlusion query
passEncoder.endOcclusionQuery();

// …

規範

規範
WebGPU
# dom-gpurenderpassencoder-endocclusionquery

瀏覽器相容性

另見