glDrawArrays
- render primitives from array data
void glDrawArrays(GLenum mode, GLint first, GLsizei count)
mode
Specifies what kind of primitives to render. Symbolic constants GL_POINTS
, GL_LINE_STRIP
, GL_LINE_LOOP
, GL_LINES
, GL_TRIANGLE_STRIP
, GL_TRIANGLE_FAN
, and GL_TRIANGLES
are accepted.
first
Specifies the starting index in the enabled arrays.
count
Specifies the number of indices to be rendered.
glDrawArrays
specifies multiple geometric primitives with very few subroutine calls. You can prespecify separate arrays of vertices, normals, colors, and texture coordinates and use them to construct a sequence of primitives with a single call to glDrawArrays
.
When glDrawArrays
is called, it uses count
sequential elements from each enabled array to construct a sequence of geometric primitives, beginning with element first
. mode
specifies what kind of primitives are constructed, and how the array elements construct those primitives. If GL_VERTEX_ARRAY
is not enabled, no geometric primitives are generated.
Vertex attributes that are modified by glDrawArrays
have an unspecified value after glDrawArrays
returns. For example, if GL_COLOR_ARRAY
is enabled, the value of the current color is undefined after glDrawArrays
executes. Attributes that aren't modified remain well defined.
GL_INVALID_ENUM
is generated if mode
is not an accepted value.
GL_INVALID_VALUE
is generated if count
is negative.
Copyright © 2003-2004 Silicon Graphics, Inc.
This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.
glClientActiveTexture
, glColorPointer
, glDrawElements
, glNormalPointer
, glTexCoordPointer
, glVertexPointer