15bd8deadSopenharmony_ci# OpenGL XML API Registry
25bd8deadSopenharmony_ci
35bd8deadSopenharmony_ciThis directory contains the OpenGL, GLX, and WGL XML API registries, in
45bd8deadSopenharmony_cigl.xml, glx.xml, and wgl.xml respectively. They are used to reserve
55bd8deadSopenharmony_cienumerant ranges for vendors working on new extensions, to register
65bd8deadSopenharmony_ciextension interfaces when an extension is published, and to generate the
75bd8deadSopenharmony_ciKhronos-supplied header files in ../api .
85bd8deadSopenharmony_ci
95bd8deadSopenharmony_ciThe canonical versions are always found in the master branch of the github
105bd8deadSopenharmony_cirepository at https://github.com/KhronosGroup/OpenGL-Registry
115bd8deadSopenharmony_ci
125bd8deadSopenharmony_ciThe 'validate' Makefile target uses the 'jing' tool to confirm that each XML
135bd8deadSopenharmony_cifile is structurally valid and conforms to the registry schema in
145bd8deadSopenharmony_ciregistry.rnc. The schema is described in detail in readme.pdf.
155bd8deadSopenharmony_ci
165bd8deadSopenharmony_ciThe 'default' Makefile target generates updated headers in ../api/ from the
175bd8deadSopenharmony_ciXML files.
185bd8deadSopenharmony_ci
195bd8deadSopenharmony_ciNote that while there are targets for ../api/{gl.h,glx.h,wgl.h} in
205bd8deadSopenharmony_cigenglvnd.py and genheaders.py, these targets are not generated by default
215bd8deadSopenharmony_ciand are experimental. At present, you should use the versions of these
225bd8deadSopenharmony_ciheaders shipped with your OS or IHV SDK.
23