8. Faq

Please send questions to mallum@openedhand.com.

8.1. How do I create 'shaped' windows ?

Add an options='shaped' attribute to the windows types frame definition. Any parts of the defined frame that has a completely transparent alpha channel will be transparent. See the blondie theme for an example.

8.2. How do I set a custom defualt application icon ?

Use the top level 'appicon' tag. eg;


<pixmap id="defaulticon" filename="defaulticon.png" />

<appicon pixmap="defaulticon">

8.3. How do I set the lowlight color ?

Use the top level 'lowlight' tag. eg;

<color id="mylowlightcol" def="#819cba33" />

<lowlight color="mylowlightcol" />

Note, matchbox wm must be run with '-use_lowlight yes' switch for this to take effect.

8.4. How do I set window shadows ?

Firstly matchbox-window-manager must be built with the --enable-composite compile option and both composite librarys and a composite enabled X Server for this options to take effect.

Shadows are created with the top level <shadow/> tag. eg;

<shadow style="gaussian" color='shadowcol' />

style, can be one of gaussian, simple ( solid color ) or none.

color, specifys the shadow color.

Other attributes available include integer ( can be negaive ) shadow offsets - dx,dy and shadow padding - width, height. Currently these options only work for simple shadows.

Also it should be stressed this functionality is highly experimental.

8.5. How do I define a area for in the titlebar for a panel ?

Use a 'panel' tag in the the main frame definition. eg;

<panel x="100%-60" y="0" w="50" h="100%" />

Note, matchbox-panel must be run with '--titlebar' for it to reparent in this defined area.

8.6. Where can I find more infomation ?

See the various themes included with the matchbox distrubution ( in data/themes ) and the matchbox-themes-extras package. 'Blondie' is a fairly advanced 'heavy' theme that uses many themeing properties. Bluebox is a lighter XPM based theme. Borillo is a relatively simple theme designed more for larger displays, using few (2) external images.

Also the matchbox-tests package contains the 'mbtest' theme which uses many of the experimental features.