ANGLE_instanced_arrays: drawElementsInstancedANGLE() Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juni 2016.
Die ANGLE_instanced_arrays.drawElementsInstancedANGLE()-Methode der WebGL API rendert Primitiven aus Array-Daten ähnlich wie die Methode gl.drawElements(). Zusätzlich kann sie mehrere Instanzen eines Satzes von Elementen ausführen.
Hinweis:
Bei Verwendung von WebGL2 ist diese Methode standardmäßig als gl.drawElementsInstanced() verfügbar.
Syntax
drawElementsInstancedANGLE(mode, count, type, offset, primcount)
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 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 von drei Vertices.
count-
Ein
GLsizei, der die Anzahl von zu rendernden Elementen spezifiziert. type-
Ein
GLenum, der den Typ der Werte im Element-Array-Puffer angibt. Mögliche Werte sind:gl.UNSIGNED_BYTEgl.UNSIGNED_SHORTgl.UNSIGNED_INTbei Verwendung derOES_element_index_uintErweiterung.
offset-
Ein
GLintptr, der einen Offset im Element-Array-Puffer spezifiziert. Muss ein gültiges Vielfaches der Größe des angegebenentypesein. primcount-
Ein
GLsizei, der die Anzahl der Instanzen des Satzes von Elementen angibt, die ausgeführt werden sollen.
Rückgabewert
Keiner (undefined).
Ausnahmen
- Wenn
modenicht einer der akzeptierten Werte ist, wird eingl.INVALID_ENUM-Fehler ausgelöst. - Wenn
offsetkein gültiges Vielfaches der Größe des angegebenen Typs ist, wird eingl.INVALID_OPERATION-Fehler ausgelöst. - Wenn
countoderprimcountnegativ sind, wird eingl.INVALID_VALUE-Fehler ausgelöst.
Beispiele
const ext = gl.getExtension("ANGLE_instanced_arrays");
ext.drawElementsInstancedANGLE(gl.POINTS, 2, gl.UNSIGNED_SHORT, 0, 4);
Spezifikationen
| Specification |
|---|
| WebGL ANGLE_instanced_arrays Khronos Ratified Extension Specification |
Browser-Kompatibilität
Loading…
Siehe auch
ext.drawArraysInstancedANGLE()ext.vertexAttribDivisorANGLE()WebGLRenderingContext.drawArrays()WebGLRenderingContext.drawElements()WebGL2RenderingContext.drawArraysInstanced()WebGL2RenderingContext.drawElementsInstanced()WebGL2RenderingContext.vertexAttribDivisor()WEBGL_multi_draw.multiDrawElementsInstancedWEBGL()