summaryrefslogtreecommitdiff
path: root/doc/gl-docs/GLU/errorstring.3gl
blob: 31207ae7a0590194e54f4b3f7f01d8db6f6789c8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
'\" e
'\"! eqn | mmdoc
'\"macro stdmacro
.ds Vn Version 1.2
.ds Dt 6 March 1997
.ds Re Release 1.2.0
.ds Dp May 02 11:53
.ds Dm 37 errorstri
.ds Xs 24940 3 errorstring.gl
.TH GLUERRORSTRING 3G
.SH NAME
.B "gluErrorString
\- produce an error string from a GL or GLU error code

.SH C SPECIFICATION
const GLubyte * \f3gluErrorString\fP(
GLenum \fIerror\fP )
.nf
.fi

.EQ
delim $$
.EN
.SH PARAMETERS
.TP \w'\f2error\fP\ \ 'u 
\f2error\fP
Specifies a GL or GLU error code.
.SH DESCRIPTION
\%\f3gluErrorString\fP produces an error string from a GL or GLU error code. The string
is in ISO Latin 1 . For example,
\%\f3gluErrorString\fP(\%\f3GL_OUT_OF_MEMORY\fP) returns the string 
\f2out of memory\fP.
.P
The standard GLU error codes are \%\f3GLU_INVALID_ENUM\fP, 
\%\f3GLU_INVALID_VALUE\fP,
and \%\f3GLU_OUT_OF_MEMORY\fP.
Certain other GLU functions can return specialized error codes
through callbacks.
See the \f3glGetError\fP reference page for the list of 
GL error codes.
.SH ERRORS
\%\f3NULL\fP is returned if \f2error\fP is not a valid GL or GLU error code.
.SH SEE ALSO
\f3glGetError(3G)\fP,
\%\f3gluNurbsCallback(3G)\fP,
\%\f3gluQuadricCallback(3G)\fP,
\%\f3gluTessCallback(3G)\fP