tgls

Thin bindings to OpenGL {3,4} and OpenGL ES {2,3} for OCaml
README

v0.8.6

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

Installation

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.

Supported OpenGL versions

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

Documentation

The documentation and API reference is automatically generated by from
the interfaces, it can be consulted online or via odig doc tgls.

Sample programs

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.

The C file assert_sizes.c is a program that
should exit with 0 on your platform to ensure the bindings will
work correctly.

Install
Maintainers
Sources
tgls-0.8.6.tbz
sha512=837f030860a8c53d1dad5677240bb106fe4c44270a6615cdf90236fea50882420a303ac6df988b83ef92c1ae5fe6522e39dcb058ef4166422b7978dee4b5143b
Dependencies
xmlm
dev
ctypes
>= "0.4.0"
topkg
build & >= "1.0.3"
ocaml
>= "4.08.0"
Reverse Dependencies