GKrellMMS: GKrellM XMMS Plugin

Little Themes Documentation:
----------------------------

Since GKrellMMS 0.5 it is possible to theme the XMMS-buttons. To do so,
you'll have to make (complete) buttons (background with button-labels on
it), and put them in a directory called 'gkrellmms' in the directory of your
current theme.

The images should be called:

prev
prev_clicked
play_pause
play_pause_clicked
stop
stop_clicked
next
next_clicked
eject
eject_clicked

Of course the images should have an extension.
You can make the images in the formats: xpm, png, jpg and gif.
The images width and height may be chosen by yourself, but are 12x9 by
default.

I only did a good working test on xpm's. The png-files got a gdk-warning,
but didn't cause problems with me.

-----------
Since GKrellMMS 0.5.3 you can theme the whole gkrellmms in some style.
You can find more info about theming plugins like that in the
Theme-authors manual (click through http://gkrellm.net/ to find it)


GKrellMMS has an extension to the base theme it has by default.  This
extension is so the scrolling text title panel can be themed independent
of the other two panels (the time panel and button panel).
To take advantage of all of these theming features, you must have
GKrellM version 1.0.3 or greater installed.  For prior versions, the
top_margin and bottom_margin settings will not work, and the values
set for top and bottom border are used both for image borders and for
text margin settings.
So, in addition to the above button images in the gkrellmms theme
subdirectory, there can be a separate background set for the scrolling
title:

       gkrellmms/bg_scroll.png

There can also be optional top and bottom spacer images that go above the
scrolling title panel and below the button bar panel:

       gkrellmms/bg_spacer_top.png
       gkrellmms/bg_spacer_bottom.png

And GKrellMMS theme parameters that can be set in a theme gkrellmrc are,
(these are similar to the values used in the default theme):

# Settings for the scrolling title panel:
       StyleMeter gkrellmms.alt_textcolor = black #dcdccc shadow
# If there is a separate bg_scroll image:
       set_image_border gkrellmms_bg_scroll 3,3,2,2
# Set margins around the scrolling text.  This panel uses extensions to the
# base GKrellMMS style settings and these extensions are implemented
# using set_integer:
       set_integer gkrellmms_scroll_margin 2
       set_integer gkrellmms_scroll_top_margin 2
       set_integer gkrellmms_scroll_bottom_margin 2

# Settings for the time bar and button bar panels.  These all use the base
# GKrellMMS style and are set in the standard way:
       StyleMeter gkrellmms.textcolor = #ffeac4 #000000 shadow
       StyleMeter gkrellmms.border = 30,3,2,0
       StyleMeter gkrellmms.margin = 2
       StyleMeter gkrellmms.top_margin = 2
       StyleMeter gkrellmms.bottom_margin = 0


-----------------------------------------------------
Comments, bugreports, and other stuff can be sent to:
sander@cerberus.demon.nl
