Infinity -- An  XMMS Visualization Plugin
------------------------------------------

http://infinity-plugin.sf.net

by Julien Carme Copyright(C) 2000.
Duilio J. Protti (c) 2004.

Infinity is a XMMS plug-in which generate full-screen interactive light effects
according to a music.

To run the plug-in, 
-run xmms
-enter the visualization plug-ins menu (Ctrl-V), 
-choose Infinity.
-choose Configure, and your resolution.
-choose Enable, and press Tab to enter Full-Screen mode.
-to stop it, press Tab again and disable it.

You can change the resolution in the configuration menu. In full-screen mode,SDL 
should choose the best possible resolution according to the resolution you asked 
for. For example, 640x300 will display a letter-box screen in 640x480.
See SDL section for more information about the scale factor.

You don't need to be root to enter the full-screen mode.

There is two different modes in this plug-in, the default mode is non-interactive:

-Non-Interactive Mode:

States and palettes are selected randomly, and change sometimes.

The following command keys will be showed when Infinity were loaded from
XMMS. If you want to see it, run XMMS from a terminal.

  Keys:
  - Space:	change effect.
  - Tab:   	toggle full-screen.
  - Up/Down:	up/down xmms main volume.
  - Left/Right:	reward/forward actual played song, if any.
  - z:		previous song.
  - x:		play.
  - c:		pause.
  - v:		stop.
  - b:		next song.
  - Enter:	switch to interactive mode.
  		(works only if infinity was configured with --enable-debug option)
  - F11:   	screenshot.
  - F12:   	change palette.


-Interactive Mode:

You can control the effect:

  Keys:

  - F12:    change palette.
  - Tab:    toggle full-screen.
  - Enter:  switch to non-interactive mode.
  - F1-F10: choose transformation vector field
  - a,z:    change curve 1 lighting
  - q,s:    change curve 2 lighting
  - e,r:    change curve 1 amplitude
  - d,f:    change curve 2 amplitude  
  - w:      change curve 2 type
  - mouse:  change curve 2 position  
  - F11:    screenshot

SDL:
----
You must have installed a recent version of SDL (>=1.0.6) to run this program.
If you experience problems with SDL, refer to their documentation first.
If you cannot obtain low resolutions, you should add them to the
screen section of your /etc/XF86Config (you can use your X configurator
instead of editing it yourself). If and only if you cannot change your 
XF86Config, you can change the scale factor in the preference menu. But 
the program will be much slower.

Known Bugs:
-----------

Your X has to be at least in 16 bpp to make this program work. If you have more
than 16 bpp, it should work but may be very slow.
Preferences cannot be changed while the plug-in is enabled.

If you have problems finding locale.h header file, try to configure with
--disable-nls option.

If you found a bug on this program, please take five minutes of your time and
fill a bug report on the project's site <http://infinity-plugin.sf.net>.
The author will work for to solve the problem.

Contributions
-------------

This project actually (2004) needs people that makes translations and people
who made binary distributions. Translations are very easy because of the
gettext system, and because Infinity have just a few translatable strings
(and that will not change, because this is a plugin, and doesn't have a
heavy user interaction).
Both translations and binary packages are very important because the intended
audience of this project are end users, so we must leave things as simple as
possible to this users.

If you want to keep track of Infinity development, subscribe to our
development mailing list at:

http://lists.sourceforge.net/mailman/listinfo/infinity-plugin-devel

You don't need to became a project developer to subscribe to this list.

New Features
============

If you like any new feature on this program, please fill a feature request
or directly submit a patch to SourceForge's project site at:

http://sourceforge.net/projects/infinity-plugin


Duilio J. Protti.

