Requires latest Samurize version

Encouraging usefulness for a better tomorrow.

Psy4

VolKnob 0.2b (2006-11) / Psy4

VolKnob 0.1b (2006-11) / Psy4

VOLKNOB IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.THE AUTHOR DISCLAIM ALL WARRANTIES, EITHER EXPRESS OR IMPLIED,INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL THE AUTHOR OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF THE AUTHOR OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

To load VolKnob you simply need to add the VolKnob.dll file in samurize plugin folder (ie: C:\Program Files\Samurize\Plugins\).

How to use VolKnob...

VolKnob as a VISUAL plugin can be used to control the volume of any mixer line of your soundcard.
To use VolKnob as a Visual plugin, you need ta add a new meter (any kind) and change the display type to "Visual Plugin" in the first tab. Then in the 'Display' tab, you have to choose 'VolKnob.dll' in the list of available visual plugins.
Now click on the 'Configure' button and choose your parameters.
/!\CAUTION/!\ : For the knob to be interactive, you MUST define 'INPUT' actions on the visual plugin : Go to the 'input' tab of the meter, check the 'Allow Input Controls' box and add 3 new input actions:
Each of these 3 actions will be defined using the 'Plugin Input' type, selecting 'VolKnob.dll' and each of the 3 available actions (No configuration is needed for actions)... So to work corectly, you must have 3 actions defined in the list : 'Left Mouse Drag', 'Left Mouse Up' and 'Left Mouse Down'.

VolKnob as a SOURCE plugin can only be used to return a list of controlable mixer lines.
First you have to add a new 'Plugin' meter, and then choose 'VolKnob.dll' in the plugin list. Then choose the 'getlines' function in the 'functions' list.

VolKnob settings

I have included a sample configuration file (VolKnob.ini) in the release to show some possibilities of this plugin... Take a look at this config to see some possible ways to use VolKnob.

Here are the descriptions of all parameters of VISUAL and INPUT parts of the plugin :

- Indicator image : This is the image you want to use as indicator (the rotative part of the knob).
This can be any image file (BMP, JPG, GIF, PNG, TIF and EMF supported) but i recommend using images with transparent parts for better results...
This image can represent the 'tick' indicating the knob position or the full know itself if you want to rotate the full knob.

- OnClick image : If the checkbox is checked, this is the image you want to use as indicator (the rotative part of the knob) when it is clicked.
This can be any image file (BMP, JPG, GIF, PNG, TIF and EMF supported) but i recommend using images with transparent parts for better results...
This image can represent the 'tick' indicating the knob position or the full know itself if you want to rotate the full knob.

- Background image : If the checkbox is checked, this is the image you want to use as background.
This can be any image file (BMP, JPG, GIF, PNG, TIF and EMF supported).

- Start angle : This is the starting position of the knob, indicating the zero.
Enter here a number between 0 and 360.

- Sweep angle : This is the course angle to represent the full knob scale.
Enter here any number... Here are some examples :

- Indicator offset : This is the offset applied to both indicator images. This value can be negative to obtain cool results ;)

- Controled line : This is the mixer line controled by the knob.
Enter here a number between 0 and 360.