-- README ----------------------------------------------------------------------

Alloy is a KDE Style and KWin Decoration for KDE 3.x; please read the file
AUTHORS for more about the credits (code and design concept).

You can find info about installing in the INSTALL file; the license is the GNU
GPL (see COPYING for details).

Contributions are always welcome, please see the TODO file for a brief list of
ideas.

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

As of Alloy 0.4 it is possible to configure the intensity of gradients and also
override some colours using a config file. In the future this will be done from
Control Centre, however as of KDE 3.1 there is no standard way to do this so it
isn't implemented.  Hence you currently have to create the config file manually.
To do so, create a file in your ~/.qt/ dir called alloystylerc containing the
following:

*********** cut below ***********
[Settings]
darkGradientValue=10
lightGradientValue=3
rolloverColor=#RRGGBB
primaryColor=#RRGGBB
selectionColor=#RRGGBB
*********** cut above ***********

Any value that is either omitted or commented out (with #) will default.

The gradient values control gradient intensities, a higher value means a darker
gradient (up to a max of 100).  A value of 0 means no gradient.

  lightGradientValue is the gradient intensity on menubars, toolbars, header
  panels and Kicker taskbar buttons.  The default is 3.

  darkGradientValue is the gradient on buttons, tabs, progressbars and
  scrollbars, the default is 10.

The colour settings will override colours for certain widgets - note however
that this causes some side effects - such as the scrollbar in khtml not
following the 'theme' colours of webpages.  Please do NOT report colouring
bugs if you are overriding any colours.

The colours are in hex triplet's (#RRGGBB), eg #FFFFFF would be white,
#000000 black and #008B8B dark cyan etc.  They have the following effects:

  rolloverColor  - Mouse rollover highlighting of widgets
  primaryColor   - Scrollbar slider, progressbars
  selectionColor - Slider handle, checkbox tick, selected radiobutton






