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%