WEBGL_multi_draw: Methode multiDrawArraysInstancedWEBGL()

Syntax

multiDrawArraysInstancedWEBGL(mode,
    firstsList, firstsOffset,
    countsList, countsOffset,
    instanceCountsList, instanceCountsOffset,
    drawCount)

Parameter

mode

Ein GLenum, das den Typ der zu rendernden Primitiven 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 mit dem ersten.
• gl.LINES: Zeichnet eine Linie zwischen zwei Vertices.
• gl.TRIANGLE_STRIP
• gl.TRIANGLE_FAN
• gl.TRIANGLES: Zeichnet ein Dreieck aus einer Gruppe von drei Vertices.

firstsList

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

firstsOffset

Ein GLuint, das den Startpunkt im Array firstsLists festlegt.

countsList

Ein Int32Array oder Array aus GLsizei-Werten, das eine Liste der Anzahlen der zu rendernden Indizes angibt.

countsOffset

Ein GLuint, das den Startpunkt im Array countsList festlegt.

instanceCountsList

Ein Int32Array oder Array aus GLsizei-Werten, das eine Liste der Anzahlen von Instanzen des auszuführenden Elementbereichs angibt.

instanceCountsOffset

Ein GLuint, das den Startpunkt im Array instanceCountsList festlegt.

drawCount

Ein GLsizei, das die Anzahl der Instanzen des auszuführenden 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 firstsList, countsList oder instanceCountsList negativ sind, wird ein gl.INVALID_VALUE-Fehler ausgelöst.
• Wenn gl.CURRENT_PROGRAM den Wert null hat, wird ein gl.INVALID_OPERATION-Fehler ausgelöst.

Beispiele

const firsts = new Int32Array(/* … */);
const counts = new Int32Array(/* … */);
const instanceCounts = new Int32Array(/* … */);
ext.multiDrawArraysInstancedWEBGL(
  gl.TRIANGLES,
  firsts,
  0,
  counts,
  0,
  instanceCounts,
  0,
  firsts.length,
);

Spezifikationen

Browser-Kompatibilität

Siehe auch

• WebGLRenderingContext.drawArrays()
• WebGL2RenderingContext.drawArraysInstanced()