glGenLists

  • Article

The glGenLists function generates a contiguous set of empty display lists.

GLuint glGenLists(
  GLsizei range);

Parameters

  • range
    The number of contiguous empty display lists to be generated.

Remarks

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:

glIsList

Error Codes

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.

Requirements

**  Windows NT/2000:** Requires Windows NT 3.5 or later.
**  Windows 95/98:** Requires Windows 95 or later. Available as a redistributable for Windows 95.
**  Header:** Declared in Gl.h.
**  Library:** Use Opengl32.lib.

See Also

glBegin, glCallList, glCallLists, glDeleteLists, glEnd, glIsList, glNewList