ANGLE_instanced_arrays: drawArraysInstancedANGLE() Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since June 2016.
Die ANGLE_instanced_arrays.drawArraysInstancedANGLE()
Methode der WebGL API rendert Primitive aus Array-Daten ähnlich der gl.drawArrays()
Methode. Zusätzlich kann sie mehrere Instanzen des Bereichs von Elementen ausführen.
Hinweis: Bei Verwendung von WebGL2
ist diese Methode standardmäßig als gl.drawArraysInstanced()
verfügbar.
Syntax
drawArraysInstancedANGLE(mode, first, count, primcount)
Parameter
mode
-
Ein
GLenum
, das den Typ des zu rendernden Primitives 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.
first
-
Ein
GLint
, das den Startindex im Array der Vektorpunkte angibt. count
-
Ein
GLsizei
, das die Anzahl der zu rendernden Indizes angibt. primcount
-
Ein
GLsizei
, das die Anzahl der auszuführenden Instanzen des Bereichs von Elementen angibt.
Rückgabewert
Keiner (undefined
).
Ausnahmen
- Wenn
mode
nicht einer der akzeptierten Werte ist, wird eingl.INVALID_ENUM
Fehler ausgelöst. - Wenn
first
,count
oderprimcount
negativ sind, wird eingl.INVALID_VALUE
Fehler ausgelöst. - Wenn
gl.CURRENT_PROGRAM
null
ist, wird eingl.INVALID_OPERATION
Fehler ausgelöst.
Beispiele
const ext = gl.getExtension("ANGLE_instanced_arrays");
ext.drawArraysInstancedANGLE(gl.POINTS, 0, 8, 4);
Spezifikationen
Specification |
---|
WebGL ANGLE_instanced_arrays Khronos Ratified Extension Specification |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
ext.drawElementsInstancedANGLE()
ext.vertexAttribDivisorANGLE()
WebGLRenderingContext.drawArrays()
WebGLRenderingContext.drawElements()
WebGL2RenderingContext.drawArraysInstanced()
WebGL2RenderingContext.drawElementsInstanced()
WebGL2RenderingContext.vertexAttribDivisor()
WEBGL_multi_draw.multiDrawArraysInstancedWEBGL()