NAME    [Toc]    [Back]

       glEdgeFlagPointer - define an array of edge options

SYNOPSIS    [Toc]    [Back]

       void glEdgeFlagPointer(
               GLsizei stride,
               const GLboolean *pointer );

PARAMETERS    [Toc]    [Back]

       Specifies   the   byte  offset  between  consecutive  edge
       options. If stride is 0  (the  initial  value),  the  edge
       options  are understood to be tightly packed in the array.
       The initial value is 0.  Specifies a pointer to the  first
       edge option in the array. The initial value is zero.

DESCRIPTION    [Toc]    [Back]

       glEdgeFlagPointer()  specifies the location and data of an
       array of boolean  edge  options  to  use  when  rendering.
       stride  specifies  the byte stride from one edge option to
       the next allowing vertexes and  attributes  to  be  packed
       into a single array or stored in separate arrays. (Singlearray
 storage may be more efficient  on  some  implementations;
 see glInterleavedArrays().)

       When an edge option array is specified, stride and pointer
       are saved as client-side state.

       To enable and disable the edge option  array,  call  glEnableClientState()
   and  glDisableClientState()  with  the
       argument GL_EDGE_FLAG_ARRAY. If enabled, the  edge  option
       array  is  used  when glDrawArrays(), glDrawElements(), or
       glArrayElement() is called.

       Use glDrawArrays() to construct a sequence  of  primitives
       (all of the same type) from prespecified vertex and vertex
       attribute arrays.  Use glArrayElement() to specify  primitives
  by  indexing  vertexes  and  vertex  attributes and
       glDrawElements() to construct a sequence of primitives  by
       indexing vertexes and vertex attributes.

NOTES    [Toc]    [Back]

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

       The edge option array is initially disabled and  it  won't
       be  accessed  when  glArrayElement(),  glDrawElements() or
       glDrawArrays() is called.

       Execution of glEdgeFlagPointer() is  not  allowed  between
       the execution of glBegin() and the corresponding execution
       of glEnd(), but an error may or may not be  generated.  If
       no error is generated, the operation is undefined.

       glEdgeFlagPointer() is typically implemented on the client
       side.

       Edge option array parameters are client-side state and are
       therefore  not  saved  or  restored  by glPushAttrib() and
       glPopAttrib(). Use glPushClientAttrib() and glPopClientAttrib()
 instead.

ERRORS    [Toc]    [Back]

       GL_INVALID_ENUM is generated if stride is negative.

ASSOCIATED GETS    [Toc]    [Back]

       glIsEnabled() with argument GL_EDGE_FLAG_ARRAY
       glGet() with argument GL_EDGE_FLAG_ARRAY_STRIDE
       glGetPointerv() with argument GL_EDGE_FLAG_ARRAY_POINTER

SEE ALSO    [Toc]    [Back]

       glArrayElement(3),   glColorPointer(3),   glDrawArrays(3),
       glDrawElements(3), glEnable(3), glGetPointerv(3), glIndexPointer(3),    glNormalPointer(3),   glPopClientAttrib(3),
       glPushClientAttrib(3),   glTexCoordPointer(3),   glVertexPointer(3)



                                            glEdgeFlagPointer(3G)