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.

We'd love to hear more about your role and the company you work for
Please help us by answering a few questions.

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

js
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 im offset angibt.

end

Ein GLuint, das den maximalen Array-Index im offset 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 angegebenen type sein.

Rückgabewert

Keiner (undefined).

Ausnahmen

  • Wenn mode nicht einer der akzeptierten Werte ist, wird ein gl.INVALID_ENUM-Fehler ausgelöst.
  • Wenn offset ein gültiges Vielfaches der Größe des angegebenen Typs ist, wird ein gl.INVALID_OPERATION-Fehler ausgelöst.
  • Wenn count negativ ist, wird ein gl.INVALID_VALUE-Fehler ausgelöst.

Beispiele

js
gl.drawRangeElements(gl.POINTS, 0, 7, 8, gl.UNSIGNED_BYTE, 0);

Spezifikationen

Specification
WebGL 2.0 Specification
# 3.7.9

Browser-Kompatibilität

Siehe auch