Cogl 1.7.8

Good news, everyone!

A new Cogl snapshot is now available at:

http://source.clutter-project.org/sources/cogl/1.7/
http://download.gnome.org/sources/cogl/1.7/

Cogl is a small open source library for using 3D graphics hardware to draw pretty pictures. The API departs from the flat state machine style of OpenGL and is designed to make it easy to write orthogonal components that can render without stepping on each others toes.

As well as aiming for a nice API, we think having a single library as opposed to an API specification like OpenGL has a few advantages too; like being able to paper over the inconsistencies/bugs of different OpenGL implementations in a centralized place, not to mention the myriad of OpenGL extensions. It also means we are in a better position to provide utility APIs that help software developers since they only need to be implemented once and there is no risk of inconsistency between implementations.

Having other backends, besides OpenGL, such as drm, Gallium or D3D are options we are interested in for the future.

REQUIREMENTS

Cogl currently only requires:

• GLib ≥ 2.26.0
• OpenGL ≥ 1.3 (or 1.2 + multitexturing), or OpenGL ES 2.0 (or 1.1)
• GLX, AGL, WGL or an EGL implementation

Cogl also has optional dependencies:

• GDK-Pixbuf ≥ 2.0 — for image loading
• Cairo ≥ 1.10 — for debugging texture atlasing (debug builds only)

The optional Cogl Pango library requires:

• Cairo ≥ 1.10
• PangoCairo ≥ 1.20

On X11, Cogl depends on the following extensions

• XComposite ≥ 0.4
• XDamage
• XExt
• XFixes ≥ 3

When running with OpenGL, Cogl requires at least version 1.3 or 1.2 with the multitexturing extension. However to build Cogl
you will need the latest GL headers which can be obtained from the Khronos website.

DOCUMENTATION

The 1.x API is documented here: http://docs.clutter-project.org/docs/cogl/1.7
The experimental 2.0 API is documented here: http://docs.clutter-project.org/docs/cogl-2.0-experimental/1.7

RELEASE NOTES

• This is a development snapshot release so there are not API or ABI stability guarantees at this point for new APIs since the last stable release.
• This Cogl release exports a 1.x API (For third-party Clutter developers to write custom actors) and an experimental 2.0 API which allows standalone application development.
• Internally Clutter depends on the Cogl 2.0 experimental API so we maintain runtime compatibility between the 1.x API and experimental 2.0 APIs, which means developers can mix-and-match their use of the APIs in the same process. API selection is done per-file by including a line like: #define COGL_ENABLE_EXPERIMENTAL_2_0_API before including cogl.h or clutter.h.
• We recommend using the 2.0 API if you don't mind updating your code once in a while as this API evolves and stabilizes. We promise not to break the 2.0 API during a 1.x stable cycle and hope that will encourage people to experiment with it and give critical feedback! For example after releasing 1.8, the 2.0 API will be stable for 1.8.1, 1.8.2, 1.8.3 etc, but may update for 1.9/1.10.
• Because we export the 1.x and 2.0 APIs from one libcogl.so the library versioning, and thus ABI, can only be considered as stable as our 2.0 API — i.e. during a stable release 1.x cycle.
• Please report bugs using the Cogl Bugzilla product.