'\" e '\"! eqn | mmdoc '\"macro stdmacro .ds Vn Version 1.2 .ds Dt 24 September 1999 .ds Re Release 1.2.1 .ds Dp Jan 14 18:30 .ds Dm 01 genlists. .ds Xs 2609 3 genlists.gl .TH GLGENLISTS 3G .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(3G)\fP, \%\f3glCallLists(3G)\fP, \%\f3glDeleteLists(3G)\fP, \%\f3glNewList(3G)\fP