OpenGL® Registry

The OpenGL Registry contains specifications, header files, and related documentation for OpenGL and related APIs including GLU, GLX, and WGL. In addition to the core API specifications, many extensions to these APIs have been defined by vendors, groups of vendors, and the ARB. The Registry also contains specifications and header files for all registered extensions, written as modifications to the appropriate core API specifications.

The Registry also includes naming conventions, guidelines for creating new extensions and writing suitable extension specifications, and other documentation related to these APIs.

Table of Contents

OpenGL API and Shading Language Specifications and Reference Pages
Adding to the Registry and Requesting Enumerant Allocations
OpenGL Application Binary Interface for Linux
Core API and Extension Header Files
Registry of Reserved Enumerants and Functions
Extension Specifications
- ARB Extensions by number
- Vendor and EXT Extensions by number

OpenGL API and Shading Language Specifications and Reference Pages

IP Disclosure Statements

IP Disclosure Statements from Khronos Members which bear on OpenGL are available.

Adding to the Registry and Requesting Enumerant Allocations

If you want to add an extension specification to the Registry, correct an existing specification, request allocation of enumerants and other controlled resources in the OpenGL / GLX / WGL namespaces, or otherwise change the Registry, please create a Bugzilla account on the public Khronos.org Bugzilla, and submit your request there against Product "OpenGL", Component "Registry". You can use this Bugzilla link, which fills in many fields for you.

Please review the documents linked below, especially How to Create Extensions and Enumerant Allocation Policies, before making your request.

OpenGL Application Binary Interface for Linux

The current version of the OpenGL Application Binary Interface for Linux is also available.

Core API and Extension Header Files

Because extensions vary from platform to platform and driver to driver, OpenGL developers can't expect interfaces for all extensions to be defined in the standard gl.h, glx.h, and wgl.h header files. Additional header files - glext.h, glxext.h, and wglext.h - are provided here.

NOTE 2010/08/09: the .spec files and headers have been updated to OpenGL 4.1 level and a variety of bugs in the headers identified in the public Bugzilla have been fixed.

These headers define interfaces (enumerants, prototypes, and for platforms supporting dynamic runtime extension queries, such as Linux and Microsoft Windows, function pointer typedefs) for all registered extensions.

Draft gl3.h Header

We are releasing a draft version of a new header file, gl3.h for public feedback. This header is described in appendix H.2 of the OpenGL 3.1 Specification and is intended for use with core OpenGL 3.1 implementations. It does not include interfaces that were removed from core OpenGL 3.1.

We will create a gl3ext.h if and when there are separately developed extensions shipping against core OpenGL 3.1, but at present there are no such extensions and no need for this header. Please read the release notes near the top of gl3.h before attempting to use it. Again, this is not a production-quality header and we're only putting it out for developer feedback at present, not for general use.

Enumerant and Function Registry

The Registry includes databases defining the APIs and reserved enumerant ranges for OpenGL, GLX, and WGL. There are several of these ".spec" files for each API, described below:

OpenGL .spec files
- enum.spec - canonical description of the reserved OpenGL enumerants and the ranges allocated for different purposes. New allocations are made here and when extensions using values in allocated ranges are registered, the enumerants in those extensions are added as well.
- enumext.spec - derived variant of enum.spec containing the enumerant values grouped by the extension or API core revision they correspond to.
- gl.spec - canonical description of the functions defined by core OpenGL and extensions. When extensions are registered, the functions they define are added here.
- gl.tm - typemap used to convert the abstract typenames in gl.spec into underlying GL types.
- enumext.spec, gl.spec, and gl.tm are used to generate glext.h
GLX .spec files
- glxenum.spec - canonical description of the reserved GLX enumerants, like enum.spec.
- glxenumext.spec - derived variant of glxenum.spec containing the enumerant values grouped by the GLX extension or API core revision they correspond to. This only includes GLX core versions 1.3 and later.
- glx.spec - canonical description of the functions defined by core GLX up to version 1.3.
- glxext.spec - canonical description of the functions defined by GLX extensions and core versions 1.3 and later.
- glx.tm - typemap used to convert the abstract typenames in glx*.spec into underlying GLX types.
- glxenumext.spec, glxext.spec, and glx.tm are used to generate glxext.h.
WGL .spec files
- wglenum.spec - canonical description of the reserved WGL enumerants, like enum.spec.
- wglenumext.spec - derived variant of wglenum.spec containing the enumerant values grouped by the WGL extension they correspond to. This only includes WGL core versions 1.3 and later (Microsoft has never revised the WGL core API).
- wgl.spec - canonical description of the functions defined by WGL.
- wglext.spec - canonical description of the functions defined by WGL extensions.
- wgl.tm - typemap used to convert the abstract typenames in wgl*.spec into underlying WGL and Win32 types.
- wglenumext.spec, wglext.spec, and wgl.tm are used to generate wglext.h.

(Yes, these databases should be moved to a modern XML-based format. Patience.)

ARB Extensions by number

Vendor and EXT Extensions by number

Other Extensions

These extensions have not yet been assigned numbers, are still under development, or were abandoned (but are kept in the extension registry for reference purposes).

The Industry's Foundation for High Performance Graphics

from games to virtual reality, mobile phones to supercomputers