WebGL2RenderingContext: drawRangeElements()-Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die WebGL2RenderingContext.drawRangeElements()-Methode der WebGL-API rendert Primitive aus Array-Daten in einem gegebenen Bereich.
Syntax
drawRangeElements(mode, start, end, count, type, offset)
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 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_STRIPgl.TRIANGLE_FANgl.TRIANGLES: Zeichnet ein Dreieck für eine Gruppe von drei Scheitelpunkten.
start-
Ein
GLuint, der den minimalen Array-Index angibt, der inoffsetenthalten ist. end-
Ein
GLuint, der den maximalen Array-Index angibt, der inoffsetenthalten ist. count-
Ein
GLsizei, der die Anzahl der zu rendernden Elemente angibt. type-
Ein
GLenum, der den Typ der Werte im Element-Array-Puffer angibt. Mögliche Werte sind:gl.UNSIGNED_BYTEgl.UNSIGNED_SHORTgl.UNSIGNED_INT
offset-
Ein
GLintptr, der einen Offset im Element-Array-Puffer angibt. Muss ein gültiges Vielfaches der Größe des angegebenentypesein.
Rückgabewert
Keiner (undefined).
Ausnahmen
- Wenn
modenicht einer der akzeptierten Werte ist, wird eingl.INVALID_ENUM-Fehler ausgelöst. - Wenn
offsetein gültiges Vielfaches der Größe des angegebenen Typs ist, wird eingl.INVALID_OPERATION-Fehler ausgelöst. - Wenn
countnegativ ist, wird eingl.INVALID_VALUE-Fehler ausgelöst.
Beispiele
gl.drawRangeElements(gl.POINTS, 0, 7, 8, gl.UNSIGNED_BYTE, 0);
Spezifikationen
| Specification |
|---|
| WebGL 2.0 Specification> # 3.7.9> |
Browser-Kompatibilität
Loading…