Project

General

Profile

Wiki » History » Version 10

Arnaud Fontaine, 02/10/2010 05:06 PM
Add sections from the MSc thesis and shortcomings section

1 10 Arnaud Fontaine
h1. What is a Compositing Manager?
2 1 Arnaud Fontaine
3 10 Arnaud Fontaine
Basically, a compositing manager is a piece of software running along with the window manager and where each graphical program outputs into a separate and independent off-screen buffer that can be manipulated before being shown in order to enhance user experience. Unlike a compositing window manager, a compositing manager does not manage windows but simply implements visual effects such as windows translucency, drop shadows, fading...
4 1 Arnaud Fontaine
5 10 Arnaud Fontaine
h1. Unagi overview
6 1 Arnaud Fontaine
7 10 Arnaud Fontaine
Unagi is a modular compositing manager which aims to be efficient, lightweight and responsive. It is currently written in C programming language and based on "XCB library":http://xcb.freedesktop.org client library. Any existing window manager can be used as long as it implements properly "EWMH":http://standards.freedesktop.org/wm-spec/wm-spec-latest.html and "ICCCM":http://tronche.com/gui/x/icccm/ specifications (or at least parts of it which are needed), which is generally the case nowadays.
8 10 Arnaud Fontaine
9 10 Arnaud Fontaine
This project also aims to provide a functional and stable software to improve window manager usability from an end-user point of view (for instance windows translucency, application-switcher using live thumbnails instead of plain icons, "Exposé":http://en.wikipedia.org/wiki/Expos%C3%A9_%28Mac_OS_X%29...), therefore it does not intend at all to provide useless eye-candy effects.
10 10 Arnaud Fontaine
Concepts.
11 10 Arnaud Fontaine
12 10 Arnaud Fontaine
Unagi relies on a modular architecture as the code is split up in three parts: core code, rendering backends (only one backend relying on Render X extension has been implemented so far) and effect plugins. Thus, it provides a small and fast compositing manager from a codebase and footprint point of view, besides allowing to easily write other rendering backend which would work better on certain hardware. It also tries to take advantage of the asynchronous XCB model to be able to be used through a network.
13 10 Arnaud Fontaine
14 10 Arnaud Fontaine
h1. Current shortcomings
15 10 Arnaud Fontaine
16 10 Arnaud Fontaine
* Early stage of development
17 10 Arnaud Fontaine
* Tested almost only with Awesome Window Manager
18 10 Arnaud Fontaine
* Performance issues which will be addressed in the next release though
19 10 Arnaud Fontaine
20 10 Arnaud Fontaine
h1. Contribute
21 10 Arnaud Fontaine
22 10 Arnaud Fontaine
If you wish to contribute, you can find further information in document:"Master thesis: Writing an X compositing manager" and general information about "XCB":http://xcb.freedesktop.org in document:"Bachelor thesis: Porting a window manager from Xlib to XCB". You can also have a look at the documentation generated from the source code available "there":https://projects.mini-dweeb.org/embedded/unagi.
23 10 Arnaud Fontaine
24 10 Arnaud Fontaine
h1. Screenshots
25 10 Arnaud Fontaine
26 1 Arnaud Fontaine
Here are some screenshots of Unagi running with Awesome Window Manager.
27 1 Arnaud Fontaine
28 10 Arnaud Fontaine
h2. Opacity plugin
29 5 Arnaud Fontaine
30 4 Arnaud Fontaine
!opacity-enabled.png!
31 1 Arnaud Fontaine
32 10 Arnaud Fontaine
h2. Expose plugin
33 3 Arnaud Fontaine
34 10 Arnaud Fontaine
h3. Expose plugin before being enabled
35 1 Arnaud Fontaine
36 9 Arnaud Fontaine
!expose-disabled.png!
37 6 Arnaud Fontaine
38 10 Arnaud Fontaine
h4. Expose plugin when enabled
39 6 Arnaud Fontaine
40 9 Arnaud Fontaine
!expose-enabled.png!