Root window

In the X Window System, a window is the region of the screen where drawing can occur. The root window covers the entire screen surface. Every window created is contained within it, forming a hierarchy with the root window at the very top. All other windows are either children or descendants of it.

A possible placement of some windows: 1 is the root window, which covers the whole screen; 2 and 3 are top-level windows; 4 and 5 are subwindows of 2.

Since every window covers the part of its parent it is staying on, all other windows appear to be above the root window. As a result, the root window is visible as the part of the screen that is behind all other windows. In other words, the root window forms the background of the screen. An image can be used as the wallpaper of the screen by setting it as the background image of the root window. This can be done for example using the xsetroot or the xv programs.

The direct children of the root window are called top-level windows. These windows are usually drawn with a decorative frame and a title bar (which are actually added by the window manager). The top-level windows are, informally, the regular windows in the terminology of most GUIs. The windows that are not top-level are used for buttons, textboxes, etc.

The properties of the root window are sometimes used as a rudimentary form of inter-client communication means. For example, the cut buffers are properties of the root window that are used for copying selected text from a window to another, and the dwm window manager displays the root window's name in a status area. The X resources are also stored, during execution, in a property of the root window.

Virtual root window

The swm window manager introduced the virtual root window. From the point of view of the X protocol, this is a regular window. However, X window managers using the virtual root window reparent all windows to it instead of to the real root window. Virtual root windows are mainly used by re-parenting window managers, for example, for realizing a number of virtual desktops the user can switch between.

Other clients (beside the window manager) may need to use the virtual root window. The identifier of this window can be found in a window property named __SWM_VROOT in a direct child of the real root window. Technically, many programs use the macros for finding the root windows as redefined by an include file named vroot.h.

The freedesktop window manager specification requires a property named _NET_VIRTUAL_ROOTS of the real root window to contain a list of the windows that are acting as virtual root windows; the virtual root window that is currently active can be found in the property _NET_CURRENT_DESKTOP of the real root window.

The virtual root window is used by the window managers swm, tvtwm, amiwm, and enlightenment. Other systems such as KDE use a virtual background window (which contains the icons, for example) but do not reparent the other windows to this one. The virtual root window is also used by XScreenSaver: when the screensaver is activated, this program creates a virtual root window, places it at the top of all other windows, and calls one of its hacks (modules), which finds the virtual root window and draws in it.

Utilities that use the root window

• Conky

See also

• X Window System
• X Window System protocols and architecture

External links

• Extended Window Manager Hints from freedesktop.org
• toon_root.c, a source file of XPenguins that contains information about virtual root/desktop windows for various window managers