glEdgeFlagPointer(3G)

NAME
     glEdgeFlagPointer - define an array of edge flags


C SPECIFICATION
     void glEdgeFlagPointer( GLsizei stride,
                             const GLboolean *pointer )


PARAMETERS
     stride   Specifies the byte offset between consecutive edge flags.  If
              stride is 0 (the initial value), the edge flags are understood
              to be tightly packed in the array.

     pointer  Specifies a pointer to the first edge flag in the array.

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

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

     To enable and disable the edge flag array, call glEnableClientState and
     glDisableClientState with the argument GL_EDGE_FLAG_ARRAY. If enabled,
     the edge flag 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
     glEdgeFlagPointer is available only if the GL version is 1.1 or greater.

     The edge flag 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 flag array parameters are client-side state and are therefore not
     saved or restored by glPushAttrib and glPopAttrib.  Use
     glPushClientAttrib and glPopClientAttrib instead.

ERRORS
     GL_INVALID_ENUM is generated if stride is negative.

ASSOCIATED GETS
     glIsEnabled with argument GL_EDGE_FLAG_ARRAY
     glGet with argument GL_EDGE_FLAG_ARRAY_STRIDE
     glGetPointerv with argument GL_EDGE_FLAG_ARRAY_POINTER


MACHINE DEPENDENCIES
     On RealityEngine, RealityEngine2, and VTX systems, do not enable or
     disable GL_VERTEX_ARRAY, GL_VERTEX_ARRAY_EXT, GL_NORMAL_ARRAY,
     GL_NORMAL_ARRAY_EXT, GL_COLOR_ARRAY, GL_COLOR_ARRAY_EXT,
     GL_INDEX_ARRAY,GL_INDEX_ARRAY_EXT, GL_TEXTURE_COORD_ARRAY,
     GL_TEXTURE_COORD_ARRAY_EXT, GL_EDGE_FLAG_ARRAY or GL_EDGE_FLAG_ARRAY_EXT
     between a call to glNewList and the corresponding call to glEndList.
     Instead, enable or disable before the call to glNewList.


SEE ALSO
     glArrayElement, glColorPointer, glDrawArrays, glDrawElements, glEnable,
     glGetPointerv, glIndexPointer, glNormalPointer, glPopClientAttrib,
     glPushClientAttrib, glTexCoordPointer, glVertexPointer