WEBGL_multi_draw: multiDrawArraysWEBGL() Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
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
, das den Typ der zu rendernden Primitiven 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 wieder mit dem ersten.gl.LINES
: Zeichnet eine Linie zwischen einem Paar von Scheitelpunkten.gl.TRIANGLE_STRIP
gl.TRIANGLE_FAN
gl.TRIANGLES
: Zeichnet ein Dreieck für eine Gruppe von drei Scheitelpunkten.
firstsList
-
Ein
Int32Array
oderArray
(vonGLint
), das eine Liste von Startindizes für die Arrays der Vektorpunkte angibt. firstsOffset
-
Ein
GLuint
, der den Startpunkt imfirstsLists
Array definiert. countsList
-
Ein
Int32Array
oderArray
(vonGLsizei
), das eine Liste von Anzahlen von Indizes angibt, die gerendert werden sollen. countsOffset
-
Ein
GLuint
, der den Startpunkt imcountsList
Array definiert. drawCount
-
Ein
GLsizei
, der die Anzahl der Instanzen des Bereichs von Elementen angibt, die ausgeführt werden sollen.
Rückgabewert
Keiner.
Ausnahmen
- Wenn
mode
nicht einer der akzeptierten Werte ist, wird eingl.INVALID_ENUM
Fehler ausgelöst. - Wenn
drawCount
oder Elemente infirstsList
undcountsList
negativ sind, wird eingl.INVALID_VALUE
Fehler ausgelöst. - Wenn
gl.CURRENT_PROGRAM
null
ist, wird eingl.INVALID_OPERATION
Fehler ausgelöst.
Beispiele
const firsts = new Int32Array(/* … */);
const counts = new Int32Array(/* … */);
ext.multiDrawArraysWEBGL(gl.TRIANGLES, firsts, 0, counts, 0, firsts.length);
Spezifikationen
Specification |
---|
WebGL WEBGL_multi_draw Extension Specification |
Browser-Kompatibilität
BCD tables only load in the browser