*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> glDrawArrays (3)              



NAME    [Toc]    [Back]

       glDrawArrays - render primitives from array data

SYNOPSIS    [Toc]    [Back]

       void glDrawArrays(
               GLenum mode,
               GLint first,
               GLsizei count );

PARAMETERS    [Toc]    [Back]

       Specifies what kind of primitives to render. Symbolic constants
       GL_QUAD_STRIP,  GL_QUADS,  and  GL_POLYGON  are  accepted.
       Specifies the starting index in the enabled arrays.  Specifies
 the number of indices to be rendered.

DESCRIPTION    [Toc]    [Back]

       glDrawArrays()  specifies  multiple  geometric  primitives
       with  very  few  subroutine calls. Instead of calling a GL
       procedure to pass each individual vertex, normal,  texture
       coordinate, edge option, or color, you can prespecify separate
 arrays of vertexes, normals, and colors 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.

NOTES    [Toc]    [Back]

       glDrawArrays() is available only if the GL version is  1.1
       or greater.

       glDrawArrays()  is included in display lists. If glDrawArrays()
 is entered into a display list, the necessary array
       data  (determined  by  the  array pointers and enables) is
       also entered into the  display  list.  Because  the  array
       pointers  and  enables are client-side state, their values
       affect display lists when the lists are created, not  when
       the lists are executed.

ERRORS    [Toc]    [Back]

       GL_INVALID_ENUM  is  generated  if mode is not an accepted

       GL_INVALID_VALUE is generated if count is negative.

       GL_INVALID_OPERATION is  generated  if  glDrawArrays()  is
       executed between the execution of glBegin() and the corresponding

SEE ALSO    [Toc]    [Back]

       glArrayElement(3),  glColorPointer(3),  glDrawElements(3),
       glDrawRangeElements(3),  glEdgeFlagPointer(3), glGetPointerv(3), glIndexPointer(3), glInterleavedArrays(3),  glNormalPointer(3), glTexCoordPointer(3), glVertexPointer

[ Back ]
 Similar pages
Name OS Title
glarrayelementext IRIX specify the array elements used to render a vertex
glarrayelement IRIX render a vertex using the specified vertex array element
glArrayElement Tru64 render a vertex using the specified vertex array element
XmRenderTable HP-UX Data type for a render table
XmRenderTableCvtFromProp HP-UX A render table function that converts from a string representation to a render table
XmRenderTableCvtToProp HP-UX A render table function that converts a render table to a string representation
rs FreeBSD reshape a data array
rs OpenBSD reshape a data array
glvertexpointer IRIX define an array of vertex data
glVertexPointer Tru64 define an array of vertex data
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service