# PM123's Sound Visualization Plug-in

PM123 comes with a sound visualization plugin, `ANALYZER.DLL` which is located in the visplug directory. The plugin is visible right next to the volume bar. By default it shows the spectrum analyzer. Click it once to bring up the spectrum bars, a second time to bring up the oscilloscope and third time to disable it.

Note that because the spectrum analyzer is visual plugin and it is skin specific and will not display on older PM123 skins. But you can add them easily to any skin by editing the skin's `.SKN` file and adding this to it:

    1=visplug/analyzer.dll,x,y,size-x,size-y

Replace `x, y, size-x` and `size-y` with suitable coordinates (a easy way to find out the coordinates for a certain area is to load up PMView, take a Window capture of the skin and use the 'Track info' feature). You can also use WinAmp-compatible `viscolor.txt` files like this:

    1=visplug/analyzer.dll,x,y,size-x,size-y,viscolor.txt

The plugin will then read `viscolor.txt` and adapt to colors specified in it! This text file contains all the 24 colours that will be shown in the visualization area when it is active (oscilloscope or spectrum analyzer).

Each colour is defined by three decimal numbers (red, green and blue components) separated by a comma, everything between "//" and the end of a line is a comment, it won't be taken into account. Each component range between 0 (no colour, black) to 255 (full colour: red, green or blue), so 0,0,0 is black, 255,255,255 is white. The order of the colours is defined in the followed table: the fist two colours define the background and dots (check it to see what are the dots), the next 16 colours are the analyzer's colours from top to bottom, the next 5 colours are the oscilloscope's ones, from center to top/bottom, the last colour is for the analyzer's peak markers.

Line | Description
--- | ---
0 | Background color
1 | Dots color
2 | Top of spectrum analyzer
3 - 16 | Spectrum analyzer
17 | Bottom of spectrum analyzer
18 | Oscilloscope 1 (centre)
19 | Oscilloscope 2
20 | Oscilloscope 3
21 | Oscilloscope 4
22 | Oscilloscope 5
23 | Spectrum analyzer peak dots (unused at this time)