A Bitmap Image displays picture consisting of a matrix of dots on a Graphic Page.
To add Bitmap Image to a graphic page do one of the following:
Bitmap Image Properties define how the picture appears on the graphic page.
When a Bitmap Image is selected, the Image Properties are shown in the Properties Window. To make changes, enter new values for the appropriate property.
A Bitmap Image supports these properties:
Identification | ||
---|---|---|
Label | An optional label to attach to the item. | |
Properties | ||
Comment | A place to store notes and information about the item. The comment property has no effect on how the item is displayed or behaves. | |
Tooltip |
The text to display in a tooltip.
To enter multiple lines of text, Click the Browse button ![]() | |
Visible | The initial visibility in run mode. To dynamically display or hide the item use one of these: | |
Blink Attributes | ||
Blink | Whether the Bitmap Image blinks. A data binding configured in DataBindBlink will override this property. | |
BlinkSpeed |
Defines how fast the Bitmap Image blinks when blinking is enabled. The options are:
Slow, Medium or Fast.
Blinking is enabled using any of these options:
| |
Fit & Alignment | ||
PreserveAspectRatio | When False the image is stretched to fit the space exactly. When True the image is padded or cropped to maintain its aspect ratio. | |
HorizontalAlignment |
Defines how the image should be aligned horizontally when PreserveAspectRatio is
True:
| |
VerticalAlignment |
Defines how the image should be aligned vertically when PreserveAspectRatio is
True:
| |
ImageFitMode |
Defines how the image should should fill the available space when PreserveAspectRatio is
True:
| |
General Data Bindings | ||
DataBindBlink |
A Data Binding that causes the item to blink.
If DataBindBlink evaluates to TRUE, the item will blink. Click the Browse button ![]() | |
DataBindDisableActions |
A Data Binding to disable all actions on the item. If DataBindDisableActions evaluates to TRUE, actions on the item are disabled. Click the Browse button ![]() | |
DataBindTooltip |
A Data Binding which sets the tooltip to display if a user hovers the cursor over the item.
Note: Tooltips are not currently supported in the Android Operator Interface. Click the Browse button ![]() | |
DataBindVisible |
A Data Binding which hides the item. If DataBindVisible is defined, and evaluates to FALSE, the item is hidden. Click the Browse button ![]() | |
Size Position Data Bindings | ||
ClipRegionHorizontal | When the DataBindClipHorizontal data binding is defined, this value sets whether the left or right side of the item is clipped. | |
ClipRegionVertical | When the DataBindClipVertical data binding is defined, this value sets whether the top or bottom of the item is clipped. | |
DataBindClipHorizontal |
A Data Binding which sets how much of the item to clip horizontally.
A value less than or equal to zero clips the entire item.
A value greater than or equal to one does not clip the item.
Values between zero and one clip the corresponding portion of the item. Click the Browse button ![]() | |
DataBindClipVertical |
A Data Binding which sets how much of the item to clip vertically.
A value less than or equal to zero clips the entire item.
A value greater than or equal to one does not clip the item.
Values between zero and one clip the corresponding portion of the item. Click the Browse button ![]() | |
DataBindOffsetX |
A Data Binding which moves the image in the horizontal direction.
The offset is in canvas units. Click the Browse button ![]() | |
DataBindOffsetY |
A Data Binding which moves the image in the vertical direction.
The offset is in canvas units. Click the Browse button ![]() | |
DataBindRotation |
A Data Binding which rotates the image from its original position by the number of degrees. Click the Browse button ![]() | |
DataBindRotationSpeed |
A Data Binding which causes the image to rotate by the number of degrees per second. Click the Browse button ![]() | |
DataBindScaleX |
A Data Binding which resizes the image in the horizontal direction.
A value less than 1.0 shrinks the item horizontally.
A value greater than 1.0 expands the item horizontally. Click the Browse button ![]() | |
DataBindScaleY |
A Data Binding which resizes the image in the vertical direction.
A value less than 1.0 shrinks the item vertically.
A value greater than 1.0 expands the item vertically. Click the Browse button ![]() | |
Actions | ||
ActionButtonDown |
An Operator Action script to run when the operator presses the left mouse button down, or touches the display. Click the Browse button ![]() | |
ActionButtonShortcut |
A keyboard shortcut to emulate a button press on the item.
Click the Browse button ![]() | |
ActionButtonUp |
An Operator Action script to run when the operator releases the left mouse button, or removes touch from the display. Click the Browse button ![]() | |
ActionButtonWhileDown |
An Operator Action script to run at intervals while the operator holds the left mouse button down, or continuously touches the display. Click the Browse button ![]() | |
ActionDoubleClick |
An Operator Action script to run when the operator double-clicks the left mouse button, or double taps the display. Click the Browse button ![]() | |
ActionContextMenu |
An Operator Action script to run when the operator clicks the right mouse button, or does a long press on the display. Click the Browse button ![]() | |
WhileDownInterval | The interval between each execution of the ActionButtonWhileDown script. |
A Bitmap Image may not fit the allocated space on the graphic page. The Fit & Alignment properties define how the Bitmap Image should be displayed when this happens.
When PreserveAspectRatio is False, the Bitmap Image is stretched to fit the available space:
When PreserveAspectRatio is True, the aspect ratio of the Bitmap Image is preserved. The HorizontalAlignment, VerticalAlignment and ImageFitMode define how the Bitmap Image is displayed. For example when there is more space available horizontally:
When there is more space available vertically:
For a complete description of all data binding options.
For the different tools available to edit graphic pages.
For information about editing graphic pages in Fernhill SCADA.
For the meaning of terms used in Fernhill SCADA.