'\"! eqn | mmdoc
'\"macro stdmacro
.ds Vn Version 1.2
.ds Dt 6 March 1997
.ds Re Release 1.1.0
.ds Dp Mar 17 18:05
.ds Dm  Mar  6 20:0
.ds Xs 26226 3 genlists.gl
.TH GLGENLISTS
.SH NAME
.B "glGenLists
\- generate a contiguous set of empty display lists

.SH C SPECIFICATION
GLuint \f3glGenLists\fP(
GLsizei \fIrange\fP )
.nf
.fi

.SH PARAMETERS
.TP \w'\f2range\fP\ \ 'u 
\f2range\fP
Specifies the number of contiguous empty display lists
to be generated.
.SH DESCRIPTION
\f3glGenLists\fP has one argument, \f2range\fP.
It returns an integer \f2n\fP such that \f2range\fP contiguous
empty display lists,
named \f2n\fP, \f2n\fP+1, ..., \f2n\fP+\f2range\fP \-1,
are created.
If \f2range\fP is 0,
if there is no group of \f2range\fP contiguous names available,
or if any error is generated,
no display lists are generated,
and 0 is returned.
.SH ERRORS
\f3GL_INVALID_VALUE\fP is generated if \f2range\fP is negative.
.P
\f3GL_INVALID_OPERATION\fP is generated if \f3glGenLists\fP
is executed between the execution of \f3glBegin\fP
and the corresponding execution of \f3glEnd\fP.
.SH ASSOCIATED GETS
\f3glIsList\fP
.SH SEE ALSO
\f3glCallList\fP,
\f3glCallLists\fP,
\f3glDeleteLists\fP,
\f3glNewList\fP