isa/mutter
1
0
Fork 0
mirror of https://github.com/brl/mutter.git synced 2024-09-20 14:35:48 -04:00
Code Issues Packages Projects Releases Wiki Activity

offscreen-effect: Rename create_target to create_buffer

Browse Source 
*** 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.
This commit is contained in:
Emmanuele Bassi 2010-09-01 17:56:15 +01:00
parent 6c40b10083
commit 12a5bf2e06
3 changed files with 32 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
clutter/clutter-offscreen-effect.c
View File

@ -53,7 +53,7 @@
* transformed size of the #ClutterActor using the offscreen effect. * transformed size of the #ClutterActor using the offscreen effect.
* Sub-classes of #ClutterOffscreenEffect can change the texture creation * Sub-classes of #ClutterOffscreenEffect can change the texture creation
* code to provide bigger textures by overriding the * code to provide bigger textures by overriding the
* <function>create_target()</function> virtual function; no chain up * <function>create_texture()</function> virtual function; no chain up
* to the #ClutterOffscreenEffect implementation is required in this * to the #ClutterOffscreenEffect implementation is required in this
* case.</para> * case.</para>
* </refsect2> * </refsect2>
@ -75,7 +75,7 @@
struct _ClutterOffscreenEffectPrivate struct _ClutterOffscreenEffectPrivate
{ {
CoglHandle offscreen; CoglHandle offscreen;
CoglHandle target; CoglMaterial *target;
ClutterActor *actor; ClutterActor *actor;
ClutterActor *stage; ClutterActor *stage;
@ -120,9 +120,9 @@ clutter_offscreen_effect_set_actor (ClutterActorMeta *meta,
} }
static CoglHandle static CoglHandle
clutter_offscreen_effect_real_create_target (ClutterOffscreenEffect *effect, clutter_offscreen_effect_real_create_texture (ClutterOffscreenEffect *effect,
gfloat width, gfloat width,
gfloat height) gfloat height)
{ {
return cogl_texture_new_with_size (MAX (width, 1), MAX (height, 1), return cogl_texture_new_with_size (MAX (width, 1), MAX (height, 1),
COGL_TEXTURE_NO_SLICING, COGL_TEXTURE_NO_SLICING,
@ -166,7 +166,7 @@ update_fbo (ClutterEffect *effect)
priv->target = cogl_material_new (); priv->target = cogl_material_new ();
texture = clutter_offscreen_effect_create_target (self, width, height); texture = clutter_offscreen_effect_create_texture (self, width, height);
if (texture == COGL_INVALID_HANDLE) if (texture == COGL_INVALID_HANDLE)
return FALSE; return FALSE;
@ -174,7 +174,7 @@ update_fbo (ClutterEffect *effect)
cogl_handle_unref (texture); cogl_handle_unref (texture);
/* we need to use the size of the texture target and not the minimum /* we need to use the size of the texture target and not the minimum
* size we passed to the create_target() vfunc, as any sub-class might * size we passed to the create_texture() vfunc, as any sub-class might
* give use a bigger texture * give use a bigger texture
*/ */
priv->target_width = cogl_texture_get_width (texture); priv->target_width = cogl_texture_get_width (texture);
@ -401,7 +401,7 @@ clutter_offscreen_effect_class_init (ClutterOffscreenEffectClass *klass)
g_type_class_add_private (klass, sizeof (ClutterOffscreenEffectPrivate)); g_type_class_add_private (klass, sizeof (ClutterOffscreenEffectPrivate));
klass->create_target = clutter_offscreen_effect_real_create_target; klass->create_texture = clutter_offscreen_effect_real_create_texture;
klass->paint_target = clutter_offscreen_effect_real_paint_target; klass->paint_target = clutter_offscreen_effect_real_paint_target;
meta_class->set_actor = clutter_offscreen_effect_set_actor; meta_class->set_actor = clutter_offscreen_effect_set_actor;
@ -427,13 +427,16 @@ clutter_offscreen_effect_init (ClutterOffscreenEffect *self)
* Retrieves the material used as a render target for the offscreen * Retrieves the material used as a render target for the offscreen
* buffer created by @effect * buffer created by @effect
* *
* Return value: (transfer none): a handle for a #CoglMaterial, or * You should only use the returned #CoglMaterial when painting. The
* %COGL_INVALID_HANDLE. The returned handle is owned by Clutter * returned material might change between different frames.
* and it should not be modified or freed *
* Return value: (transfer none): a #CoglMaterial or %NULL. The
* returned material is owned by Clutter and it should not be
* modified or freed
* *
* Since: 1.4 * Since: 1.4
*/ */
CoglHandle CoglMaterial *
clutter_offscreen_effect_get_target (ClutterOffscreenEffect *effect) clutter_offscreen_effect_get_target (ClutterOffscreenEffect *effect)
{ {
g_return_val_if_fail (CLUTTER_IS_OFFSCREEN_EFFECT (effect), g_return_val_if_fail (CLUTTER_IS_OFFSCREEN_EFFECT (effect),
@ -459,26 +462,26 @@ clutter_offscreen_effect_paint_target (ClutterOffscreenEffect *effect)
} }
/** /**
* clutter_offscreen_effect_create_target: * clutter_offscreen_effect_create_texture:
* @effect: a #ClutterOffscreenEffect * @effect: a #ClutterOffscreenEffect
* @width: the minimum width of the target texture * @width: the minimum width of the target texture
* @height: the minimum height of the target texture * @height: the minimum height of the target texture
* *
* Calls the create_target() virtual function of the @effect * Calls the create_texture() virtual function of the @effect
* *
* Return value: a handle to the target texture * Return value: a handle to a Cogl texture, or %COGL_INVALID_HANDLE
* *
* Since: 1.4 * Since: 1.4
*/ */
CoglHandle CoglHandle
clutter_offscreen_effect_create_target (ClutterOffscreenEffect *effect, clutter_offscreen_effect_create_texture (ClutterOffscreenEffect *effect,
gfloat width, gfloat width,
gfloat height) gfloat height)
{ {
g_return_val_if_fail (CLUTTER_IS_OFFSCREEN_EFFECT (effect), g_return_val_if_fail (CLUTTER_IS_OFFSCREEN_EFFECT (effect),
COGL_INVALID_HANDLE); COGL_INVALID_HANDLE);
return CLUTTER_OFFSCREEN_EFFECT_GET_CLASS (effect)->create_target (effect, return CLUTTER_OFFSCREEN_EFFECT_GET_CLASS (effect)->create_texture (effect,
width, width,
height); height);
} }

14
clutter/clutter-offscreen-effect.h
View File

@ -62,7 +62,7 @@ struct _ClutterOffscreenEffect
/** /**
* ClutterOffscreenEffectClass: * ClutterOffscreenEffectClass:
* @create_target: virtual function * @create_texture: virtual function
* @paint_target: virtual function * @paint_target: virtual function
* *
* The #ClutterOffscreenEffectClass structure contains only private data * The #ClutterOffscreenEffectClass structure contains only private data
@ -75,7 +75,7 @@ struct _ClutterOffscreenEffectClass
ClutterEffectClass parent_class; ClutterEffectClass parent_class;
/*< public >*/ /*< public >*/
CoglHandle (* create_target) (ClutterOffscreenEffect *effect, CoglHandle (* create_texture) (ClutterOffscreenEffect *effect,
gfloat min_width, gfloat min_width,
gfloat min_height); gfloat min_height);
void (* paint_target) (ClutterOffscreenEffect *effect); void (* paint_target) (ClutterOffscreenEffect *effect);
@ -92,12 +92,12 @@ struct _ClutterOffscreenEffectClass
GType clutter_offscreen_effect_get_type (void) G_GNUC_CONST; GType clutter_offscreen_effect_get_type (void) G_GNUC_CONST;
CoglHandle clutter_offscreen_effect_get_target (ClutterOffscreenEffect *effect); CoglMaterial *clutter_offscreen_effect_get_target (ClutterOffscreenEffect *effect);
void clutter_offscreen_effect_paint_target (ClutterOffscreenEffect *effect); void clutter_offscreen_effect_paint_target (ClutterOffscreenEffect *effect);
CoglHandle clutter_offscreen_effect_create_target (ClutterOffscreenEffect *effect, CoglHandle clutter_offscreen_effect_create_texture (ClutterOffscreenEffect *effect,
gfloat width, gfloat width,
gfloat height); gfloat height);
G_END_DECLS G_END_DECLS

2
doc/reference/clutter/clutter-sections.txt
View File

@ -2388,7 +2388,7 @@ clutter_effect_get_type
ClutterOffscreenEffect ClutterOffscreenEffect
ClutterOffscreenEffectClass ClutterOffscreenEffectClass
clutter_offscreen_effect_get_target clutter_offscreen_effect_get_target
clutter_offscreen_effect_create_target clutter_offscreen_effect_create_texture
clutter_offscreen_effect_paint_target clutter_offscreen_effect_paint_target
<SUBSECTION Standard> <SUBSECTION Standard>
CLUTTER_TYPE_OFFSCREEN_EFFECT CLUTTER_TYPE_OFFSCREEN_EFFECT