WEBGL_multi_draw: multiDrawElementsInstancedWEBGL() 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.multiDrawElementsInstancedWEBGL()
Methode der
WebGL API rendert mehrere Primitiven aus
Array-Daten. Sie ist identisch mit mehreren Aufrufen der
gl.drawElementsInstanced()
Methode.
Syntax
multiDrawElementsInstancedWEBGL(mode,
countsList, countsOffset,
type,
firstsList, firstsOffset,
instanceCountsList, instanceCountsOffset,
drawCount);
Parameter
mode
-
Ein
GLenum
, das 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_STRIP
gl.TRIANGLE_FAN
gl.TRIANGLES
: Zeichnet ein Dreieck für eine Gruppe von drei Scheitelpunkten.
countsList
-
Ein
Int32Array
oderArray
(vonGLint
), das eine Liste von Zahlen der zu rendernden Indizes angibt. countsOffset
-
Ein
GLUint
, das den Startpunkt imcountsList
Array definiert. - type
-
Ein
GLenum
, das den Typ der Werte im Element-Array-Puffer angibt. Mögliche Werte sind:-
gl.UNSIGNED_BYTE
-
gl.UNSIGNED_SHORT
-
Bei Verwendung der
OES_element_index_uint
Erweiterung:gl.UNSIGNED_INT
-
offsetsList
-
Ein
Int32Array
oderArray
(vonGLsizei
), das eine Liste von Startindizes für die Arrays von Vektorpunkten angibt. offsetsOffset
-
Ein
GLuint
, das den Startpunkt imoffsetsList
Array definiert. instanceCountsList
-
Ein
Int32Array
oderArray
(vonGLsizei
), das eine Liste von Zahlen der Instanzen des zu ausführenden Bereichs der Elemente angibt. instanceCountsOffset
-
Ein
GLuint
, das den Startpunkt iminstanceCountsList
Array definiert. drawCount
-
Ein
GLsizei
, das die Anzahl der Instanzen des zu ausführenden Bereichs der Elemente angibt.
Rückgabewert
Keiner.
Ausnahmen
-
Wenn
mode
nicht einer der akzeptierten Werte ist, wird eingl.INVALID_ENUM
Fehler ausgelöst. -
Wenn
drawCount
oder Elemente incountsList
,offsetsList
oderinstanceCountsList
negativ sind, wird eingl.INVALID_VALUE
Fehler ausgelöst.
Beispiele
const counts = new Int32Array(/* … */);
const offsets = new Int32Array(/* … */);
const instanceCounts = new Int32Array(/* … */);
ext.multiDrawElementsInstancedWEBGL(
gl.TRIANGLES,
counts,
0,
gl.UNSIGNED_SHORT,
offsets,
0,
instanceCounts,
0,
counts.length,
);
Spezifikationen
Specification |
---|
WebGL WEBGL_multi_draw Extension Specification |
Browser-Kompatibilität
BCD tables only load in the browser