KUIML
Blue Cat's User Interface Programming Language
IMAGE_PARAM_METER

Description

This widget displays an image depending on the value of the parameter. Its is as an animation or 'filmstrip' for which the image is chosen depending on the value of the parameter: if the parameter value is equal to its minimum the first image is displayed. If the parameter value is equal to its maximum, the last image is displayed.

Inherited Attributes

See Attributes Common to Param Widgets.

Specific Attributes

Name Value Type Default Value Description Comment V. Exp.

image

image file path

empty

Image file containing the list of images to display.

It is a single image containing a 'film strip' with many images. It can be vertical or horizontal, see the image_orientation attribute.

1.0

No

image_mask

image file path

'image' value with '_mask' postfix

Image file containing the list of images masks for the images.

This value is optional since by default it is generated from 'image'.

1.0

No

images_count

Positive integer

0

Number of images in the image file.


1.0

</TD

No

image_orientation

orientation

vertical

Orientation of the images in the image file.

This attribute is particularly useful to reuse existing images created for other skinning systems since there is no convention on the orientation of the images

1.0

No

Examples

  • Display an analog-like meter:

<?xml version="1.0" encoding="utf-8" ?>
<SKIN language_version="1.0" background_image="bg.bmp" repeat="true">
   <IMAGE_PARAM_METER param_id="dsp.input1" image="analog_meter.bmp" images_count="127" image_orientation="horizontal" />
</SKIN>

(extract. The file contains 127 images)

analog_meter.bmp: 127 positions of the meter

(extract. The file contains 127 images)

analog_meter_mask.bmp:alpha mask for the 127 positions of the meter



(the pictures show the widget for different values of the parameter)

0%

50%

100%