GPUCommandEncoder: writeTimestamp() 方法

已弃用:此功能不再推荐。虽然一些浏览器可能仍然支持它,但它可能已从相关的 Web 标准中删除,可能正在被删除,或者可能仅出于兼容性目的保留。避免使用它,并尽可能更新现有代码;请参阅此页面底部的兼容性表格,以指导您的决策。请注意,此功能可能随时停止工作。

非标准:此功能是非标准的,并且不在任何标准化轨道上。不要在面向 Web 的生产网站上使用它:它不适用于所有用户。实现之间也可能存在很大差异,并且行为可能会在将来发生变化。

writeTimestamp() 方法是 GPUCommandEncoder 接口的一个方法,它会编码一个命令,该命令在之前记录到同一排队 GPUCommandBuffer 中的命令由 GPU 执行后,将时间戳写入 GPUQuerySet

注意:要使用时间戳查询,必须在 GPUDevice 中启用 timestamp-query 功能

语法

js
writeTimestamp(querySet, queryIndex)

参数

querySet

一个 GPUQuerySet 对象,表示将存储时间戳值的查询集。

queryIndex

表示查询在查询集中的索引的数字。

返回值

无 (Undefined).

验证

调用 writeTimestamp() 时必须满足以下条件,否则将生成 GPUValidationError,并且 GPUCommandEncoder 将变为无效

示例

js
// ...

const querySet = device.createQuerySet({
  type: "timestamp",
  count: 32,
});

// ...

commandEncoder.writeTimestamp(querySet, 0);

// ...

规范

未找到规范

未找到 api.GPUCommandEncoder.writeTimestamp 的规范数据。
检查此页面的问题 或贡献缺失的 spec_url mdn/browser-compat-data。同时确保规范包含在 w3c/browser-specs.

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅