Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ gledgeflagpointer(3G) — IRIX 6.5.3f

Media Vault

Software Library

Restoration Projects

Artifacts Sought



glEdgeFlagPointer(3G)          OpenGL Reference          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 GLEDGEFLAGARRAY. 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.






                                                                        Page 1





glEdgeFlagPointer(3G)          OpenGL Reference          glEdgeFlagPointer(3G)



     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
     GLINVALIDENUM is generated if stride is negative.

ASSOCIATED GETS
     glIsEnabled with argument GLEDGEFLAGARRAY
     glGet with argument GLEDGEFLAGARRAYSTRIDE
     glGetPointerv with argument GLEDGEFLAGARRAYPOINTER


MACHINE DEPENDENCIES
     On RealityEngine, RealityEngine2, and VTX systems, do not enable or
     disable GLVERTEXARRAY, GLVERTEXARRAYEXT, GLNORMALARRAY,
     GLNORMALARRAYEXT, GLCOLORARRAY, GLCOLORARRAYEXT,
     GLINDEXARRAY,GLINDEXARRAYEXT, GLTEXTURECOORDARRAY,
     GLTEXTURECOORDARRAYEXT, GLEDGEFLAGARRAY or GLEDGEFLAGARRAYEXT
     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




























                                                                        Page 2



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026