Страницы справочника OS X

Эта страница руководства является частью версии 5.0 Инструментов XCode

Читать страницы руководства

GLEDGEFLAGPOINTER(3G)                                                                  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. The  initial  value
                is 0.

       pointer  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 ren-dering. rendering.
       dering. 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 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 ver-tex vertex
       tex and vertex attribute 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.

       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)




                                                                                       GLEDGEFLAGPOINTER(3G)