brl/mutter
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

actor: Add the :child-transform property

Browse Source 
An additional transformation that is applied to the children of an actor
before their own transformations, but not to the actor itself.
This commit is contained in:
Emmanuele Bassi 2012-08-16 17:10:50 +01:00
parent f7dd2d3746
commit ffe32426b8
4 changed files with 146 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
clutter/clutter-actor-private.h
View File

@ -212,6 +212,9 @@ struct _ClutterTransformInfo
CoglMatrix transform;
guint transform_set : 1;
CoglMatrix child_transform;
guint child_transform_set : 1;
};
const ClutterTransformInfo * _clutter_actor_get_transform_info_or_defaults (ClutterActor *self);

136
clutter/clutter-actor.c
View File

@ -902,6 +902,8 @@ enum
PROP_TRANSFORM,
PROP_TRANSFORM_SET,
PROP_CHILD_TRANSFORM,
PROP_CHILD_TRANSFORM_SET,
PROP_SHOW_ON_SET_PARENT, /*XXX:2.0 remove */
@ -2981,7 +2983,15 @@ clutter_actor_real_apply_transform (ClutterActor *self,
priv->allocation.x1 + pivot_x + info->translation.x,
priv->allocation.y1 + pivot_y + info->translation.y);
cogl_matrix_init_identity (transform);
if (_clutter_actor_get_transform_info_or_defaults (priv->parent)->child_transform_set)
{
const ClutterTransformInfo *parent_info;
parent_info = _clutter_actor_get_transform_info_or_defaults (priv->parent);
clutter_matrix_init_from_matrix (transform, &(parent_info->child_transform));
}
else
cogl_matrix_init_identity (transform);
/* if we have an overriding transformation, we use that, and get out */
if (info->transform_set)
@ -4143,7 +4153,7 @@ static const ClutterTransformInfo default_transform_info = {
1.0, 1.0, 1.0, { 0, }, /* scale */
{ 0, }, /* anchor */
{ 0, }, /* anchor XXX:2.0 - remove*/
CLUTTER_VERTEX_INIT_ZERO, /* translation */
@ -4153,6 +4163,7 @@ static const ClutterTransformInfo default_transform_info = {
0.f, /* pivot-z */
{ 0.0, }, FALSE, /* transform */
{ 0.0, }, FALSE, /* child-transform */
};
/*< private >
@ -5052,6 +5063,10 @@ clutter_actor_set_property (GObject *object,
clutter_actor_set_transform (actor, g_value_get_boxed (value));
break;
case PROP_CHILD_TRANSFORM:
clutter_actor_set_child_transform (actor, g_value_get_boxed (value));
break;
case PROP_SHOW_ON_SET_PARENT: /* XXX:2.0 - remove */
priv->show_on_set_parent = g_value_get_boolean (value);
break;
@ -5550,6 +5565,24 @@ clutter_actor_get_property (GObject *object,
}
break;
case PROP_CHILD_TRANSFORM:
{
ClutterMatrix m;
clutter_actor_get_child_transform (actor, &m);
g_value_set_boxed (value, &m);
}
break;
case PROP_CHILD_TRANSFORM_SET:
{
const ClutterTransformInfo *info;
info = _clutter_actor_get_transform_info_or_defaults (actor);
g_value_set_boolean (value, info->child_transform_set);
}
break;
case PROP_SHOW_ON_SET_PARENT: /* XXX:2.0 - remove */
g_value_set_boolean (value, priv->show_on_set_parent);
break;
@ -7147,6 +7180,41 @@ clutter_actor_class_init (ClutterActorClass *klass)
G_PARAM_READABLE |
G_PARAM_STATIC_STRINGS);
/**
* ClutterActor:child-transform:
*
* Applies a transformation matrix on each child of an actor.
*
* Setting this property with a #ClutterMatrix will set the
* #ClutterActor:child-transform-set property to %TRUE as a side effect;
* setting this property with %NULL will set the
* #ClutterActor:child-transform-set property to %FALSE.
*
* Since: 1.12
*/
obj_props[PROP_CHILD_TRANSFORM] =
g_param_spec_boxed ("child-transform",
P_("Child Transform"),
P_("Children transformation matrix"),
CLUTTER_TYPE_MATRIX,
G_PARAM_READWRITE |
G_PARAM_STATIC_STRINGS);
/**
* ClutterActor:child-transform-set:
*
* Whether the #ClutterActor:child-transform property is set.
*
* Since: 1.12
*/
obj_props[PROP_CHILD_TRANSFORM_SET] =
g_param_spec_boolean ("child-transform-set",
P_("Child Transform Set"),
P_("Whether the child-transform property is set"),
FALSE,
G_PARAM_READABLE |
G_PARAM_STATIC_STRINGS);
/**
* ClutterActor:show-on-set-parent:
*
@ -19859,3 +19927,67 @@ _clutter_actor_handle_event (ClutterActor *self,
done:
g_ptr_array_free (event_tree, TRUE);
}
/**
* clutter_actor_set_child_transform:
* @self: a #ClutterActor
* @transform: (allow-none): a #ClutterMatrix, or %NULL
*
* Sets the transformation matrix to be applied to all the children
* of @self prior to their own transformations. The default child
* transformation is the identity matrix.
*
* If @transform is %NULL, the child transform will be unset.
*
* Since: 1.12
*/
void
clutter_actor_set_child_transform (ClutterActor *self,
const ClutterMatrix *transform)
{
ClutterTransformInfo *info;
GObject *obj;
g_return_if_fail (CLUTTER_IS_ACTOR (self));
info = _clutter_actor_get_transform_info (self);
if (transform != NULL)
clutter_matrix_init_from_matrix (&info->child_transform, transform);
else
clutter_matrix_init_identity (&info->child_transform);
info->child_transform_set = transform != NULL;
obj = G_OBJECT (self);
g_object_notify_by_pspec (obj, obj_props[PROP_CHILD_TRANSFORM]);
g_object_notify_by_pspec (obj, obj_props[PROP_CHILD_TRANSFORM_SET]);
}
/**
* clutter_actor_get_child_transform:
* @self: a #ClutterActor
* @transform: (out caller-allocates): a #ClutterMatrix
*
* Retrieves the child transformation matrix set using
* clutter_actor_set_child_transform(); if none is currently set,
* the @transform matrix will be initialized to the identity matrix.
*
* Since: 1.12
*/
void
clutter_actor_get_child_transform (ClutterActor *self,
ClutterMatrix *transform)
{
const ClutterTransformInfo *info;
g_return_if_fail (CLUTTER_IS_ACTOR (self));
g_return_if_fail (transform != NULL);
info = _clutter_actor_get_transform_info_or_defaults (self);
if (info->child_transform_set)
clutter_matrix_init_from_matrix (transform, &info->child_transform);
else
clutter_matrix_init_identity (transform);
}

6
clutter/clutter-actor.h
View File

@ -670,6 +670,12 @@ void clutter_actor_set_transform
CLUTTER_AVAILABLE_IN_1_12
void clutter_actor_get_transform (ClutterActor *self,
ClutterMatrix *transform);
CLUTTER_AVAILABLE_IN_1_12
void clutter_actor_set_child_transform (ClutterActor *self,
const ClutterMatrix *transform);
CLUTTER_AVAILABLE_IN_1_12
void clutter_actor_get_child_transform (ClutterActor *self,
ClutterMatrix *transform);
void clutter_actor_get_transformed_position (ClutterActor *self,
gfloat *x,
gfloat *y);

4
clutter/clutter.symbols
View File

@ -89,6 +89,7 @@ clutter_actor_get_anchor_point_gravity
clutter_actor_get_animation
clutter_actor_get_background_color
clutter_actor_get_child_at_index
clutter_actor_get_child_transform
clutter_actor_get_children
clutter_actor_get_clip
clutter_actor_get_clip_to_allocation
@ -232,8 +233,9 @@ clutter_actor_set_anchor_point
clutter_actor_set_anchor_point_from_gravity
clutter_actor_set_background_color
clutter_actor_set_child_above_sibling
clutter_actor_set_child_below_sibling
clutter_actor_set_child_at_index
clutter_actor_set_child_below_sibling
clutter_actor_set_child_transform
clutter_actor_set_clip
clutter_actor_set_clip_to_allocation
clutter_actor_set_content