WebGLRenderingContext: drawArrays()-Methode

Syntax

drawArrays(mode, first, count)

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 Vertex.
• gl.LINE_LOOP: Zeichnet eine gerade Linie zum nächsten Vertex und verbindet den letzten Vertex zurück zum 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.

Hinweis: Wenn mode POINTS ist, muss möglicherweise gl_PointSize gesetzt werden, damit drawArrays rendert, da sein Wert unbekannt ist, wenn er nicht explizit geschrieben wird. Nur einige GPUs setzen seinen Standardwert auf 1.0.

first

Ein GLint, der den Startindex im Array von Vektor-Punkten angibt.

count

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

Rückgabewert

Keine (undefined).

Ausnahmen

• Wenn mode nicht einer der akzeptierten Werte ist, wird ein gl.INVALID_ENUM-Fehler ausgelöst.
• Wenn first oder count 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

gl.drawArrays(gl.POINTS, 0, 8);

Spezifikationen

Browser-Kompatibilität

Siehe auch

• WebGLRenderingContext.drawElements()
• ext.drawArraysInstancedANGLE()
• ext.drawElementsInstancedANGLE()
• ext.vertexAttribDivisorANGLE()
• WebGL2RenderingContext.drawArraysInstanced()
• WebGL2RenderingContext.drawElementsInstanced()
• WebGL2RenderingContext.vertexAttribDivisor()
• WEBGL_multi_draw.multiDrawArraysWEBGL()