WEBGL_multi_draw: multiDrawArraysWEBGL() Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Die WEBGL_multi_draw.multiDrawArraysWEBGL() Methode der
WebGL API rendert mehrere Primitiven aus
Array-Daten. Sie ist identisch mit mehreren Aufrufen der
gl.drawArrays()
Methode.
Syntax
multiDrawArraysWEBGL(mode,
firstsList, firstsOffset,
countsList, countsOffset,
drawCount)
Parameter
mode-
Ein
GLenum, der den Typ des zu rendernden Primitivs angibt. Mögliche Werte sind:gl.POINTS: Zeichnet einen einzelnen Punkt.gl.LINE_STRIP: Zeichnet eine gerade Linie zum nächsten Scheitelpunkt.gl.LINE_LOOP: Zeichnet eine gerade Linie zum nächsten Scheitelpunkt und verbindet den letzten Scheitelpunkt zurück zum ersten.gl.LINES: Zeichnet eine Linie zwischen einem Paar von Scheitelpunkten.gl.TRIANGLE_STRIPgl.TRIANGLE_FANgl.TRIANGLES: Zeichnet ein Dreieck für eine Gruppe von drei Scheitelpunkten.
firstsList-
Ein
Int32ArrayoderArray(vonGLint), das eine Liste von Startindexen für die Arrays von Vektorpunkten angibt. firstsOffset-
Ein
GLuint, der den Startpunkt imfirstsListArray definiert. countsList-
Ein
Int32ArrayoderArray(vonGLsizei), das eine Liste von Anzahlen von zu rendernden Indexen angibt. countsOffset-
Ein
GLuint, der den Startpunkt imcountsListArray definiert. drawCount-
Ein
GLsizei, der die Anzahl der Instanzen des Bereichs von Elementen angibt, die ausgeführt werden sollen.
Rückgabewert
Keiner.
Ausnahmen
- Wenn
modenicht einer der akzeptierten Werte ist, wird eingl.INVALID_ENUMFehler ausgelöst. - Wenn
drawCountoder Elemente infirstsListundcountsListnegativ sind, wird eingl.INVALID_VALUEFehler ausgelöst. - Wenn
gl.CURRENT_PROGRAMnullist, wird eingl.INVALID_OPERATIONFehler ausgelöst.
Beispiele
const firsts = new Int32Array(/* … */);
const counts = new Int32Array(/* … */);
ext.multiDrawArraysWEBGL(gl.TRIANGLES, firsts, 0, counts, 0, firsts.length);
Spezifikationen
| Spezifikation |
|---|
| WebGL WEBGL_multi_draw Extension Specification> |