WEBGL_multi_draw: multiDrawElementsInstancedWEBGL() Methode

Syntax

multiDrawElementsInstancedWEBGL(mode,
    countsList, countsOffset,
    type,
    firstsList, firstsOffset,
    instanceCountsList, instanceCountsOffset,
    drawCount)

Parameter

mode

Ein GLenum, der den Typ des Primitivs festlegt, das gerendert werden soll. 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 einem Paar von Vertices.
• gl.TRIANGLE_STRIP
• gl.TRIANGLE_FAN
• gl.TRIANGLES: Zeichnet ein Dreieck für eine Gruppe von drei Vertices.

countsList

Ein Int32Array oder Array (von GLint), das eine Liste von Anzahlen von Indizes, die gerendert werden sollen, angibt.

countsOffset

Ein GLUint, der den Startpunkt in das countsList Array definiert.

type

Ein GLenum, der den Typ der Werte im Element-Array-Puffer festlegt. Mögliche Werte sind:

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

offsetsList

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

offsetsOffset

Ein GLuint, der den Startpunkt in das offsetsList Array definiert.

instanceCountsList

Ein Int32Array oder Array (von GLsizei), das eine Liste von Anzahlen von Instanzen des Bereichs von Elementen, die ausgeführt werden sollen, angibt.

instanceCountsOffset

Ein GLuint, der den Startpunkt in das instanceCountsList Array definiert.

drawCount

Ein GLsizei, das die Anzahl der Instanzen des Bereichs von Elementen, die ausgeführt werden sollen, angibt.

Rückgabewert

Keiner.

Ausnahmen

• Wenn mode nicht einer der akzeptierten Werte ist, wird ein gl.INVALID_ENUM Fehler ausgelöst.
• Wenn drawCount oder Elemente in countsList, offsetsList oder instanceCountsList negativ sind, wird ein gl.INVALID_VALUE Fehler ausgelöst.

Beispiele

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

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