isa/mutter
1
0
Fork 0
mirror of https://github.com/brl/mutter.git synced 2025-04-25 19:29:38 +00:00
Code Issues Packages Projects Releases Wiki Activity

2008-06-17 Emmanuele Bassi <ebassi@openedhand.com>

Browse Source 
* clutter/clutter-actor.h:
	* clutter/clutter-actor.c:
	(clutter_actor_allocate_preferred_size): Add more documentation
	and notes on where it's appropriate to call this function.
This commit is contained in:
Emmanuele Bassi 2008-06-17 15:59:08 +00:00
parent b592efcf99
commit e29ae614b5
3 changed files with 28 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
ChangeLog
View File

@ -1,3 +1,10 @@
2008-06-17 Emmanuele Bassi <ebassi@openedhand.com>
* clutter/clutter-actor.h:
* clutter/clutter-actor.c:
(clutter_actor_allocate_preferred_size): Add more documentation
and notes on where it's appropriate to call this function.
2008-06-17 Chris Lord <chris@openedhand.com> 2008-06-17 Chris Lord <chris@openedhand.com>
* clutter/clutter-texture.c: (clutter_texture_get_preferred_width), * clutter/clutter-texture.c: (clutter_texture_get_preferred_width),

30
clutter/clutter-actor.c
View File

@ -7362,32 +7362,38 @@ clutter_actor_get_stage (ClutterActor *actor)
/** /**
* clutter_actor_allocate_preferred_size: * clutter_actor_allocate_preferred_size:
* @actor: a #ClutterActor * @self: a #ClutterActor
* @absolute_origin_changed: whether the position of the parent has * @absolute_origin_changed: whether the position of the parent has
* changed in stage coordinates * changed in stage coordinates
* *
* Utility call for Actor implementations that allocates the actors * Allocates the natural size of @self.
* preffered natural size. *
* This function is a utility call for #ClutterActor implementations
* that allocates the actor's preferred natural size. It can be used
* by fixed layout managers (like #ClutterGroup) inside the
* ClutterActor::allocate implementation to give each child exactly
* how much space it requires.
*
* This function is not meant to be used by applications. It is also
* not meant to be used outside the implementation of the
* ClutterActor::allocate virtual function.
* *
* Since: 0.8 * Since: 0.8
*/ */
void void
clutter_actor_allocate_preferred_size (ClutterActor *actor, clutter_actor_allocate_preferred_size (ClutterActor *self,
gboolean absolute_origin_changed) gboolean absolute_origin_changed)
{ {
ClutterUnit actor_x, actor_y; ClutterUnit actor_x, actor_y;
ClutterUnit natural_width, natural_height; ClutterUnit natural_width, natural_height;
ClutterActorBox actor_box; ClutterActorBox actor_box;
g_return_if_fail (CLUTTER_IS_ACTOR (actor)); g_return_if_fail (CLUTTER_IS_ACTOR (self));
actor_x = clutter_actor_get_xu (actor); actor_x = clutter_actor_get_xu (self);
actor_y = clutter_actor_get_yu (actor); actor_y = clutter_actor_get_yu (self);
/* All actorren get their position and natural size (the clutter_actor_get_preferred_size (self,
* container's allocation is flat-out ignored).
*/
clutter_actor_get_preferred_size (actor,
NULL, NULL, NULL, NULL,
&natural_width, &natural_width,
&natural_height); &natural_height);
@ -7397,5 +7403,5 @@ clutter_actor_allocate_preferred_size (ClutterActor *actor,
actor_box.x2 = actor_box.x1 + natural_width; actor_box.x2 = actor_box.x1 + natural_width;
actor_box.y2 = actor_box.y1 + natural_height; actor_box.y2 = actor_box.y1 + natural_height;
clutter_actor_allocate (actor, &actor_box, absolute_origin_changed); clutter_actor_allocate (self, &actor_box, absolute_origin_changed);
} }

5
clutter/clutter-actor.h
View File

@ -301,6 +301,8 @@ void clutter_actor_get_preferred_size (ClutterActor
void clutter_actor_allocate (ClutterActor *self, void clutter_actor_allocate (ClutterActor *self,
const ClutterActorBox *box, const ClutterActorBox *box,
gboolean absolute_origin_changed); gboolean absolute_origin_changed);
void clutter_actor_allocate_preferred_size (ClutterActor *self,
gboolean absolute_origin_changed);
void clutter_actor_get_allocation_coords (ClutterActor *self, void clutter_actor_get_allocation_coords (ClutterActor *self,
gint *x_1, gint *x_1,
gint *y_1, gint *y_1,
@ -556,9 +558,6 @@ void clutter_actor_apply_relative_transform_to_point (ClutterActor *self,
ClutterVertex *point, ClutterVertex *point,
ClutterVertex *vertex); ClutterVertex *vertex);
void clutter_actor_allocate_preferred_size (ClutterActor *actor,
gboolean absolute_origin_changed);
G_END_DECLS G_END_DECLS
#endif /* _HAVE_CLUTTER_ACTOR_H */ #endif /* _HAVE_CLUTTER_ACTOR_H */