zVolume v1.1
by ZealotSix (Travis Collins)
travistx@gmail.com
http://www.visualinfusion.com
24 June 2006


*****************************************************************************
**   Change Log                                                            **
*****************************************************************************

 1.1: 6/24/2006
   - Added hand cursor when the mouse is over the sliders or mute buttons
   - Added additional event handlers, to make the sliders more sensetive
   - Updated the sliders in the default skin to make the clickable area twice
      as wide.


 1.0: 6/20/2006
   - First Public Release



*****************************************************************************
**   What is it                                                            **
*****************************************************************************
zVolume is a plugin for the alternate windows shell, Aston 
(http://www.astonshell.com).  It will display a volume control on the user's
desktop, with up to four volume sliders.



*****************************************************************************
**   System Requirements                                                   **
*****************************************************************************
zVolume has only been tested on Aston 1.9.2 running under Windows XP.
Your milage may vary, I make no promises of system compatibility.



*****************************************************************************
**   Installation                                                          **
*****************************************************************************
1) Open the Aston Options
2) Click on to the Plugins section
3) Click Add and then select the zVolume.plg
4) Hilight the zVolume entry and click the Setup plug-in button
5) Click File and choose Load Settings
6) Pick one of the default apc files that came with the plug-in



*****************************************************************************
**   Settings                                                              **
*****************************************************************************
X/Y:
   The coordinates that the main window will be displayed at.

Locked:
   Locks the X/Y Coordinates.  Prevents the window from being dragged.
   NOTE: With the plugin locked, you can still drag the window if you hold
         down the shift key.

Background Skin:
   The skin for the background of the plugin.

Slider Skin:
   The skin for the volume sliders.  This should be a multi-frame animation 
   similar to the one that you might use for AMonitor or DisksEx.  It can 
   have as many frames as you would like.  The first frame is the volume at 
   0% and the last frame is the volume at 100% (max).

Slider FrameCount:
   The number of frames in the above mentioned animation.

Mute Skin:
   The skin for the mute button.  This should be a 2 frame animation 
   The first frame represents the un-muted state
   The second frame represents the muted state.

Slider Orientation:
   Horizontal or Vertical slider orientation.


(The next settings are repeated for each volume control, up to 4)

Volume Control:
   Select the audio channel that you would like this slider to control.
   Select "None" if you would like to turn off a volume control.

   NOTE: Not all channels will work with all sound cards.  This is something
   that is not within my control, sorry.

Slider 1 X / Y:
   The coordinates of the volume slider (relative to the main skin).

Mute 1 X / Y:
   The coordinates of the mute button (relative to the main skin).



*****************************************************************************
**   Thanks To                                                             **
*****************************************************************************
Gladiator Software - For the excellent shell replacement, and for 
                    providing a SDK



*****************************************************************************
**   Feedback, etc.                                                        **
*****************************************************************************
Send questions, comments, bugs reports, desired features, and alcohol to:
ZealotSix  travistx@gmail.com
