Adds experimental clutter_backend_get_cogl_context API
authorRobert Bragg <robert@linux.intel.com>
Fri, 12 Aug 2011 15:25:53 +0000 (16:25 +0100)
committerRobert Bragg <robert@linux.intel.com>
Wed, 24 Aug 2011 15:24:39 +0000 (16:24 +0100)
commit2f1885565949dbd2c90e386ce557ee45ef1cba8b
tree6811fb6e940b906875553d1bfc0f0d32875092dc
parent2559fb1d0df32bb30bf35448913fa96b33e6a423
Adds experimental clutter_backend_get_cogl_context API

This adds experimental API to be able to get the CoglContext associated
with the ClutterBackend. The CoglContext is required to use some of the
experimental 2.0 Cogl API.

Note: Since CoglContext is itself experimental API this API should
considered experimental too. This patch introduces a
CLUTTER_ENABLE_EXPERIMENTAL_API #ifdef guard which anyone wanting to use
this API must define so it's explicitly clear to developers that they
are playing with experimental API.

Note: This API is not yet supported on OSX because OSX still uses the
stub Cogl winsys and the Clutter backend doesn't explicitly create a
CoglContext.

Note: even though this is experimental API we still promise that it
wont be changed during a stable release cycle. This means for example
that you can depend on this for the lifetime of the clutter-1.8 stable
release cycle.
clutter/clutter-backend.c
clutter/clutter-backend.h