Skip to content

Latest commit

 

History

History
62 lines (45 loc) · 1.58 KB

README.rst

File metadata and controls

62 lines (45 loc) · 1.58 KB

pyglreg: OpenGL XML API Registry Parser

glreg provides functionality to parse and extract data from OpenGL XML API Registry files. Types, enums and functions (commands) in the registry can be enumerated and inspected. This module also provides functions to resolve dependencies and filter APIs in the registry. This makes it useful for generating OpenGL headers and loaders.

Sample code

Import the module:

>>> import glreg

Load a Registry object from a file:

>>> registry = glreg.load(open('gl.xml'))

Generate a simple OpenGL ES 2 C header:

>>> for api in glreg.group_apis(registry, api='gles2', support='gles2'):
...     print('#ifndef ' + api.name)
...     print('#define ' + api.name)
...     print(api.text)
...     print('#endif')
#ifndef GL_ES_VERSION_2_0
#define GL_ES_VERSION_2_0
#include <KHR/khrplatform.h>
typedef khronos_int8_t GLbyte;...

Requirements

  • Python 2.7+, 3.2+

Documentation

Documentation is available at https://pyglreg.readthedocs.org/

Installation

glreg is available at PyPI. Simply run the following:

# pip install --pre glreg

Or, if you downloaded the source, run the following from the source directory:

# python setup.py install

Development

Please report bugs and feature requests to https://github.com/pyokagan/pyglreg/

License

MIT License