offscreen-effect: Rename create_target to create_buffer
authorEmmanuele Bassi <ebassi@linux.intel.com>
Wed, 1 Sep 2010 16:56:15 +0000 (17:56 +0100)
committerEmmanuele Bassi <ebassi@linux.intel.com>
Wed, 1 Sep 2010 17:05:53 +0000 (18:05 +0100)
commit12a5bf2e06114e60e8286ee7fd75e73ce16f487c
treea19ed7837cb699adfdff78fee281627f33d43e22
parent6c40b100839e3597e9ab5f1d3e32c9d42d1af87c
offscreen-effect: Rename create_target to create_buffer

                *** This is an API change ***

The create_target() virtual function should return a CoglHandle to a
texture; clutter_offscreen_effect_get_target(), instead, returns a
CoglMaterial to be painted in the implementation of the paint_target()
virtual function.

Instead of equating textures with materials, and confusing the user of
the API, we should mark the difference more prominently.

First of all, we should return a CoglMaterial* (now that we have that
as a public type) in get_target(); having handles all over the place
does not make it easier to distinguish the semantics of the virtual
functions.

Then we should rename create_target() to create_texture(), to make it
clear that what should be returned is a texture that is used as the
backing for the offscreen framebuffer.
clutter/clutter-offscreen-effect.c
clutter/clutter-offscreen-effect.h
doc/reference/clutter/clutter-sections.txt