GPURenderPipeline: label-Eigenschaft
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Die label
-Eigenschaft des GPURenderPipeline
-Interfaces bietet ein Label, das verwendet werden kann, um das Objekt zu identifizieren, zum Beispiel in GPUError
-Meldungen oder Konsolenwarnungen.
Dies kann festgelegt werden, indem eine label
-Eigenschaft im Deskriptor-Objekt bereitgestellt wird, das beim Aufruf von GPUDevice.createRenderPipeline()
oder GPUDevice.createRenderPipelineAsync()
übergeben wird, oder Sie können es direkt am GPURenderPipeline
-Objekt setzen und abrufen.
Wert
Ein String. Wenn dies nicht wie oben beschrieben zuvor festgelegt wurde, wird es ein leerer String sein.
Beispiele
Setzen und Abrufen eines Labels über GPURenderPipeline.label
:
// ...
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"
Setzen eines Labels über einen GPUDevice.createRenderPipeline()
-Aufruf und anschließend Abrufen über GPURenderPipeline.label
:
// ...
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"
Spezifikationen
Specification |
---|
WebGPU # dom-gpuobjectbase-label |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Die WebGPU API