C SPECIFICATION

       void GLAPIENTRY glDrawRangeElements( GLenum mode,
                                            GLuint star )

PARAMETERS

       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, GL_TRIANGLES, GL_QUAD_STRIP,
             GL_QUADS, and GL_POLYGON are accepted.

       star  Specifies the minimum array index contained in _param6(1).

       _param3
             Specifies the maximum array index contained in _param6(1).

       _param4
             Specifies the number of elements to be rendered.

       _param5
             Specifies the type of the values  in  _param4.  Must  be  one  of
             GL_UNSIGNED_BYTE, GL_UNSIGNED_SHORT, or GL_UNSIGNED_INT.

       _param6
             Specifies a pointer to the location where the indices are stored.

DESCRIPTION

       glDrawRangeElements is a restricted form of glDrawElements. mode, star,
       _param3,   and   _param4   match   the   corresponding   arguments   to
       glDrawElements, with the additional constraint that all values  in  the
       arrays _param4 must lie between star and _param3, inclusive.

       Implementations denote recommended maximum amounts of vertex and
       index  data,  which  may  be  queried  by  calling  glGet with argument
       GL_MAX_ELEMENTS_VERTICES   and   GL_MAX_ELEMENTS_INDICES.    If   _eqn-
       param3-star+1 is greater than the value of GL_MAX_ELEMENTS_VERTICES, or
       if _param4 is greater than the value of  GL_MAX_ELEMENTS_INDICES,  then
       the  call  may operate at reduced performance.  There is no requirement
       that all vertices in the range [star, _param3] be referenced.  However,
       the implementation may partially process unused vertices, reducing per-
       formance from what could be achieved with an optimal index set.

       When glDrawRangeElements is called, it uses  star  sequential  elements
       from  an  enabled array, starting at _param4 to construct a sequence of
       geometric primitives. mode specifies what kind of primitives  are  con-
       structed,  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 glDrawRangeElements have an
       unspecified value after glDrawRangeElements returns.  For  example,  if

ERRORS

       It  is  an  error for indices to lie outside the range [star, _param3],
       but implementations may not check  for  this  situation.  Such  indices
       cause implementation-dependent behavior.

       GL_INVALID_ENUM is generated if mode is not an accepted value.

       GL_INVALID_VALUE is generated if _param4 is negative.

       GL_INVALID_VALUE is generated if _param3 < star.

       GL_INVALID_OPERATION  is  generated  if glDrawRangeElements is executed
       between the execution of glBegin and the corresponding glEnd.

ASSOCIATED GETS

       glGet with argument GL_MAX_ELEMENTS_VERTICES

       glGet with argument GL_MAX_ELEMENTS_INDICES

SEE ALSO

       glArrayElement,    glColorPointer,    glDrawArrays,     glDrawElements,
       glEdgeFlagPointer,  glGetPointerv, glIndexPointer, glInterleavedArrays,
       glNormalPointer, glTexCoordPointer, glVertexPointer



                                                       GLDRAWRANGEELEMENTS(3G)