2007-01-16 17:45:18 +00:00
|
|
|
The compositor is the box of tricks inside the window manager which performs
|
2007-01-16 19:11:13 +00:00
|
|
|
special effects on the windows on your screen. Metacity's compositor is
|
2007-01-16 17:45:18 +00:00
|
|
|
under development. Your help is requested in finding and fixing bugs. This
|
|
|
|
document tells you how to configure Metacity so that you can use compositing.
|
|
|
|
|
|
|
|
To turn the compositor on initially, you need to pass --enable-compositor to
|
|
|
|
the configure script. This will introduce a dependence on libcm, which you
|
|
|
|
can get from <URL:http://ftp.gnome.org/pub/GNOME/sources/libcm/>.
|
|
|
|
|
|
|
|
When Metacity is compiled, you will need to turn the compositor on in gconf
|
|
|
|
for it to have any effect. You will find the boolean switch at
|
|
|
|
|
|
|
|
/apps/metacity/general/compositing_manager
|
|
|
|
|
|
|
|
When that's done, you can set some environment variables before you launch
|
|
|
|
Metacity to influence how the compositor works. These will eventually become
|
|
|
|
configuration options or gconf options when they grow up. Define them to any
|
|
|
|
value to turn them on; leave them undefined to turn them off. Currently the
|
|
|
|
options you can set are:
|
|
|
|
|
|
|
|
LIBCM_DIRECT
|
|
|
|
|
|
|
|
If this is set, the compositor will bypass the X server and do all its
|
|
|
|
work directly with the hardware. I know of no reason you would want to
|
|
|
|
do so, but perhaps you do.
|
|
|
|
|
|
|
|
LIBCM_TFP
|
|
|
|
|
|
|
|
If this is set ("tfp mode"), the compositor will feel free to use the
|
|
|
|
texture_from_pixmap extension; if this is not set ("non-tfp mode"), the
|
|
|
|
compositor will use a workaround. Many drivers require non-tfp mode in
|
|
|
|
order to work, and will paint all windows clear blue or clear white
|
|
|
|
without it. Thanks to Travis Watkins for suggesting this switch; he
|
|
|
|
cautions that some games or video players may require tfp mode.
|
|
|
|
|
|
|
|
METACITY_BLING
|
|
|
|
|
|
|
|
This turns on several pretty but non-essential animations (dialogues
|
|
|
|
fracturing and exploding, minimisations doing a shrinkydink effect,
|
|
|
|
and so on). If it is not set, the standard non-GL animations are
|
|
|
|
retained. This affects only window event animations; it doesn't change
|
|
|
|
menus zooming, dialogues being semi-transparent, and so on. Try it
|
|
|
|
and see whether you like it.
|
|
|
|
|
Comprehensively rename to Mutter
Code:
All references in the code not related to themes, keybindings, or
GConf were changed from 'metacity' to 'mutter'. This includes, among other
things, strings, comments, the atoms used in the message protocol, and
the envvars used for debugging. The GConf schema file was reduced to
the 3 settings new to mutter.
The overall version was brought up to 2.27 to match current gnome.
Structure:
All files named '*metacity*' were renamed '*mutter*' with appropriate
changes in the automake system. Files removed are
doc/creating_themes, src/themes, doc/metacity-theme.dtd,
metacity.doap. These files will eventually end up in an external
gnome-wm-data module.
Installation location:
On the filesystem the mutter-plugindir was change from
$(libdir)/metacity/plugins/clutter to just $(libdir)/mutter/plugins.
The mutter-plugins.pc.in reflects these changes.
Note:
mutter.desktop.in and mutter-wm.desktop both continue to have
X-GNOME-WMSettingsModule=metacity set. This allows
gnome-control-center to continue using libmetacity.so for
configuration. This is fine since most the general keybindings and wm
settings are being read from /apps/metacity/* in gconf.
2009-06-10 10:29:20 +00:00
|
|
|
If you have any problems, ask on mutter-devel-list@gnome.org, or
|
2007-01-16 17:45:18 +00:00
|
|
|
#gnome-hackers on gimpnet, or come and find me (tthurman at gnome) and ask.
|