glEdgeFlagPointer(3gl)

1GLEDGEFLAGPOINTER(3G)                                    GLEDGEFLAGPOINTER(3G)
2
3
4

NAME

6       glEdgeFlagPointer - define an array of edge flags
7
8

C SPECIFICATION

10       void glEdgeFlagPointer( GLsizei stride,
11                               const GLvoid *ptr )
12
13

PARAMETERS

15       stride  Specifies  the  byte offset between consecutive edge flags.  If
16               stride is 0 (the initial value), the edge flags are  understood
17               to be tightly packed in the array. The initial value is 0.
18
19       ptr     Specifies  a  pointer  to the first edge flag in the array. The
20               initial value is zero.
21

DESCRIPTION

23       glEdgeFlagPointer specifies the location and data  of an array of bool‐
24       ean  edge flags to use when rendering. stride specifies the byte stride
25       from one edge flag to the next allowing vertices and attributes  to  be
26       packed into a single array or stored in separate arrays.  (Single-array
27       storage  may  be  more   efficient   on   some   implementations;   see
28       glInterleavedArrays.)
29
30       When  an  edge  flag  array  is  specified, stride and ptr are saved as
31       client-side state.
32
33       To enable and disable the edge flag array, call glEnableClientState and
34       glDisableClientState with the argument GL_EDGE_FLAG_ARRAY. If  enabled,
35       the  edge  flag  array  is  used  when glDrawArrays, glDrawElements, or
36       glArrayElement is called.
37
38       Use glDrawArrays to construct a sequence of primitives (all of the same
39       type)  from  prespecified  vertex  and  vertex  attribute  arrays.  Use
40       glArrayElement to specify primitives by indexing  vertices  and  vertex
41       attributes  and glDrawElements to construct a sequence of primitives by
42       indexing vertices and vertex attributes.
43

NOTES

45       glEdgeFlagPointer is available  only  if  the  GL  version  is  1.1  or
46       greater.
47
48       The edge flag array is initially disabled and it won't be accessed when
49       glArrayElement, glDrawElements or glDrawArrays is called.
50
51       Execution  of glEdgeFlagPointer is not allowed between the execution of
52       glBegin and the corresponding execution of glEnd, but an error  may  or
53       may  not be generated. If no error is generated, the operation is unde‐
54       fined.
55
56       glEdgeFlagPointer is typically implemented on the client side.
57
58       Edge flag array parameters are client-side state and are therefore  not
59       saved    or    restored   by   glPushAttrib   and   glPopAttrib.    Use
60       glPushClientAttrib and
61       glPopClientAttrib instead.
62

ERRORS

64       GL_INVALID_ENUM is generated if stride is negative.
65

ASSOCIATED GETS

67       glIsEnabled with argument GL_EDGE_FLAG_ARRAY
68       glGet with argument GL_EDGE_FLAG_ARRAY_STRIDE
69       glGetPointerv with argument GL_EDGE_FLAG_ARRAY_POINTER
70