Root Window Visualization Plugin for XMMS
Copyright (C) 2005 Johannes Jordan <fopref@lanrules.de>
Version: 0.0.8 (Dec 30 2005)
http://fopref.meinungsverstaerker.de/xmms-rootvis/
An XMMS Visualization Plugin which draws a Spectrum Analyzer onto the X Background.
I want to dedicate this project to Athanasia Kaisa.
** To configure it, you have to edit your ~/.xmms/config file after starting ** the plugin a first time (it creates the necessary editable entrys). ** Only color values are configurable via GUI up to day. ** Please note, that you have to restart xmms to enable/disable stereo, ** while for other changes pressing "Revert" in the GUI config will do it, too.
** NEW IN 0.0.8: ** (important for upgraders) *****************************
Please note, that this is not the same thing as 0.0.7 anymore. It could be that you like 0.0.7 more! Just choose yourself, while further releases should provide the features of both versions.
There are new config variables.. Just check them out!
Be sure to use all settings in range!
(i.e. don't use orientation higher than 3 or div lower than 1)
Following the description of the possible settings:
stereo 0 = channels combined, 1 = both channels drawn seperate
geometry_display EXPERIMENTAL: the X server address
This is usefull for multihead users
(i.e. left channel on :0.0, right one on :0.1)
NEVER give it a server it can't connect to
(xmms' gtk won't be pleased)
geometry_posx left X coordinate
geometry_posy top Y coordinate
geometry_orientation from where to where the bars should grow
0 = bottom->up, 1 = top->down, 2 = left->right, 3 = right->left
geometry_height maximum height in pixels
geometry_space space in pixels between bars
bar_width width in pixels of a bar
bar_shadow shadow offset in pixels of a bar (0 = no shadow)
bar_falloff falloff of bars in pixels per frame
bar_gradient wether to draw gradient or not
bar_bevel wether to draw bevel or not
peak_enabled 1 to enable, 0 to disable peak drawing
peak_falloff falloff of peaklines in pixels per frame
peak_step count of frames peaks resist the falloff
peak_shadow wether peaks have a shadow, too
data_cutoff between 0 and 255, as we have 255 frequency sources
this is to cut away higher frequencies which mostly
aren't interesting
data_div count of sources per bar (can be from 1 up to cutoff)
data_linearity is to be set between 0 and 1.. 0.3 is linear
data_fps count of frames to draw per second
** Colors are to be defined in the HTML alike hex triplet format ** this means #rrggbb, whereas the three color values can go from 00 to FF/ff ** The best way to configure your colors is to use the GUI! Don't forget to ** press the "Save" button :)
bar_color_1 color on bottom of the bars bar_color_2 .. at 2/5 bar_color_3 .. at 4/5 bar_color_4 .. on top of the bars bar_bevel_color bevel color bar_shadow_color shadow color peak_color color of peak lines debug set this to 1 to get some status messages on stdout
** STEREO SUPPORT:
To use the stereo feature, set stereo to "1".
Edit everything under [rootvis2] for the second channel.
Please note that to change from mono to stereo and vice versa, you have to restart (disable/enable) the plugin rather than only pressing "Configure".
As disabling/enabling is very unstable, you will probably have to restart xmms.
It should work on all Unices that like XMMS, and is reported to work on Linux and FreeBSD. If you're using KDE and wonder why there's nothing to see, check the following option:
Control Center -> Desktop -> Behaviour -> Misc Options:
[x] Programs in desktop window
Up till now this plugin's very basic, but I have many features planned. See the ChangeLog for future plans.
If performance is an issue for you: Watch out for the CPU consumption of X. X needs CPU time to draw which is measurable at least on slow systems.
This release is CPU consuming, I hope I can improve that in future.
PLEASE REPORT BUGS VIA MAIL! Use debug=1 and send the full console output.
If you found a bug or have comments, feature requests or stuff, feel free to
drop an email. If you want to make this even more usable, please notify me of
your efforts :)
I also like to see it in action, so I would be pleased to receive a screenshot.
KNOWN BUGS:
There are stability problems on startup, re-enabling, disabling. Sorry for that!
If the thing's up and running, there shouldn't be any problem. If you find one,
please report it to me!
See AUTHORS if you're interested in whom's work I used to write this. My additional thanks go to Fatal from #xmms for early release testing.
Regards,
Johannes