From d192f73b78cc2c90179f3ddee6d836d5faa18829 Mon Sep 17 00:00:00 2001 From: Emmanuele Bassi Date: Fri, 8 Feb 2008 16:13:15 +0000 Subject: [PATCH] 2008-02-08 Emmanuele Bassi * clutter/clutter-actor.c: Add actor box diagram and notes. --- ChangeLog | 4 ++++ clutter/clutter-actor.c | 17 +++++++++++++---- 2 files changed, 17 insertions(+), 4 deletions(-) diff --git a/ChangeLog b/ChangeLog index 6d4498499..88e4033c3 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +2008-02-08 Emmanuele Bassi + + * clutter/clutter-actor.c: Add actor box diagram and notes. + 2008-02-08 Emmanuele Bassi * clutter/clutter-behaviour-path.c: Move the nice graph and diff --git a/clutter/clutter-actor.c b/clutter/clutter-actor.c index 1c6576416..626ebfd66 100644 --- a/clutter/clutter-actor.c +++ b/clutter/clutter-actor.c @@ -32,7 +32,14 @@ * be a #ClutterActor, either by using one of the classes provided by * Clutter, or by implementing a new #ClutterActor subclass. * - * Actor Transformations + * Every actor is a 2D surface in a 3D environment. The surface is contained + * inside its bounding box, described by the #ClutterActorBox structure: + * + *
+ * Bounding box of an Actor + * + *
+ * * The OpenGL modelview matrix for the actor is constructed from the actor * settings by the following order of operations: * @@ -49,10 +56,10 @@ * * * - * NB: the position of any children is referenced from the top-left corner of - * the parent, not the parent's anchor point. + * The position of any children is referenced from the top-left corner of + * the parent, not the parent's anchor point. * - * Event handling + * Events are handled in the following ways: * * Actors emit pointer events if set reactive, see * clutter_actor_set_reactive() @@ -84,6 +91,8 @@ * * * + * Every '?' box in the diagram above is an entry point for application + * code. */ /**