GPURenderPipeline: label 属性
注意:此功能在 Web Workers 中可用。
GPURenderPipeline 接口的 label 属性提供了一个可用于标识对象的标签,例如在 GPUError 消息或控制台警告中。
可以通过在传递给 GPUDevice.createRenderPipeline() 或 GPUDevice.createRenderPipelineAsync() 调用的描述符对象中提供 label 属性来设置它,或者您可以直接在 GPURenderPipeline 对象上获取和设置它。
值
一个字符串。如果之前未按上述方式设置,则为空字符串。
示例
通过 GPURenderPipeline.label 设置和获取标签
js
// …
const pipelineDescriptor = {
vertex: {
module: shaderModule,
entryPoint: "vertex_main",
buffers: vertexBuffers,
},
fragment: {
module: shaderModule,
entryPoint: "fragment_main",
targets: [
{
format: navigator.gpu.getPreferredCanvasFormat(),
},
],
},
primitive: {
topology: "triangle-list",
},
layout: "auto",
};
const renderPipeline = device.createRenderPipeline(pipelineDescriptor);
renderPipeline.label = "my_render_pipeline";
console.log(renderPipeline.label); // "my_render_pipeline"
通过 GPUDevice.createRenderPipeline() 调用设置标签,然后通过 GPURenderPipeline.label 获取它
js
// …
const pipelineDescriptor = {
vertex: {
module: shaderModule,
entryPoint: "vertex_main",
buffers: vertexBuffers,
},
fragment: {
module: shaderModule,
entryPoint: "fragment_main",
targets: [
{
format: navigator.gpu.getPreferredCanvasFormat(),
},
],
},
primitive: {
topology: "triangle-list",
},
layout: "auto",
label: "my_render_pipeline",
};
const renderPipeline = device.createRenderPipeline(pipelineDescriptor);
console.log(renderPipeline.label); // "my_render_pipeline"
规范
| 规范 |
|---|
| WebGPU # dom-gpuobjectbase-label |
浏览器兼容性
加载中…