Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/go-gl/glow

Go binding generator for OpenGL
https://github.com/go-gl/glow

Last synced: 4 days ago
JSON representation

Go binding generator for OpenGL

Awesome Lists containing this project

README 

        
# Glow



Glow is an OpenGL binding generator for Go. Glow parses the [OpenGL XML API registry](https://github.com/KhronosGroup/OpenGL-Registry/tree/master/xml) and the [EGL XML API registry](https://github.com/KhronosGroup/EGL-Registry/tree/master/api) to produce a machine-generated cgo bridge between Go functions and native OpenGL functions. Glow is a fork of [GoGL2](https://github.com/chsc/gogl2).



Features:



- Go functions that mirror the C specification using Go types.

- Support for multiple OpenGL APIs (GL/GLES/EGL/WGL/GLX/EGL), versions, and profiles.

- Support for extensions (including debug callbacks).

- Support for overloads to provide Go functions with different parameter signatures.



See the [open issues](https://github.com/go-gl/glow/issues) for caveats about the current state of the implementation.



## Generated Packages



Generated OpenGL binding packages are available in the [go-gl/gl](https://github.com/go-gl/gl) repository.



## Overloads



See subdirectory `xml/overload` for examples. The motivation here is to provide Go functions with different parameter signatures of existing OpenGL functions.



For example, `glVertexAttribPointer(..., void *)` cannot be used with `gl.VertexAttribPointer(..., unsafe.Pointer)` when using arbitrary offset values. The `checkptr` safeguard will abort the program when doing so.

Overloads allow the creation of an additional `gl.VertexAttribPointerWithOffset(..., uintptr)`, which calls the original OpenGL function with appropriate casts.



## Custom Packages



If the prebuilt, go-gettable packages are not suitable for your needs you can build your own. For example,



    go get github.com/go-gl/glow

    cd $GOPATH/src/github.com/go-gl/glow

    go build

    ./glow download

    ./glow generate -api=gl -version=3.3 -profile=core -remext=GL_ARB_cl_event

    go install ./gl-core/3.3/gl



**NOTE:** You will have to provide a GitHub token ([personal access or OAuth2 token](https://developer.github.com/v3/auth/#basic-authentication)) to update the XML specification files.



A few notes about the flags to `generate`:



- `api`: One of `gl`, `gles1`, `gles2`, `egl`, `wgl`, or `glx`.

- `version`: The API version to generate. The `all` pseudo-version includes all functions and enumerations for the specified API.

- `profile`: For `gl` packages with version 3.2 or higher, `core` or `compatibility` ([explanation](http://www.opengl.org/wiki/Core_And_Compatibility_in_Contexts)).

- `xml`: The XML directory.

- `tmpl`: The template directory.

- `out`: The output directory for generated files.

- `addext`: If non-empty, a regular expression describing which extensions to include _in addition_ to those supported by the selected profile. Empty by default, including nothing additional. Takes precedence over explicit removal.

- `remext`: If non-empty, a regular expression describing which extensions to exclude. Empty by default, excluding nothing.

- `restrict`: A JSON file that explicitly lists what enumerations / functions that Glow should generate (see example.json).

- `lenientInit`: Flag to disable strict function availability checks at `Init` time. By default if any non-extension function pointer cannot be loaded then initialization fails; when this flag is set initialization will succeed with missing functions. Note that on some platforms unavailable functions will load successfully even but fail upon invocation so check against the OpenGL context what is supported.