Dial (Pot)
The Pot View provides a mouse-adjustable dial for editing channel and option values. Â Additionally it is possible to add scripting to the control in order to provide more complex control of values.
A channel or option may be selected using the box underneath the dial. Â If the selected object is a map modifier then the program button will be visible. Â Clicking on the button will perform the same action that the virtual pot box program button does by applying the adjustment to the current map site and resetting the channel to zero.
The label, object selector and program button visibility may be overridden by setting the appropriate Properties Window. Additionally the text of the label may be set via the 'Label' property. Â If the property is left blank then it will be set to the name of the selected object unless a script is specified.
If a script is specified for the control then the object selector will be disabled since the script is mutually exclusive. Â To disable the script, see the 'Enable Script' property.
If the script defines a function called 'onProgramButton' then the program button will be visible and call that script function when clicked.
Scripts may define the following functions:
onGetMin(): Allows the minimum value for the pot control to be specified.onGetMax(): Allows the maximum value for the pot control to be specified.onGetValue(): Should return the current value of the pot control.onSetValue(value): Will be called when the value of the pot control has been adjusted by the user or implicitly.onProgramButton(): Will be called if the program button is clicked by the user.
View Properties
Properties editable via the properties editor.
| Property | Script ID | Description |
|---|---|---|
| Title | title |
The title of the window. |
| Script ID | id |
The scripting ID of the window. Can be used as an alternative to the title for searching for windows from scripts. |
| Tool Tip | tooltip |
Window tool tip. |
| Show Label | show_label |
Show/hide the label |
| Show Value | show_value |
Show/hide the value |
| Show Selector | show_selector |
Show/hide the object selector |
| Show Program Button | show_pgm_button |
Show/hide the program button for modifier channels. |
| Label | user_label |
Overrides the default label |
| Value | value |
Sets the value. |
| Use Extended Limits | use_extended_limits |
Allow values to be set for extended limits. |
| Show Extended Limits | show_extended_limits |
Display extended limit range(s). |
| Use Custom Limits | use_custom_limits |
Use custom minimum / maximum for this control only. |
| Minimum | custom_minimum |
Custom minimum for this control only. |
| Maximum | custom_maximum |
Custom maximum for this control only. |
| Script | script |
Edit the button script. |
| Enable Script | enable_script |
Enable the script (prevents script overriding direct object connection). |
| Object | object |
Enable the script (prevents script overriding direct object connection). |