glGetPointerv.3   [plain text]


'\" te  
'\"macro stdmacro
.ds Vn Version 1.2
.ds Dt 24 September 1999
.ds Re Release 1.2.1
.ds Dp May 22 14:45
.ds Dm 4 May 22 14:
.ds Xs 38346     4
.TH GLGETPOINTERV 3G
.SH NAME
.B "glGetPointerv
\- return the address of the specified pointer

.SH C SPECIFICATION
void \f3glGetPointerv\fP(
GLenum \fIpname\fP,
.nf
.ta \w'\f3void \fPglGetPointerv( 'u
	GLvoid* \fI*params\fP )
.fi

.EQ
delim $$
.EN
.SH PARAMETERS
.TP \w'\fIparams\fP\ \ 'u 
\f2pname\fP
Specifies the array or buffer pointer to be returned.
Symbolic constants
\%\f3GL_COLOR_ARRAY_POINTER\fP,
\%\f3GL_EDGE_FLAG_ARRAY_POINTER\fP,
\%\f3GL_FEEDBACK_BUFFER_POINTER\fP,
\%\f3GL_INDEX_ARRAY_POINTER\fP,
\%\f3GL_NORMAL_ARRAY_POINTER\fP,
\%\f3GL_TEXTURE_COORD_ARRAY_POINTER\fP,
\%\f3GL_SELECTION_BUFFER_POINTER\fP,
and
\%\f3GL_VERTEX_ARRAY_POINTER\fP
are accepted. 
.TP
\f2params\fP
Returns the pointer value specified by \f2pname\fP.
.SH DESCRIPTION
\%\f3glGetPointerv\fP returns pointer information. \f2pname\fP 
is a symbolic constant indicating the pointer to be returned, and
\f2params\fP is a pointer to a location in which to place the returned data. 
.SH NOTES
\%\f3glGetPointerv\fP is available only if the GL version is 1.1 or greater.
.P
The pointers are all client-side state.
.P
The initial value for each pointer is 0. 
.P
When the \%\f3GL_ARB_multitexture\fP extension is supported, querying the
\%\f3GL_TEXTURE_COORD_ARRAY_POINTER\fP returns the value for the active
client texture unit.
.SH ERRORS
\%\f3GL_INVALID_ENUM\fP is generated if \f2pname\fP is not an accepted value.
.SH SEE ALSO 
\%\f3glArrayElement\fP,
\%\f3glClientActiveTextureARB\fP,
\%\f3glColorPointer\fP,
\%\f3glDrawArrays\fP,
\%\f3glEdgeFlagPointer\fP,
\%\f3glFeedbackBuffer\fP,
\%\f3glIndexPointer\fP,
\%\f3glInterleavedArrays\fP,
\%\f3glNormalPointer\fP,
\%\f3glSelectBuffer\fP,
\%\f3glTexCoordPointer\fP,
\%\f3glVertexPointer\fP