From 9df2d83aa01762db41975c0a3db6fb86cdd1f1d8 Mon Sep 17 00:00:00 2001 From: Tomeu Vizoso Date: Fri, 15 Mar 2013 11:29:19 +0100 Subject: [PATCH] Add small note to the docs about the actor containers in the compositor https://bugzilla.gnome.org/show_bug.cgi?id=695935 --- src/compositor/compositor.c | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/src/compositor/compositor.c b/src/compositor/compositor.c index 2ef2d3644..dbaaca2d5 100644 --- a/src/compositor/compositor.c +++ b/src/compositor/compositor.c @@ -51,6 +51,19 @@ * is called. If the live_hidden_windows preference is set, windows will never * be unmapped. * + * # Containers # + * + * There's three containers in the stage that can be used to place actors, here + * are listed in the order in which they are painted: + * + * - window group, accessible with meta_get_window_group_for_screen() + * - top window group, accessible with meta_get_top_window_group_for_screen() + * - overlay group, accessible with meta_get_overlay_group_for_screen() + * + * Mutter will place actors representing windows in the window group, except for + * override-redirect windows (ie. popups and menus) which will be placed in the + * top window group. Mutter won't put any actors in the overlay group, but it's + * intended for compositors to place there panel, dashes, status bars, etc. */ #include