KUIML
Blue Cat's User Interface Programming Language
XYZ_IMAGE_PARAM_JOYSTICK

Description

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:

Inherited Attributes

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).

Specific Attributes

Name Value Type Default Value Description Comment V. Exp.
Thumb images

thumb_image

image file path

empty

Path to the image to display for the thumb of the slider


1.4.1

No

thumb_image_mask

image file path

'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

image file path


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

image file path


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

image file path


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

image file path


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

image file path


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

image file path


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

number of pixels

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

number of pixels

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

boolean

true

enable/disable movement for the horizontal coordinate of the joystick.


1.4.4

1.4.4

y_enabled

boolean

true

enable/disable movement for the vertical coordinate of the joystick.


1.4.4

1.4.4

z_enabled

boolean

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