Active element that displays an image that can be dragged with the mouse to control three parameters at the same time: one for the horizontal movements (x), one for the vertical movements (y), and one for a virtual 3rd dimension, controlled by the mouse wheel and '+' and '-' keys. The values of the parameters reflect the coordinates of the image in the widget:
This particular control supports the Attributes Common to Widgets. It also has the Attributes Common to Param Controls, but with a 'x_', 'y_' or 'z_' prefix for each dimension. Note that only one dimension is mandatory (you do not need to connect all parameters, you can use for example the x and y controls only).
Name | Value Type | Default Value | Description | Comment | V. | Exp. |
---|---|---|---|---|---|---|
Thumb images | ||||||
thumb_image |
empty |
Path to the image to display for the thumb of the slider |
|
1.4.1 |
No | |
thumb_image_mask |
'thumb_image' value with '_mask' postfix |
Path to alpha mask for previous image |
This value is optional since by default it is generated from 'thumb_image'. |
1.4.1 |
No | |
thumb_image_disabled |
|
Path to the image to display for the thumb of the slider when the control is disabled |
This value is optional since by default it is generated from 'thumb_image'. |
1.4.1 |
No | |
thumb_image_disabled_mask |
|
Path to alpha mask for previous image |
This value is optional since by default it is generated from 'thumb_image'. |
1.4.1 |
No | |
thumb_image_hover |
|
Path to the image to display for the thumb of the slider when the mouse is over the control |
This value is optional since by default it is generated from 'thumb_image'. |
1.4.1 |
No | |
thumb_image_hover_mask |
|
Path to alpha mask for previous image |
This value is optional since by default it is generated from 'thumb_image'. |
1.4.1 |
No | |
thumb_image_focus |
|
Path to the image to display for the thumb of the slider when the control has focus |
This value is optional since by default it is generated from 'thumb_image'. |
1.4.1 |
No | |
thumb_image_focus_mask |
|
Path to alpha mask for previous image |
This value is optional since by default it is generated from 'thumb_image'. |
1.4.1 |
No | |
Other settings | ||||||
h_margin |
0 |
horizontal margin of the control: used to define the horizontal range for the position of the thumb image. |
If not set, the thumb image will be cropped when the x parameter value reaches the limits of its range. |
1.4.1 |
No | |
v_margin |
0 |
vertical margin of the control: used to define the vertical range for the position of the thumb image. |
If not set, the thumb image will be cropped when the y parameter value reaches the limits of its range. |
1.4.1 |
No | |
x_enabled |
true |
enable/disable movement for the horizontal coordinate of the joystick. |
|
1.4.4 |
1.4.4 | |
y_enabled |
true |
enable/disable movement for the vertical coordinate of the joystick. |
|
1.4.4 |
1.4.4 | |
z_enabled |
true |
enable/disable edit capability for the third coordinate of the joystick (available with mouse wheel or edit box). |
|
1.4.4 |
1.4.4 | |
thumb_width |
integer |
sets the width of the clickable area for the joystick thumb (overrides the size of the image used for the thumb if any). |
|
2.7 |
No | |
thumb_height |
integer |
sets the width of the clickable area for the joystick thumb (overrides the size of the image used for the thumb if any). |
|
2.7 |
No |