Dancing Particles configuration HOW-TO

Dancing particle is highly configurable.

Its configuration file is located at:
~/.xmms/Plugins/dancingparticles.conf
or
/usr/local/share/dancingparticles/params

So to begin editing your conf file you have to:
cp /usr/local/share/dancingparticles/params ~/.xmms/Plugins/dancingparticles.conf

Then you can edit the file with your favorite editor.

What you have to know
---------------------

You can change the configuration dynamicaly. 
The config file is automagically reloaded..

Then the basic steps are:
 -make little modifications
 -save
 -see the marvelous effects..

The syntax is case sensitive. be carefull

The parser is very primitive.

Each effect is described in a 
--
Begin Effect
End Effect
--
structure.
Then, you can change any parameter with the syntax: 
--
	param 	= value  # this is a commment
--

An effect basicaly herits from another effect its default params
ie when you say:
--
Begin Effect inherits toto
End Effect
--
All the params are inherited of the "toto" effect, you just have to add a name, and only specify the params you would like to change.

What do each params?
This is documented in the distribution's config file.


TIPS
----

When improving your effect, just increase its chance to a great number (100000, for ex), than it will be choosen automatically.