-  simultaneously  specify  and enable several interleaved
       arrays



C SPECIFICATION


PARAMETERS

       _param1  Specifies the type of array to  enable.  Symbolic
                constants     GL_V2F,     GL_V3F,    GL_C4UB_V2F,
                GL_C4UB_V3F,       GL_C3F_V3F,        GL_N3F_V3F,
                GL_C4F_N3F_V3F,      GL_T2F_V3F,      GL_T4F_V4F,
                GL_T2F_C4UB_V3F, GL_T2F_C3F_V3F,  GL_T2F_N3F_V3F,
                GL_T2F_C4F_N3F_V3F,  and  GL_T4F_C4F_N3F_V4F  are
                accepted.

       _param2  Specifies the offset in bytes between each aggre-
                gate array element.


DESCRIPTION

       glInterleavedArrays lets you specify and enable individual
       color, normal, texture and vertex  arrays  whose  elements
       are  part  of  a larger aggregate array element.  For some
       implementations, this is more  efficient  than  specifying
       the arrays separately.

       If _param2 is 0, the aggregate elements are stored consec-
       utively.   Otherwise,  _param2  bytes  occur  between  the
       beginning of one aggregate array element and the beginning
       of the next aggregate array element.

       _param1 serves as a ``key'' describing the  extraction  of
       individual  arrays  from  the aggregate array.  If _param1
       contains a T, then texture coordinates are extracted  from
       the  interleaved array.  If C is present, color values are
       extracted.  If  N  is  present,  normal  coordinates   are
       extracted.  Vertex coordinates are always extracted.

       The  digits  2,  3,  and  4  denote  how  many  values are
       extracted.  F  indicates  that  values  are  extracted  as
       floating-point  values.  Colors may also be extracted as 4
       unsigned bytes if 4UB  follows  the  C.   If  a  color  is
       extracted  as  4  unsigned bytes, the vertex array element
       which follows is located at the first  possible  floating-
       point aligned address.


NOTES

       glInterleavedArrays is available only if the GL version is
       1.1 or greater.

       If glInterleavedArrays is called while compiling a display
       list, it is not compiled into the list, and it is executed
       immediately.

       glInterleavedArrays only updates  the  texture  coordinate
       array  for  the  active  active  texture unit. The texture
       coordinate state for other client  texture  units  is  not
       update, regardless if they are enabled or not.


ERRORS

       GL_INVALID_ENUM is generated if _param1 is not an accepted
       value.

       GL_INVALID_VALUE is generated if _param2 is negative.


SEE ALSO

       glArrayElement, glClientActiveTextureARB,  glColorPointer,
       glDrawArrays,      glDrawElements,      glEdgeFlagPointer,
       glEnableClientState,     glGetPointer,     glIndexPointer,
       glNormalPointer, glTexCoordPointer, glVertexPointer



                                                                1