Root Window Visualization Plugin for XMMS Copyright (C) 2005 Johannes Jordan 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