mutter/examples
Emmanuele Bassi b20e9b78e5 actor: Add :z-position and deprecate :depth
The ClutterActor:depth property has always been a bit of a misnomer:
actors are 2D flat surfaces, so they cannot have "depth"; the property
defines the position on the Z axis.

Another side effect of the :depth property is that it decides the
default paint and allocation order on insertion, and that setting it
will call the ClutterContainer.sort_depth_order() method. This has
proven to be a fairly bad design decision that we strung along from the
0.x days, as it gives a false impression of being able to change the
paint and allocation order simply by changing the position on the Z
axis — something that, in reality, requires depth testing to be enabled
during the paint sequence of an actor's parent.

For 2.0 we need a clean break from the side effects, and a better
defined interface.

ClutterActor:z-position is essentially what ClutterActor:depth is, but
doesn't call into ClutterContainer, and has a more apt name.

https://bugzilla.gnome.org/show_bug.cgi?id=679465
2012-07-11 13:22:19 +01:00
..
basic-actor.c actor: Add :z-position and deprecate :depth 2012-07-11 13:22:19 +01:00
bin-layout.c Move examples from tests/interactive to a new top-level 2012-05-01 19:00:35 +01:00
box-layout.c examples: Updated box-layout example 2012-06-04 16:16:39 +02:00
canvas.c examples/canvas: Resize the canvas on allocation changes 2012-05-11 17:38:53 +01:00
constraints.c examples/constraints: Do not use deprecated API 2012-06-06 13:37:02 +01:00
drag-action.c examples: Update drag and drop action code 2012-05-24 13:58:31 +01:00
drop-action.c examples: Update drag and drop action code 2012-05-24 13:58:31 +01:00
easing-modes.c Move the easing modes test into the examples 2012-05-02 18:37:36 +01:00
flow-layout.c examples/flow: Do not use deprecated API 2012-06-06 13:36:46 +01:00
grid-layout.c examples: Add a grid-layout example 2012-06-05 12:28:40 +02:00
image-content.c Move examples from tests/interactive to a new top-level 2012-05-01 19:00:35 +01:00
layout-manager.c examples/layout-manager: Show transformations inside layouts 2012-06-27 21:28:01 +01:00
Makefile.am examples: Enable maintainer compiler flags 2012-06-06 13:39:50 +01:00
README Move examples from tests/interactive to a new top-level 2012-05-01 19:00:35 +01:00
rounded-rectangle.c Add rounded corners rectangle example using Canvas 2012-05-04 17:54:51 +01:00
scroll-actor.c Move scroll actor test to the examples 2012-05-17 10:57:15 +01:00
threads.c examples: Clean up the threads usage example 2012-07-11 13:22:19 +01:00

The code in this directory is meant to be XIncluded into the Clutter API
reference, and thus is to be considered part of the Clutter documentation.

As such, the code MUST be:

  - correct;
  - idiomatic, i.e. show how a task is meant to be achieved using the
    best possible practices given the current API;
  - well documented;
  - ready for copy and paste.