ANGLE_instanced_arrays: drawArraysInstancedANGLE() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juni 2016 browserübergreifend verfügbar.
Die ANGLE_instanced_arrays.drawArraysInstancedANGLE() Methode der WebGL-API rendert Primitive aus Array-Daten wie die Methode gl.drawArrays(). 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, welcher 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.
first-
Ein
GLint, der den Startindex im Array der Vektorpunkte angibt. count-
Ein
GLsizei, der die Anzahl der zu rendernden Indizes angibt. primcount-
Ein
GLsizei, der die Anzahl der Instanzen des Bereichs von Elementen angibt, die ausgeführt werden sollen.
Rückgabewert
Keiner (undefined).
Ausnahmen
- Wenn
modenicht einer der akzeptierten Werte ist, wird eingl.INVALID_ENUMFehler ausgelöst. - Wenn
first,countoderprimcountnegativ sind, wird eingl.INVALID_VALUEFehler ausgelöst. - Wenn
gl.CURRENT_PROGRAMnullist, wird eingl.INVALID_OPERATIONFehler ausgelöst.
Beispiele
const ext = gl.getExtension("ANGLE_instanced_arrays");
ext.drawArraysInstancedANGLE(gl.POINTS, 0, 8, 4);
Spezifikationen
| Spezifikation |
|---|
| WebGL ANGLE_instanced_arrays Khronos Ratified Extension Specification |
Browser-Kompatibilität
Siehe auch
ext.drawElementsInstancedANGLE()ext.vertexAttribDivisorANGLE()WebGLRenderingContext.drawArrays()WebGLRenderingContext.drawElements()WebGL2RenderingContext.drawArraysInstanced()WebGL2RenderingContext.drawElementsInstanced()WebGL2RenderingContext.vertexAttribDivisor()WEBGL_multi_draw.multiDrawArraysInstancedWEBGL()