The glGenLists function generates a contiguous set of empty display lists.
GLuint glGenLists(
GLsizei range
);
The glGenLists function has one argument, range. It returns an integer n such that range contiguous empty display lists, named n, n+1, . . ., n+range – 1, are created. If range is zero, if there is no group of range contiguous names available, or if any error is generated, then no display lists are generated and zero is returned.
The following function retrieves information related to glGenLists:
The following are the error codes generated and their conditions.
| Error Code | Condition |
|---|---|
| GL_INVALID_VALUE | range is negative. |
| GL_INVALID_OPERATION | glGenLists was called between a call to glBegin and the corresponding call to glEnd. |
Windows NT: Use version 3.5 and later.
Windows: Use Windows 95 and later.
Windows CE: Unsupported.
Header: Declared in gl.h.
Import Library: Link with opengl32.lib.
glBegin, glCallList, glCallLists, glDeleteLists, glEnd, glIsList, glNewList