WEBGL_multi_draw: Methode multiDrawElementsWEBGL()

Syntax

multiDrawElementsWEBGL(mode,
    countsList, countsOffset,
    type,
    firstsList, firstsOffset,
    drawCount)

Parameter

mode

Ein GLenum, das 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 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 zwei Vertices.
• gl.TRIANGLE_STRIP
• gl.TRIANGLE_FAN
• gl.TRIANGLES: Zeichnet ein Dreieck für eine Gruppe von drei Vertices.

countsList

Ein Int32Array oder Array aus GLint-Werten, das eine Liste mit der Anzahl der jeweils zu rendernden Indizes angibt.

countsOffset

Ein GLUint, das die Startposition im Array countsList festlegt.

type

Ein GLenum, das den Typ der Werte im Element-Array-Buffer angibt. Mögliche Werte sind:

• gl.UNSIGNED_BYTE
• gl.UNSIGNED_SHORT
• Bei Verwendung der Erweiterung OES_element_index_uint:
  • gl.UNSIGNED_INT

offsetsList

Ein Int32Array oder Array aus GLsizei-Werten, das eine Liste von Startindizes für die Arrays der Vektorpunkte angibt.

offsetsOffset

Ein GLuint, das die Startposition im Array offsetsList festlegt.

drawCount

Ein GLsizei, das die Anzahl der auszuführenden Instanzen des Elementbereichs angibt.

Rückgabewert

Keiner.

Ausnahmen

• Wenn mode keiner der zulässigen Werte ist, wird ein gl.INVALID_ENUM-Fehler ausgelöst.
• Wenn drawCount oder Einträge in countsList oder offsetsList negativ sind, wird ein gl.INVALID_VALUE-Fehler ausgelöst.

Beispiele

const counts = new Int32Array(/* … */);
const offsets = new Int32Array(/* … */);
ext.multiDrawElementsWEBGL(
  gl.TRIANGLES,
  counts,
  0,
  gl.UNSIGNED_SHORT,
  offsets,
  0,
  counts.length,
);

Spezifikationen

Browser-Kompatibilität

Siehe auch

• WebGLRenderingContext.drawElements()
• WebGL2RenderingContext.drawElementsInstanced()