mirror of
https://github.com/brl/mutter.git
synced 2024-11-23 08:30:42 -05:00
b20e9b78e5
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 |
||
|---|---|---|
| .. | ||
| basic-actor.c | ||
| bin-layout.c | ||
| box-layout.c | ||
| canvas.c | ||
| constraints.c | ||
| drag-action.c | ||
| drop-action.c | ||
| easing-modes.c | ||
| flow-layout.c | ||
| grid-layout.c | ||
| image-content.c | ||
| layout-manager.c | ||
| Makefile.am | ||
| README | ||
| rounded-rectangle.c | ||
| scroll-actor.c | ||
| threads.c | ||
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.