Description
The ImageRotator control is used to present a collection of images on the display. Each image in the collection is presented one at a time and the image swaps after a definable period. The control can be used to display a waiting animation to signal activity during card validation.
The images must be bitmaps and the black colour (RGB colour 0x000000) is rendered as black while every other colour in the bitmap will be rendered as non-black on the display. The rule is applied to meet the limitation of the monochrome STN display.
Image file type must be .png.
Properties
Name
| Type: | String of any length |
| Description: | The name of the Image control. Remember that the name must be unique within the same panel. |
Location
| Type: | String in format “X,Y” where X and Y are both unsigned integers. |
| Value: | Value range for X is 0–260 Value range for Y is 0–128. |
| Description: | The Location property specifies where the image shall be placed in relation to the parent control. |
If an image is defined in a panel, the Location property will specify where inside the panel the image will be positioned. The physical location on the display depends on where the panel is placed (panels also have a location property) and where the image is placed within the panel.
Interval
| Type: | Unsigned integer. Starting at 200. Representing [ms] |
| Description: | The period of time when to swap image to the next in the collection of images. The lowest period is limited to 200ms. |
ImagePath
| Type: | String of any length |
| Description: | Folder path to the collection of images |
Folder location: We recommend to place this folder inside the \Media folder. E.g. \Storage Card\Media\Rotator\
Example
The image rotator definition below renders the bitmaps located in in the folder “\Storage Card\Media\Rotator\”. The ImageRotator control is given the name “MyImageRotator”, but in this case the name is not important. The images in given folder are displayed one at a time with at period of 500ms.
<STN:ImageRotator Name='MyImageRotator'
Location='0,0'
Interval='500'
ImagePath='\Storage Card\Media\Rotator'/>
