%%VERSION%%
Tgls is a set of independent OCaml libraries providing thin bindings to OpenGL libraries. It has support for core OpenGL 3.{2,3} and 4.{0,1,2,3,4} and OpenGL ES 2 and 3.{0,1,2}.
Tgls depends on ocaml-ctypes and the C OpenGL library of your platform. It is distributed under the ISC license.
Home page: http://erratique.ch/software/tgls
Tgls can be installed with opam
:
opam install tgls
If you don't use opam
consult the opam
file for
build instructions and a complete specification of the dependencies.
Tgls provides four libraries and corresponding ocamlfind
packages:
-
tgl3
, supports all functions and enumerants to program with a core OpenGL 3.2 or OpenGL 3.3 context. -
tgl4
, supports all functions and enumerants to program with a core OpenGL 4.0 to 4.5 context. -
tgles2
, supports all functions and enumerants to program with an OpenGL ES 2.0 context. -
tgles3
, supports all functions and enumerants to program with an OpenGL ES 3.0 to 3.2 context.
Compatibility contexts are not supported. For extensions, most of them only add few entry points and/or enumerants, as such it seems the easiest way to access them is to manually use ocaml-ctypes and the appropriate constants (the tools in support could be enhanced to support them but it's not planned to do so).
The documentation and API reference is automatically generated by from
the interfaces, it can be consulted online or via odig doc tgls
.
If you installed tgls
with opam
sample programs are located in the
directory opam config var tgls:doc
. Their source has a comment on
how to compile them.
In the distribution sample programs are located in the test
directory of the distribution. You'll need tsdl to compile them.
They can be built with:
ocamlbuild -use-ocamlfind tests.otarget
The resulting binaries are in _build/test
:
linkgl{3,4,es2,es3}.native
, tests that the C OpenGL library is correctly linked, the executables should exit with 0.trigl{3,4,es2,es3}.native
, opens a window and draws a tricolor triangle, needs tsdl.dbglifetime4.native
tests debug message callback lifetimes
The C file assert_sizes.c
is a program that
should exit with 0 on your platform to ensure the bindings will
work correctly.