orca/ext/angle_headers/GLES/README.md

ANGLE GLES 1.0 Headers

The GLES 1.0 headers ANGLE uses are generated using the Khronos tools but modified to include function pointer types and function prototype guards.

Regenerating gl.h

1. Install Python 3 (not 2) with the lxml addon. You can do this using pip install lxml from your Python's Scripts folder.

2. Clone https://github.com/KhronosGroup/OpenGL-Registry.git.

3. Edit OpenGL-Registry/xml/genheaders.py:

   1. Look for the section titled # GLES 1.x API + mandatory extensions - GLES/gl.h (no function pointers)
   2. Change prefixText = prefixStrings + gles1PlatformStrings + genDateCommentString, to prefixText = prefixStrings + gles1PlatformStrings + apiEntryPrefixStrings + genDateCommentString,
   3. Change genFuncPointers = False, to genFuncPointers = True,
   4. Change protectProto = False, to protectProto = 'nonzero',
   5. Change protectProtoStr = 'GL_GLEXT_PROTOTYPES', to protectProtoStr = 'GL_GLES_PROTOTYPES',

4. Set your working directory to OpenGL-Registry/xml/.

5. Run python genheaders.py ../api/GLES/gl.h

6. The generated header will now be in OpenGL-Registry/api/GLES/gl.h. You can copy the header over to this folder.

7. Also update scripts/gl.xml with the latest version from OpenGL-Registry/xml/.