make new opengl source generator

2026-08-26 18:12:08 +08:00
parent 65041ff8bc
commit 75bf7fc139
126 changed files with 8934 additions and 26139 deletions
@@ -0,0 +1,25 @@
+// Copyright 2017-2021 The Khronos Group Inc.
+// SPDX-License-Identifier: CC-BY-4.0
+
+# OpenGL XML API Registry
+
+This directory contains the OpenGL, GLX, and WGL XML API registries, in
+gl.xml, glx.xml, and wgl.xml respectively. They are used to reserve
+enumerant ranges for vendors working on new extensions, to register
+extension interfaces when an extension is published, and to generate the
+Khronos-supplied header files in ../api .
+
+The canonical versions are always found in the master branch of the github
+repository at https://github.com/KhronosGroup/OpenGL-Registry
+
+The 'validate' Makefile target uses the 'jing' tool to confirm that each XML
+file is structurally valid and conforms to the registry schema in
+registry.rnc. The schema is described in detail in readme.pdf.
+
+The 'default' Makefile target generates updated headers in ../api/ from the
+XML files.
+
+Note that while there are targets for ../api/{gl.h,glx.h,wgl.h} in
+genglvnd.py and genheaders.py, these targets are not generated by default
+and are experimental. At present, you should use the versions of these
+headers shipped with your OS or IHV SDK.