IMPORTANT:
Don't use shitty drivers because this will run slow as all hell! I was using whatever default drivers came with RH 7.2 for my Geforce 2 and man did that suck.  It ran SO slow at resolutions like 320 x 240.  Then I installed the real nVidia drivers and it runs fine.  So get a good card with good drivers or expect it to suck big fat donkey dick.

Also you can now change the speed in the config screen.  It allows you to go all the way up to 5000 (because it looks pretty cool that fast) but I recommend most of the time you keep it down below 1000.

NOTE: This is just a heavily messed with version of iris 6.0 I tried basically putting Madspin code in instead of iris. Madspin code is available at http://www.reethaxor.com I believe. Lots of thanks to Cedric and Joe.

Also if you want to know what Madspin is REALLY about check out the version under windows.  The reason this looks lamer than regular madspin was I couldn't get the equations to calculate the points to work the same as in the windows version so I just made up own crappy version that does nothing near as interesting as the regular Madspin.

OK, here was the original read me since it probably still mostly applies :)


*** START IRIS README ***
(read PROBLEMS if you use NVIDIA drivers 0.9-767 or 0.9-969 !)

IRIS O.6
----------

IRIS is a OpenGL visualization plugin, based on the OpenGL spectrum analyzer, part of xmms (www.xmms.org).

I describe it like a "3D circular spectrum analyzer", but you should try it to understand what I mean :)


To install it : see INSTALL file
You need : glib 1.2, gtk+ 1.2, xmms 1.2.4 and an OpenGL library.
IRIS 0.6 has been written under a NVIDIA accelerated X Server, so if you have any problems with this configuration maybe your installation is wrong.

My configuration is: 	PII 350, 128Mo SDRAM
			16MB RIVA TNT
			XFree86 4.0.2
			NVIDIA driver 0.9-767
			glib 1.2.9
			gtk+ 1.2.9
			xmms 1.2.4


Once installed, you can launch the plugin in xmms like this:
	- press Control-v
	- choose IRIS 3D analyzer 0.6
	- click on "Enable plugin"

4 possibilities :
	1. it works :)
	2. the X server crashes (it never happened to me !). Please look at /var/log/XFree86.x.log and verify your installation.
	3. xmms crashes. try to run xmms on a terminal and look if there are error messages.
	4. IRIS is not proposed on the plugin list. try to run xmms on a terminal and look if there are error messages.

If you need more help send me an email.


To configure the plugin:
	- press Control-v
	- double click on IRIS 3D analyzer 0.6 or click "Configure"


When the plugin is running:
	o the "z x c v b" keys are bound to the same as it is in the main window of XMMS.
	o the left and right arrow keys change the rotation speed.
	o you can resize its window


PROBLEMS:

o With NVIDIA drivers 0.9-767 et 0.9-969, if you try to disable the plugin xmms will crash (try killall -9 xmms). This bug affects all OpenGL plugin for xmms. The 0.9-6 version was working fine.

In this case, to disable IRIS, you need to manually edit this file : ~/.xmms/config
Find this line:			enabled_vplugins=libiris.so
And modify it like this:	enabled_vplugins=


o you can't launch two openGL plugin in xmms at the same time.


NOTES:

o This is my fist work with OpenGL : code may be ugly.

o plugin programming is fun :)

--
Cdric DELFOSSE
cdelfosse@free.fr
("my french is better than my english")

