ANGLE_instanced_arrays: drawArraysInstancedANGLE() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since June 2016.

Die ANGLE_instanced_arrays.drawArraysInstancedANGLE() Methode der WebGL API rendert Primitive aus Array-Daten ähnlich der gl.drawArrays() Methode. Zusätzlich kann sie mehrere Instanzen des Bereichs von Elementen ausführen.

Hinweis: Bei Verwendung von WebGL2 ist diese Methode standardmäßig als gl.drawArraysInstanced() verfügbar.

Syntax

js
drawArraysInstancedANGLE(mode, first, count, primcount)

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 wieder 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.
first

Ein GLint, das den Startindex im Array der Vektorpunkte angibt.

count

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

primcount

Ein GLsizei, das die Anzahl der auszuführenden Instanzen des Bereichs von Elementen angibt.

Rückgabewert

Keiner (undefined).

Ausnahmen

  • Wenn mode nicht einer der akzeptierten Werte ist, wird ein gl.INVALID_ENUM Fehler ausgelöst.
  • Wenn first, count oder primcount negativ sind, wird ein gl.INVALID_VALUE Fehler ausgelöst.
  • Wenn gl.CURRENT_PROGRAM null ist, wird ein gl.INVALID_OPERATION Fehler ausgelöst.

Beispiele

js
const ext = gl.getExtension("ANGLE_instanced_arrays");
ext.drawArraysInstancedANGLE(gl.POINTS, 0, 8, 4);

Spezifikationen

Specification
WebGL ANGLE_instanced_arrays Khronos Ratified Extension Specification

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch