mutter/doc
Emmanuele Bassi f94a903d9e layout: Add animation support to LayoutManager
In order to animate a fluid layout we cannot use the common animation
code paths as they will override the size request and allocation paths
that are handled by the layout manager itself.

One way to introduce animations in the allocation sequence is to use a
Timeline and an Alpha to compute a progress value and then use that
value to interpolate an ActorBox between the initial and final states of
the animation - with the initial state being the last allocation of the
child prior to the animation start, and the final state the allocation
of the child at the end; for every frame of the Timeline we then queue a
relayout on the layout manager's container, which will result in an
animation.

ClutterLayoutManager is the most likely place to add a generic API for
beginning and ending an animation, as well as the place to provide a
default code path to create the ancillary Timeline and Alpha instances
needed to drive the animation.

A LayoutManager sub-class will need to:

  • call clutter_layout_manager_begin_animation() whenever it should
    animate between two states, for instance: whenever a layout property
    changes value;
  • eventually override begin_animation() and end_animation() in case
    further state needs to be set up, and then chain up to the default
    implementation provided by LayoutManager;
  • if a completely different implementation is required, the layout
    manager sub-class should override begin_animation(), end_animation()
    and get_animation_progress().

Inside the allocate() implementation the sub-class should also
interpolate between the last known allocation of a child and the newly
computed allocation.
2009-12-13 01:13:42 +00:00
..
common docs: Clean up the additional documentation build 2009-11-30 21:33:22 +00:00
cookbook cookbook: Clean up the text 2009-12-01 10:11:33 +00:00
manual docs: Clean up the additional documentation build 2009-11-30 21:33:22 +00:00
reference layout: Add animation support to LayoutManager 2009-12-13 01:13:42 +00:00
clutter-actor-invariants.txt Enforce invariants on mapped, realized, visibility states 2009-04-24 15:27:19 +01:00
CODING_STYLE docs: Move documentation under doc/ 2009-12-01 10:16:25 +00:00
HACKING docs: Move documentation under doc/ 2009-12-01 10:16:25 +00:00
HACKING.backends docs: Move documentation under doc/ 2009-12-01 10:16:25 +00:00
Makefile.am docs: Move documentation under doc/ 2009-12-01 10:16:25 +00:00
RELEASING docs: Move RELEASING under docs/ 2009-12-09 18:10:52 +00:00