WebGL2RenderingContext: Methode drawArraysInstanced()

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.drawArraysInstanced() Methode der WebGL 2 API rendert Primitive aus Array-Daten wie die gl.drawArrays() Methode. Zusätzlich kann sie mehrere Instanzen des Elementbereichs ausführen.

Hinweis: Bei Verwendung von WebGL 1 kann die ANGLE_instanced_arrays Erweiterung diese Methode ebenfalls bereitstellen.

Syntax

js
drawArraysInstanced(mode, first, count, instanceCount)

Parameter

mode

Ein GLenum, das den zu rendernden Primitivtyp 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 wieder mit dem ersten.
  • gl.LINES: Zeichnet eine Linie zwischen einem Paar von Vertices.
  • gl.TRIANGLE_STRIP
  • gl.TRIANGLE_FAN
  • gl.TRIANGLES: Zeichnet ein Dreieck für eine Gruppe von drei Vertices.
first

Ein GLint, der den Startindex im Array von Vektorpunkten angibt.

count

Ein GLsizei, der die Anzahl der zu rendernden Indizes angibt.

instanceCount

Ein GLsizei, der angibt, wie viele Instanzen des Elementbereichs ausgeführt werden sollen.

Rückgabewert

Keiner (undefined).

Beispiele

js
gl.drawArraysInstanced(gl.POINTS, 0, 8, 4);

Spezifikationen

Specification
WebGL 2.0 Specification
# 3.7.9

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch