GLEDGEFLAGPOINTER(3G)UNIX Programmer's ManuaGLEDGEFLAGPOINTER(3G)
NAME
glEdgeFlagPointer - define an array of edge flags
C SPECIFICATION
void glEdgeFlagPointer( GLsizei stride,
const GLvoid *ptr )
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. The initial value is 0.
ptr Specifies a pointer to the first edge flag in the
array. The initial value is zero.
DESCRIPTION
glEdgeFlagPointer specifies the location and data of an
array of boolean edge flags to use when rendering. stride
specifies the byte stride from one edge flag to the next
allowing vertices 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 ptr 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 attri-
bute arrays. Use glArrayElement to specify primitives by
indexing vertices and vertex attributes and glDrawElements
to construct a sequence of primitives by indexing vertices
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.
MirBSD #10-current Printed 2021-12-07 1
GLEDGEFLAGPOINTER(3G)UNIX Programmer's ManuaGLEDGEFLAGPOINTER(3G)
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
SEE ALSO
glArrayElement(3G), glColorPointer(3G), glDrawArrays(3G),
glDrawElements(3G), glEnable(3G), glGetPointerv(3G),
glIndexPointer(3G), glNormalPointer(3G),
glPopClientAttrib(3G),
glPushClientAttrib(3G), glTexCoordPointer(3G),
glVertexPointer(3G)
MirBSD #10-current Printed 2021-12-07 2