glGenLists function

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

Syntax

GLuint WINAPI glGenLists(
   GLsizei range
);

Parameters

range

The number of contiguous empty display lists to be generated.

Error codes

The following error codes can be retrieved by the glGetError function.

Name Meaning
GL_INVALID_VALUE
range was negative.
GL_INVALID_OPERATION
The function was called between a call to glBegin and the corresponding call to glEnd.

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

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Gl.h
Library
Opengl32.lib
DLL
Opengl32.dll

See also

glBegin

glCallList

glCallLists

glDeleteLists

glEnd

glIsList

glNewList