L-VIS User Manual
107
LOYTEC
Version 6.2
LOYTEC electronics GmbH
Frame:
The actual bar which displays the current value has a one pixel wide
frame around it.
Bar:
Inside the frame is the bar which actually shows the current value. With
increasing values, the bar moves up or to the right.
Knob:
A bitmap may be used to display a moving knob or handle, which is
normally shown centered around the current value, but can also be shifted by a
constant offset in X and Y direction.
Position and size of a bar control, as defined on the common properties page, correspond to
the frame of the bar control, as described above. It does not correspond to the selection
frame drawn around the whole bar control.
NOTE:
To move a bar control in the LCD preview, you must grab it somewhere inside the bar
frame, not outside, like the scale or tick marks. Use any of the four corners or the bar’s
frame to resize the bar, similar to text and number controls.
On the
Common Properties
page, a font may be selected to be used for the scale. Also on
this page, a static bitmap may be loaded. This bitmap will be displayed at a configurable
position relative to the mid-point of the current bar end (the ‘fill height’ of the bar control),
so that the bitmap moves up and down (or left and right) to show the current value.
Color configuration is done as usual on the
Color
property page. The following colors are
supported by bar controls:
Color Name
Element to which the color applies
Labels
Numbers of the scale.
Knob Bitmap
Color used to draw a monochrome handle bitmap. Not used if the loaded
bitmap is a color bitmap (set line color 2 in this case).
Knob Backgr.
Color of the handle bitmap which should be transparent (background
color of the handle bitmap), only used in VGA projects or for color
bitmaps which use VGA colors only and do not provide any transparency
data.
Selection Frame
Frame drawn around the entire control, if the control is selected.
Frame
Tick marks and the bar frame, as described above.
Filled Bar
Bar which represents the value. This color may be overridden by color
specifications from a connected mapping table.
Container
Empty space inside the bar frame, which is currently not filled by the bar
color.
Background
Color of the background outside the bar frame. If the transparent check
box is set, all pixels using this color will be transparent.
Table 16: Color assignment for bar controls
All other properties are set on the
Bar Graph
property page:
Value Range:
The most important property on this page is the
Value Range
of the
bar. It must be adjusted to match the actual value range you want to visualize. If
the bar is used to input values, this range also defines what the user may enter.
Values outside the given value range cannot be entered, even using the key pad,
which is optionally available for input bar controls. On the other hand, if the actual
bar height exceeds the desired value range, the extra values may be entered
because the bar may be dragged all the way up to the actual bar top, no matter
what the desired value range is.
