glgenlists.md

title	description	ms.assetid	keywords	topic_type	api_name	api_location	api_type	ms.topic	ms.date
glGenLists function (Gl.h)	The glGenLists function generates a contiguous set of empty display lists.	07a97e89-1fbe-4405-b1b0-c4c47b098633	glGenLists function OpenGL	apiref	glGenLists	opengl32.dll	DllExport	reference	05/31/2018

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