Login.app theme description
-----------------------------------------------------------------------

Themes are intended to be a simple way to change the look of your
Login window.

You can create a theme for Login.app by making your own set of graphics
and a custom 'Settings' file in their own directory under (by default)
/usr/local/GNUstep/Apps/Login.app/Themes/

For example, if you want your theme to be named 'Foobar', you would 
create a directory /usr/local/GNUstep/Apps/Login.app/Themes/Foobar/ 
and place your graphics and Settings file in that directory. To change 
which theme Login.app will use, change the Theme name in your 
Preferences file to the name of your theme (in this case, 'Foobar').

When making your custom graphics, you can use any format supported by
your libwraster.so lib. This will depend on which formats you have
compiled support into the library for.

Making the graphics should be the easy part. ;) Simply make a nifty
keen Login panel, and then cut it into parts, pay attention to the
x and y coordinates of the top-left corner of the pieces you cut! 
These will need to be entered into the 'Settings' file for your Theme. 
You can save yourself a headache by getting these right the first 
time... adjustment by visual trial and error afterwards can be a pain.

Alpha channel transparency is supported in some formats (.tiff and
.png, depending on your library), but -only- for the InputFields image.
The InputFields image also needs to be the -same- size as the Panel
image. See one of the Default themes for an example.

Everything should be rather simple to figure out if you use the 
included themes as a guide. :)

------------------------------------------------------------------

Screen coordinates for PanelPosition = "x, y"

                x
-----------------------------------
|               |                 |
|               |                 |
|     -x,-y     |     +x,-y       |
|               |                 |
|               |                 |
|---------------+-----------------|y
|               |                 |
|               |                 |
|     -x,+y     |     +x,+y       |
|               |                 |
|               |                 |
-----------------------------------

------------------------------------------------------------------

Frequently asked questions
---------------------------

Q) When I test my theme out, I get the error like
   Login: raster.c:183: RCombineImages: Assertion \
                            `image->width == src->width' failed.

A) This is generelly caused by either placing the coordinates for
   one of your images outside the boundaries of the panel, or by
   using an inputfields image which does not match the size of 
   your panel image. Double check that everything matches up
   size-wise, and that you have the correct coordinates in the
   'Settings' file for you theme. 


Q) I used .png graphics for my theme, and now everything looks
   really dark, what's wrong?

A) wraster was modified to correct the overly bright gamma on the
   GNOME icons, which unfortunately makes other .png's excessively
   dark. This has been fixed in Window Maker as of version 0.62.0.

