WEBGL_multi_draw: multiDrawArraysInstancedWEBGL() 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.multiDrawArraysInstancedWEBGL()
Methode der WebGL API rendert mehrere Primitiven aus Array-Daten. Sie ist identisch mit mehreren Aufrufen der gl.drawArraysInstanced()
Methode.
Syntax
multiDrawArraysInstancedWEBGL(mode,
firstsList, firstsOffset,
countsList, countsOffset,
instanceCountsList, instanceCountsOffset,
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 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 von Vektor-Punkten angibt. firstsOffset
-
Ein
GLuint
, der den Startpunkt in dasfirstsLists
Array definiert. countsList
-
Ein
Int32Array
oderArray
(vonGLsizei
), das eine Liste von Anzahlen der zu rendernden Indizes angibt. countsOffset
-
Ein
GLuint
, der den Startpunkt in dascountsList
Array definiert. instanceCountsList
-
Ein
Int32Array
oderArray
(vonGLsizei
), das eine Liste von Anzahlen der Instanzen des Bereichs von Elementen angibt, die ausgeführt werden sollen. instanceCountsOffset
-
Ein
GLuint
, der den Startpunkt in dasinstanceCountsList
Array definiert. drawCount
-
Ein
GLsizei
, das 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
,countsList
oderinstanceCountsList
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(/* … */);
const instanceCounts = new Int32Array(/* … */);
ext.multiDrawArraysInstancedWEBGL(
gl.TRIANGLES,
firsts,
0,
counts,
0,
instanceCounts,
0,
firsts.length,
);
Spezifikationen
Specification |
---|
WebGL WEBGL_multi_draw Extension Specification |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
multiDrawArraysInstancedWEBGL |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support