WebGL2RenderingContext: drawArraysInstanced() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2021 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die WebGL2RenderingContext.drawArraysInstanced() Methode
der WebGL 2 API rendert Primitiven aus
Array-Daten ähnlich der gl.drawArrays()
Methode. Zusätzlich kann sie mehrere Instanzen des Elementbereichs ausführen.
Hinweis:
Bei der Verwendung von WebGL 1,
kann die ANGLE_instanced_arrays Erweiterung diese Methode
ebenfalls bereitstellen.
Syntax
drawArraysInstanced(mode, first, count, instanceCount)
Parameter
mode-
Ein
GLenum, der den zu rendernden Typ primitiver Formen angibt. Mögliche Werte sind:gl.POINTS: Zeichnet einen einzelnen Punkt.gl.LINE_STRIP: Zeichnet eine gerade Linie zum nächsten Vertex.gl.LINE_LOOP: Zeichnet eine gerade Linie zum nächsten Vertex und verbindet den letzten Vertex zurück zum ersten.gl.LINES: Zeichnet eine Linie zwischen einem Paar von Vertices.gl.TRIANGLE_STRIPgl.TRIANGLE_FANgl.TRIANGLES: Zeichnet ein Dreieck für eine Gruppe aus drei Vertices.
first-
Ein
GLint, der den Startindex im Array der Vektorpunkte angibt. count-
Ein
GLsizei, der die Anzahl der Indizes angibt, die gerendert werden sollen. instanceCount-
Ein
GLsizei, der die Anzahl der Instanzen des Elementbereichs, die ausgeführt werden sollen, angibt.
Rückgabewert
Keiner (undefined).
Beispiele
gl.drawArraysInstanced(gl.POINTS, 0, 8, 4);
Spezifikationen
| Spezifikation |
|---|
| WebGL 2.0 Specification # 3.7.9 |