1991-2006
Silicon Graphics, Inc.
glGetPointerv
3G

# 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. Symbolic constants `GL_COLOR_ARRAY_POINTER`, `GL_EDGE_FLAG_ARRAY_POINTER`, `GL_FOG_COORD_ARRAY_POINTER`, `GL_FEEDBACK_BUFFER_POINTER`, `GL_INDEX_ARRAY_POINTER`, `GL_NORMAL_ARRAY_POINTER`, `GL_SECONDARY_COLOR_ARRAY_POINTER`, `GL_SELECTION_BUFFER_POINTER`, `GL_TEXTURE_COORD_ARRAY_POINTER`, or `GL_VERTEX_ARRAY_POINTER` are accepted.

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

For all `pname` arguments except `GL_FEEDBACK_BUFFER_POINTER` and `GL_SELECTION_BUFFER_POINTER`, 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. Buffer objects are only available in OpenGL versions 1.5 and greater.

## Notes

`glGetPointerv` is available only if the GL version is 1.1 or greater.

`GL_FOG_COORD_ARRAY_POINTER` and `GL_SECONDARY_COLOR_ARRAY_POINTER` are available only if the GL version is 1.4 or greater.

The pointers are all client-side state.

The initial value for each pointer is 0.

For OpenGL versions 1.3 and greater, or when the `ARB_multitexture` extension is supported, querying the `GL_TEXTURE_COORD_ARRAY_POINTER` returns the value for the active client texture unit.

## Errors

`GL_INVALID_ENUM` is generated if `pname` is not an accepted value.

## See Also

glBindBuffer, glClientActiveTexture, glColorPointer, glEdgeFlagPointer, glFogCoordPointer, glFeedbackBuffer, glGetVertexAttribPointerv, glIndexPointer, glNormalPointer, glSecondaryColorPointer, glSelectBuffer, glTexCoordPointer, glVertexAttribPointer, glVertexPointer

## Copyright

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