GPURenderBundleEncoder: setIndexBuffer()-Methode

Syntax

setIndexBuffer(buffer, indexFormat, offset, size)

Parameter

buffer

Ein GPUBuffer, der den Puffer darstellt, der die zu verwendenden Indexdaten für nachfolgende Zeichenbefehle enthält.

indexFormat

Ein enumerierter Wert, der das Format der in buffer enthaltenen Indexdaten definiert. Mögliche Werte sind:

• "uint16"
• "uint32"

offset Optional

Eine Zahl, die den Offset in Bytes in buffer darstellt, an dem die Indexdaten beginnen. Wenn weggelassen, entspricht offset standardmäßig 0.

size Optional

Eine Zahl, die die Größe der in buffer enthaltenen Indexdaten in Bytes darstellt. Wenn weggelassen, entspricht size standardmäßig der buffer-Größe GPUBuffer.size minus offset.

Hinweis zu indexFormat

indexFormat bestimmt sowohl den Datentyp der Indexwerte in einem Puffer als auch, wenn es mit einer Pipeline verwendet wird, die eine Streifen-Primitiv-Topologie ("line-strip" oder "triangle-strip") spezifiziert, den Primitiv-Neustartwert. Der Primitiv-Neustartwert ist ein Indexwert, der angibt, dass ein neues Primitiv gestartet werden soll, anstatt den Streifen mit den vorher festgelegten Scheitelpunkten weiter zu konstruieren. Der Wert ist 0xFFFF für "uint16" oder 0xFFFFFFFF für "uint32".

Rückgabewert

Keiner (undefined).

Validierung

Die folgenden Kriterien müssen erfüllt sein, wenn setIndexBuffer() aufgerufen wird, andernfalls wird ein GPUValidationError generiert und der GPURenderBundleEncoder wird ungültig:

• buffer's GPUBuffer.usage enthält das GPUBufferUsage.INDEX-Flag.
• offset + size ist kleiner oder gleich der buffer-Größe GPUBuffer.size.
• offset ist ein Vielfaches der Byte-Größe von indexFormat (2 für "uint16", 4 für "uint32").

Beispiele

// …

const bundleEncoder = device.createRenderBundleEncoder(descriptor);

bundleEncoder.setPipeline(pipeline);
bundleEncoder.setBindGroup(0, sceneBindGroupForRender);
bundleEncoder.setBindGroup(1, modelBindGroup);
bundleEncoder.setVertexBuffer(0, vertexBuffer);
bundleEncoder.setIndexBuffer(indexBuffer, "uint16");
bundleEncoder.drawIndexed(indexCount);

const renderBundle = bundleEncoder.finish();

// …

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Die WebGPU API