Index for Section 3G

Alphabetical listing for G

Bottom of page

glEdgeFlagPointer(3G)
NAME
  glEdgeFlagPointer - define an array of edge options

SYNOPSIS
  void glEdgeFlagPointer(
	  GLsizei stride,
	  const GLboolean *pointer );

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

  pointer
      Specifies a pointer to the first edge option in the array. The initial
      value is zero.

DESCRIPTION
  glEdgeFlagPointer() specifies the location and data of an array of boolean
  edge options to use when rendering.  stride specifies the byte stride from
  one edge option 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 option array is specified, stride and pointer are saved as
  client-side state.

  To enable and disable the edge option array, call glEnableClientState() and
  glDisableClientState() with the argument GL_EDGE_FLAG_ARRAY. If enabled,
  the edge option 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 option 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 option 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(3), glColorPointer(3), glDrawArrays(3), glDrawElements(3),
  glEnable(3), glGetPointerv(3), glIndexPointer(3), glNormalPointer(3),
  glPopClientAttrib(3), glPushClientAttrib(3), glTexCoordPointer(3),
  glVertexPointer(3)

Index for Section 3G

Alphabetical listing for G

Top of page