GPURenderBundleEncoder: setVertexBuffer()-Methode
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 setVertexBuffer()
-Methode der GPURenderBundleEncoder
-Schnittstelle setzt oder entfernt den aktuellen GPUBuffer
für den angegebenen Slot, der Vertex-Daten für nachfolgende Zeichenbefehle bereitstellt.
Hinweis: Diese Methode ist funktional identisch mit ihrem Äquivalent auf GPURenderPassEncoder
— setVertexBuffer()
.
Syntax
setVertexBuffer(slot, buffer, offset, size)
Parameter
slot
-
Eine Zahl, die den Vertex-Buffer-Slot referenziert, für den der Vertex-Buffer gesetzt werden soll.
buffer
-
Ein
GPUBuffer
, der den Puffer mit den zu verwendenden Vertex-Daten für nachfolgende Zeichenbefehle darstellt, odernull
, in welchem Fall ein zuvor gesetzter Puffer im angegebenen Slot entfernt wird. offset
Optional-
Eine Zahl, die den Versatz in Bytes in
buffer
darstellt, wo die Vertex-Daten beginnen. Falls weggelassen, ist der Standardwert vonoffset
0. size
Optional-
Eine Zahl, die die Größe in Bytes der in
buffer
enthaltenen Vertex-Daten darstellt. Falls weggelassen, ist der Standardwert vonsize
dieGPUBuffer.size
desbuffers
-offset
.
Rückgabewert
Keiner (Undefined
).
Validierung
Die folgenden Kriterien müssen beim Aufruf von setVertexBuffer()
erfüllt sein, andernfalls wird ein GPUValidationError
erzeugt und der GPURenderBundleEncoder
wird ungültig:
- Die
GPUBuffer.usage
desbuffers
enthält dasGPUBufferUsage.VERTEX
-Flag. slot
ist kleiner als das LimitmaxVertexBuffers
desGPUDevice
.offset
+size
ist kleiner oder gleich derGPUBuffer.size
desbuffers
.offset
ist ein Vielfaches von 4.
Beispiele
Vertex-Buffer setzen
function recordRenderPass(passEncoder) {
if (settings.dynamicOffsets) {
passEncoder.setPipeline(dynamicPipeline);
} else {
passEncoder.setPipeline(pipeline);
}
passEncoder.setVertexBuffer(0, vertexBuffer);
passEncoder.setBindGroup(0, timeBindGroup);
const dynamicOffsets = [0];
for (let i = 0; i < numTriangles; ++i) {
if (settings.dynamicOffsets) {
dynamicOffsets[0] = i * alignedUniformBytes;
passEncoder.setBindGroup(1, dynamicBindGroup, dynamicOffsets);
} else {
passEncoder.setBindGroup(1, bindGroups[i]);
}
passEncoder.draw(3, 1, 0, 0);
}
}
Der obige Ausschnitt stammt aus dem WebGPU Samples Animometer-Beispiel.
Vertex-Buffer entfernen
// Set vertex buffer in slot 0
passEncoder.setVertexBuffer(0, vertexBuffer);
// Later, unset vertex buffer in slot 0
passEncoder.setVertexBuffer(0, null);
Spezifikationen
Specification |
---|
WebGPU # dom-gpurendercommandsmixin-setvertexbuffer |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Die WebGPU API