USAGE AGREEMENT:
This software is provided as FREEWARE, 
but only for private, non-commercial use. 

This software is provided "as is". The author 
cannot be held responsible for any loss of data 
or other misfortunes resulting from the use of 
this program. 
___________________________________________________



RGB-LED Plugin V1.0 Beta for Winamp 
-----------------------------------

1. Introduction
2. Installation instructions
3. Notes
4. More detailed description


1. Introduction
---------------
This Winamp plugin changes the color of an RGB-LED 
according to the music. Originally it was designed 
for the Chromoflex color control device, but 
theoretically it could also be upgraded for other 
(RGB-)LEDs/case-modding-lights or whatever can be 
controlled via PC. But at the moment only one single 
Chromoflex LED is supported. 

Some features:
  - Beat detection
  - White Balance
  - Color is also shown on screen (no LED needed)
  - Many different effects possible
  - Effects can be customised
  - Maybe a bit too complicated
  - Plugin also has (a simple) plugin architecture


2. Installation instructions
----------------------------
 - .NET Framework 2.0 has to be installed
 - Copy vis_rgbled.dll to your Winamp\Plugins Folder
 - Copy all other files to your Winamp folder


3. Notes
--------
I think you have to change the white balance 
(or disable it) for the predefined effects. 
#BBFF66 is a good-looking white for my LED 
(which is a 3W Seoul Z-Powerled), but maybe 
not for yours. 

The Plugin can be started under: 
Winamp-Properties -> Plugins -> Visualization

ChromoflexOutput2 is still buggy :(
If it shows something like: 
"Access to port COMx is denied from System" 
then just set the right port, save it and 
restart Winamp. Sometimes it also occurs, 
that Winamp crashes due to this buggy 
component... 


4. More detailed description of components
------------------------------------------

---ChromoflexOutput---
Sends color via RS232 to Chromoflex module. 

---ChromoflexOutput2---
Another implementation of ChromoflexOutput. This one
is faster and offers the possibility of white-balance. 
Unfortunately it's still a bit buggy. 

---ColorFade---
Fades between Colors. 
Colors in following formats:
  - hex
    #aabbcc
    #abc
    aabbcc
    abc

  - decimal
    (1, 2, 3)
    11, 22, 33
    (1;2;3)
    111 222 333
    ...    

---Combiner---
Creates a new color by summing up 
(or taking average of) other colors.

---Effect---
Just executes some other things. Can be used 
within the Combiner or to summarise something. 

---EnergyBasedBeatDetection---
      and
---FrequencyBasedBeatDetection---
These components calculate a beat value and 
store it into a custom value. SMOOTHING should
be used afterwards. 
Many thanks to: 
http://www.gamedev.net/reference/programming/features/beatdetection/

---ModifyHSL---
Changes hue, saturation or lightness of an 
existing color. 

---SetRGB---
Sets Red, Green and/or Blue color to a custom value. 

---SimpleBeatDetection---
Not really beat detection, but maybe useful for 
some effects. 

---Smoothing---
Softens color changes which are very prompt. 
Should be used after beat detection. 

---SpectrumFade---
Fades through many colors by setting saturation 
and lightness to a constant value and increasing 
hue over time. 

