Glossary actor An item on the scenegraph. Every actor has a parent, except the stage, and some actors can be containers. Every actor has a geometry and, when visible, it should paint its contents. The base class for actors is #ClutterActor. allocation The final size of an actor within its parent. For example, an actor might have a preferred minimum size of 20×20 pixels and a natural size of 40×40 pixels, but its parent may decide to allocate 50×20 pixels for it instead. minimum size natural size child A container's child is an actor contained inside it. container An actor which can contain other actors. If a container is meant to be extended using public API it should implement the #ClutterContainer interface; otherwise it is a composite actor. A container can let its children manage their geometry, like #ClutterGroup, or they can take care of assigning one. event Events are the way in which the Clutter backend informs Clutter about external events like pointer motion, button clicks, key presses, etc. geometry An actor's position and size. A geometry can be expressed in actor-relative untransformed coordinates; or in stage-relative, transformed coordinates. minimum size The minimum, useful size of an actor. For instance, a button might have a minimum size of 20×20 millimeters on a touch screen, to retain the ability for the user to press it. A container that manages the size of its children should always try to allocate at least their minimum size. natural size allocation natural size The default size requested by an actor. minimum size allocation parent An actor's parent is the container inside which the actor resides. scenegraph The tree of all actors, starting from the stage at the root and following the containers. stage The top-level container for actors. Depending on the Clutter back end a stage can be associated to a window or to a frame buffer; also depending on the back end is the number of instantiatable stages. Stages in Clutter can be manipulated using the #ClutterStage API. transformation A rotation, scaling or traslation of an actor. Transformations are independent of the actor's geometry.