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

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

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

GLVERTEXPOINTER(3G)                                                                      GLVERTEXPOINTER(3G)



NAME
       glVertexPointer - define an array of vertex data


C SPECIFICATION
       void glVertexPointer( GLint size,
                             GLenum type,
                             GLsizei stride,
                             const GLvoid *pointer )


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

       type     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.

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

       pointer  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 ren-dering. rendering.
       dering.  size specifies the number of coordinates per vertex and type the data type  of  the  coordi-nates. coordinates.
       nates.  stride specifies the byte stride from one vertex 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 a vertex array is specified, size,
       type, stride, and pointer 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 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
       glVertexPointer is available only if the GL version is 1.1 or greater.

       The vertex array is initially disabled and isn't  accessed  when  glArrayElement,  glDrawElements  or
       glDrawArrays is called.

       Execution  of  glVertexPointer  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.

       glVertexPointer is typically implemented on the client side.

       Vertex 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_VALUE is generated if size is not 2, 3, or 4.

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

       GL_INVALID_VALUE is generated if stride 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(3G), glColorPointer(3G), glDrawArrays(3G), glDrawElements(3G), glDrawRangeElements(3G), glEdgeFlagPointer(3G),
       glEnable(3G),  glGetPointerv(3G),  glIndexPointer(3G),  glInterleavedArrays(3G),  glNormalPointer(3G), glPopClientAttrib(3G),
       glPushClientAttrib(3G), glTexCoordPointer(3G)




                                                                                         GLVERTEXPOINTER(3G)