Name

glGetPointerv — return the address of the specified pointer

C Specification

void glGetPointerv(GLenum pname,
 GLvoid ** params);
 

Parameters

pname

Specifies the array or buffer pointer to be returned. Accepted symbolic names are GL_COLOR_ARRAY_POINTER, GL_NORMAL_ARRAY_POINTER, GL_POINT_SIZE_ARRAY_POINTER_OES, GL_TEXTURE_COORD_ARRAY_POINTER, and GL_VERTEX_ARRAY_POINTER.

params

Returns the pointer value specified by pname.

Description

glGetPointerv returns pointer information. pname is a symbolic constant indicating the pointer to be returned, and params is a pointer to a location in which to place the returned data.

Querying the GL_TEXTURE_COORD_ARRAY_POINTER returns the value for the active client texture unit.

If a non-zero named buffer object was bound to the GL_ARRAY_BUFFER target (see glBindBuffer) when the desired pointer was previously specified, the pointer returned is a byte offset into the buffer object's data store.

Notes

glGetPointerv is only supported if the OpenGL ES version number is 1.1 or greater.

The pointers are all client-side state.

The initial value for each pointer is 0.

Errors

GL_INVALID_ENUM is generated if pname is not an accepted value.

See Also

glBindBuffer, glClientActiveTexture, glColorPointer, glDrawArrays, glMatrixIndexPointer, glNormalPointer, glTexCoordPointer, glPointSizePointerOES, glVertexPointer

Copyright

Copyright © 2003-2004 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.