Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
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 inWeb Workers verfügbar.
DieWebGL2RenderingContext.drawRangeElements()-Methode derWebGL-API rendert Primitive aus Array-Daten in einem gegebenen Bereich.
In diesem Artikel
Syntax
drawRangeElements(mode, start, end, count, type, offset)Parameter
modeEin
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.
startEin
GLuint, der den minimalen Array-Index angibt, der inoffsetenthalten ist.endEin
GLuint, der den maximalen Array-Index angibt, der inoffsetenthalten ist.countEin
GLsizei, der die Anzahl der zu rendernden Elemente angibt.typeEin
GLenum, der den Typ der Werte im Element-Array-Puffer angibt. Mögliche Werte sind:gl.UNSIGNED_BYTEgl.UNSIGNED_SHORTgl.UNSIGNED_INT
offsetEin
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> |