
NOTE: It's currently not yet possible to create complex themes (using multiple
display lists) from within the vsa applet, however you can create them by
editing the theme.info file manually.


Themes are stored in ~/.vsa/themes/<id>/
the file theme.info contains the display lists and plugin variables,
any images used in the theme should be stored in this directory as well.
(this is only necessary if you intend to export the theme and share it with
other people)



BUILTIN PLUGINS
---------------

There are currently 3 builtin plugins, Color (for single color background),
Image (displays an image in any of the formats recognized by imlib), and
Display List.



DISPLAY LISTS
-------------

A display list is a list of plugins (or other display lists), each list has
it's own configurable rectangular area in the app window in which the output
of the plugins is displayed. Another purpose of DLs is if you want a plugin
operation to only affect certain plugin(s). For example, if you want a faded
scope on a starfield background, the list would look like this,

- starfield
+ <DL>
  - scope
  - fader
 
Otherwise the fader will also fade the starfield.


<more later>
