wmDiscoTux - an XMMS plugin for WindowMaker
-------------------------------------------

              version 1.3

    by Antti Takala <fragment@nic.fi>


wmDiscoTux is a simple xmms visualization plugin that sits nicely in 
windowmaker's (afterstep etc. should work too) dock. Actually, it
doesn't need to be docked at all. Tux moves his bodyparts with the music.
Now with fullscreen mode. Read the "features" section for more info.

how to install:
---------------

1) tar xvfz wmdiscotux-1.3.tar.gz
2) cd wmdiscotux-1.3
3) !! check the Makefile !!
4) make  (if doesn't build, try the binary in the package or edit the
          Makefile and/or sources)
5) make install (as root!)
6) start the plugin from XMMS's pluginmenu, configure and enjoy

hint: first run the plugin and drag it to windowmaker's dock. then close
xmms and change the icon's settings to start xmms when doubleclicked. now
when you run xmms from here, wmDiscoTux will always replace the icon and
run on the dock. I made an icon for wmdiscotux too. It's in the package.

fullscreen mode must be activated separately every time, it won't go
directly to the fullscreen mode on startup.


features:
---------
 - tux's head goes with bass (left + right channels)
 - tux's left leg with left treble and right with right
 - user configurable
 - strobo (now with 4 different colormaps)
 - small cpu load
 - fullscreen (320x240 only, your X should be configured to have this mode)

changelog:
----------

1.3: (released 16.11.2000)
 - fullscreen mode
 - "make install" now works
 - propably more bugs

1.2: (released 09.01.2000)
 - clicking tux opens the configuration window
 - reaction speed to the music can be adjusted
    (fast = strobo is flashy and tux moves very fast
     slow = strobo changes color gently and tux moves like in slow-motion)

1.15: (released 25.11.1999)
 - this is actually just a bugfix version for 1.1.. nothing new.
bugs fixed:
 - After you saved the new config, the color changed back to the
   original white and saved it, and not the color you chose... phew. 
 - leave-garbage-if-strobo-disabled bug fixed

1.1: (released 24.11.1999)
 - added three new colormaps for strobo (now four total)
 - some code cleanup
 - sources released
 - released an icon for xmms with a wmdiscotux in it

1.0: (released 21.11.1999)
 - made a raster strobo which can also be disabled.
 - some code optimization
 
0.95b: (released 17.11.1999)
 - better (?) headmoving thingy (doesn't always go 100% with the beat as
                                 the original one did)
 - configuration possibility:
       - if you don't like the new head, you can use the original one
       - the 'Z' can be disabled/enabled
       - eyeblinking can be disabled/enabled 
 - code optimized a lot

0.9b: (released 13.11.1999)
 - first release


upcoming features:
------------------

 - strobo sensitivity adjusting
 - maybe some cool effects for the GTK version (fullscreen mode)
 - tux (or many) dances around the screen (in fullscreen mode)
 - song title scrolling/showing in fullscreen mode (and other info too)
 - you tell me? =)

known bugs:
-----------

 - if paused/stopped (and sometimes when just started the plugin) it won't
   redraw the tux (if you know how to fix this then please tell me too :))

if you find any bugs, then please send me email what happened.

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

This plugin contains code from various plugins. I took the basecode from 
Pontus Klang's wmxmms spectrum analyzer (http://silicon.nu/~ponta/) and
the "about" and "configure"  -window stuff from the plugins which came
with xmms. The Tux is originally drawn by Larry Ewing (lewing@isc.tamu.edu)

Well, anyways.. all the rest is by me. 

PLEASE, send me feedback etc to ->	fragment@nic.fi
newest version can be found here ->	http://wmdiscotux.stc.cx/


	- Antti Takala, 16.11.2000