gluQuadricCallback.3   [plain text]

'\" e  
'\"macro stdmacro
.ds Vn Version 1.2
.ds Dt 6 March 1997
.ds Re Release 1.2.0
.ds Dp May 22 14:54
.ds Dm 8 May 22 14:
.ds Xs 46833     3
.TH GLUQUADRICCALLBACK 3G
.SH NAME
.B "gluQuadricCallback
\- define a callback for a quadrics object

.SH C SPECIFICATION
void \f3gluQuadricCallback\fP(
GLUquadric* \fIquad\fP,
.nf
.ta \w'\f3void \fPgluQuadricCallback( 'u
	GLenum \fIwhich\fP,
	_GLUfuncptr \fICallBackFunc\fP )
.fi

.EQ
delim $$
.EN
.SH PARAMETERS
.TP \w'\fICallBackFunc\fP\ \ 'u 
\f2quad\fP
Specifies the quadrics object (created with \%\f3gluNewQuadric\fP).
.TP
\f2which\fP
Specifies the callback being defined.
The only valid value is \%\f3GLU_ERROR\fP.
.TP
\f2CallBackFunc\fP
Specifies the function to be called.
.SH DESCRIPTION
\%\f3gluQuadricCallback\fP is used to define a new callback to be used by a quadrics object.
If the specified callback is already defined, then it is replaced. If 
\f2CallBackFunc\fP is NULL, then any existing callback is erased.
.P
The one legal callback is \%\f3GLU_ERROR\fP:
.TP 15
\%\f3GLU_ERROR\fP
The function is called when an error is encountered. Its single argument
is of type GLenum, and it indicates the specific error that occurred.
Character strings describing these errors can be retrieved with the
\%\f3gluErrorString\fP call.
.SH SEE ALSO
\%\f3gluErrorString\fP, \%\f3gluNewQuadric\fP