- define an array of vertex data



C SPECIFICATION


PARAMETERS

       _param1  Specifies  the  number of coordinates per vertex;
                must be 2, 3, or 4. The initial value is 4.

       _param2  Specifies the data type of each coordinate in the
                array.    Symbolic  constants  GL_SHORT,  GL_INT,
                GL_FLOAT, and GL_DOUBLE are accepted. The initial
                value is GL_FLOAT.

       _param3  Specifies  the  byte  offset  between consecutive
                vertexes. If  _param3  is  0,  the  vertexes  are
                understood to be tightly packed in the array. The
                initial value is 0.

       _param4  Specifies a pointer to the  first  coordinate  of
                the  first vertex in the array. The initial value
                is 0.


DESCRIPTION

       glVertexPointer specifies the location  and  data   of  an
       array   of  vertex  coordinates  to  use  when  rendering.
       _param1 specifies the number of coordinates per vertex and
       _param2  the  data type of the coordinates. _param3 speci-
       fies the byte stride from one vertex 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 a vertex array  is  specified,
       _param1,  _param2,  _param3,  and  _param4  are  saved  as
       client-side state.

       To   enable   and   disable   the   vertex   array,   call
       glEnableClientState and
       glDisableClientState with the argument GL_VERTEX_ARRAY. If
       enabled, the  vertex  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 primi-
       tives by indexing  vertexes  and  vertex  attributes   and
       glDrawElements  to  construct  a sequence of primitives by
       indexing vertexes and vertex attributes.


NOTES

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

       glPopAttrib.  Use glPushClientAttrib and glPopClientAttrib
       instead.


ERRORS

       GL_INVALID_VALUE is generated if _param1 is not 2,  3,  or
       4.

       GL_INVALID_ENUM  is  generated  if  _param2  is  is not an
       accepted value.

       GL_INVALID_VALUE is generated if _param3 is negative.


ASSOCIATED GETS

       glIsEnabled with argument GL_VERTEX_ARRAY
       glGet with argument GL_VERTEX_ARRAY_SIZE
       glGet with argument GL_VERTEX_ARRAY_TYPE
       glGet with argument GL_VERTEX_ARRAY_STRIDE
       glGetPointerv with argument GL_VERTEX_ARRAY_POINTER


SEE ALSO

       glArrayElement,       glColorPointer,        glDrawArrays,
       glDrawElements,   glDrawRangeElements,  glEdgeFlagPointer,
       glEnable,          glGetPointerv,          glIndexPointer,
       glInterleavedArrays,  glNormalPointer,  glPopClientAttrib,
       glPushClientAttrib, glTexCoordPointer



                                                                1