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 angegebenen Bereich.
Syntax
drawRangeElements(mode, start, end, count, type, offset)
Parameter
mode
-
Ein
GLenum
, das den Typ des zu rendernden Primitives 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 mit dem ersten.gl.LINES
: Zeichnet eine Linie zwischen einem Paar von Scheitelpunkten.gl.TRIANGLE_STRIP
gl.TRIANGLE_FAN
gl.TRIANGLES
: Zeichnet ein Dreieck für eine Gruppe von drei Scheitelpunkten.
start
-
Ein
GLuint
, das den minimalen Array-Index imoffset
angibt. end
-
Ein
GLuint
, das den maximalen Array-Index imoffset
angibt. count
-
Ein
GLsizei
, das 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_BYTE
gl.UNSIGNED_SHORT
gl.UNSIGNED_INT
offset
-
Ein
GLintptr
, der einen Offset im Element-Array-Puffer angibt. Muss ein gültiges Vielfaches der Größe des angegebenentype
sein.
Rückgabewert
Keiner (undefined
).
Ausnahmen
- Wenn
mode
nicht einer der akzeptierten Werte ist, wird eingl.INVALID_ENUM
-Fehler ausgelöst. - Wenn
offset
ein gültiges Vielfaches der Größe des angegebenen Typs ist, wird eingl.INVALID_OPERATION
-Fehler ausgelöst. - Wenn
count
negativ 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
BCD tables only load in the browser