godotengine/godot-angle-static
1
0
Fork 0
mirror of https://github.com/godotengine/godot-angle-static.git synced 2026-01-04 22:09:59 +03:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
godot-angle-static/include/GLES/README.md
Jamie Madill ba319ba31c Re-land "Load entry points dynamically in tests and samples." 
Fixes the Android/ChromeOS/Fuchsia builds by using consistent EGL
headers.

This CL adds a dynamic loader generator based on XML files. It also
refactors the entry point generation script to move the XML parsing
into a helper class.

Additionally this includes a new GLES 1.0 base header. The new
header allows for function pointer types and hiding prototypes.

All tests and samples now load ANGLE dynamically. In the future this
will be extended to load entry points from the driver directly when
possible. This will allow us to perform more accurate A/B testing.

The new build configuration leads to some tests having more warnings
applied. The CL includes fixes for the new warnings.

Bug: angleproject:2995
Change-Id: I5a8772f41a0f89570b3736b785f44b7de1539b57
Reviewed-on: https://chromium-review.googlesource.com/c/1392382
Reviewed-by: Jamie Madill <jmadill@chromium.org>
Commit-Queue: Jamie Madill <jmadill@chromium.org>
2019-01-01 18:56:45 +00:00

1.3 KiB
Raw Permalink Blame History

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/.