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

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



NAME    [Toc]    [Back]

       glDrawElements - render primitives from array data

SYNOPSIS    [Toc]    [Back]

       void glDrawElements(
               GLenum mode,
               GLsizei count,
               GLenum type,
               const GLvoid *indices );

PARAMETERS    [Toc]    [Back]

       Specifies what kind of primitives to render. Symbolic constants
       GL_QUAD_STRIP,  GL_QUADS,  and  GL_POLYGON  are  accepted.
       Specifies  the  number of elements to be rendered.  Specifies
 the type of the values in indices.  Must  be  one  of
       Specifies a pointer to the location where the indices  are

DESCRIPTION    [Toc]    [Back]

       glDrawElements()  specifies  multiple geometric primitives
       with very few subroutine calls. Instead of  calling  a  GL
       function  to  pass each individual vertex, normal, texture
       coordinate, edge option, or color, you can prespecify separate
  arrays of vertexes, normals, and so on and use them
       to construct a sequence of primitives with a  single  call
       to glDrawElements().

       When  glDrawElements() is called, it uses count sequential
       elements from an enabled array,  starting  at  indices  to
       construct a sequence of geometric primitives.  mode specifies
 what kind of primitives are constructed, and how  the
       array  elements  construct  these primitives. If more than
       one array is enabled, each is used. If GL_VERTEX_ARRAY  is
       not enabled, no geometric primitives are constructed.

       Vertex  attributes  that  are modified by glDrawElements()
       have an unspecified value after glDrawElements()  returns.
       For  example,  if  GL_COLOR_ARRAY is enabled, the value of
       the current color is undefined after glDrawElements() executes.
   Attributes  that  aren't  modified maintain their
       previous values.

NOTES    [Toc]    [Back]

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

       glDrawElements()   is   included   in  display  lists.  If
       glDrawElements() 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  glDrawElements()  is
       executed between the execution of glBegin() and the corresponding

SEE ALSO    [Toc]    [Back]

       glArrayElement(3),   glColorPointer(3),   glDrawArrays(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