GPUCommandEncoder: writeTimestamp() 方法
已弃用:此功能不再推荐。虽然一些浏览器可能仍然支持它,但它可能已从相关的 Web 标准中删除,可能正在被删除,或者可能仅出于兼容性目的保留。避免使用它,并尽可能更新现有代码;请参阅此页面底部的兼容性表格,以指导您的决策。请注意,此功能可能随时停止工作。
非标准:此功能是非标准的,并且不在任何标准化轨道上。不要在面向 Web 的生产网站上使用它:它不适用于所有用户。实现之间也可能存在很大差异,并且行为可能会在将来发生变化。
writeTimestamp()
方法是 GPUCommandEncoder
接口的一个方法,它会编码一个命令,该命令在之前记录到同一排队 GPUCommandBuffer
中的命令由 GPU 执行后,将时间戳写入 GPUQuerySet
。
语法
js
writeTimestamp(querySet, queryIndex)
参数
querySet
-
一个
GPUQuerySet
对象,表示将存储时间戳值的查询集。 queryIndex
-
表示查询在查询集中的索引的数字。
返回值
无 (Undefined
).
验证
调用 writeTimestamp()
时必须满足以下条件,否则将生成 GPUValidationError
,并且 GPUCommandEncoder
将变为无效
- 在
GPUDevice
中启用了timestamp-query
功能。 querySet
GPUQuerySet.type
为"timestamp"
queryIndex
值小于GPUQuerySet.count
。
示例
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 表格仅在浏览器中加载
另请参阅
- The WebGPU API