Rice Lake 920i USB Installation Manual V5.05 - Manual (Page 113)

Serial Commands 107
10.2 Widget Programming
The type and location of elements shown on the 920i
display are easily specified using the drag and drop
features of the iRev 4 utility. However, display widgets
can also be programmed using serial commands while
t h e 9 2 0 i i s i n s e t u p m o d e , o r t h r o u g h i R i t e
programming. Up to ten different screens can be
configured.
Serial command widget programming is accomplished
in setup mode, using the WDGT serial command. The
first parameter specified is the widget type, listed in
Table 10-19. The following sections describe each of
the widget types and the parameters and values specific
to that type.
In setup mode, the WDGT.CLR serial command can be
used to clear all specified widgets from the display.
Table 10-19. Widget Types
Type Description
1 Scale Widget
2 Bitmap Widget
3 Bargraph Widget
4 Label Widget
5 Numeric Widget
6 Symbol Widget
Some widget types require that the location or size of
the widget be specified, in pixels. Figure 10-19 shows
the pixel counts (80 pixels per inch) used to specify the
pixel location on the display.
0,239
0,0 319,0
319,239
4"
320 pixels
3"
240 pixels
159,119
Figure 10-1. Screen Location Pixel Values
Setting the data_source of bargraph, label, numeric, and
symbol widgets to 2 (program) allows these widget
types to be directly controlled by an iRite program
rather than by indicator data. The user program must
provide the code necessary for widget manipulation.
10.2.1 Scale Widgets
Scale widgets are used to present basic scale data from
one or more configured scales. For multiple scale
applications, up to four scale widgets can be configured
to be shown on the display at any one time. Fewer
displayed widgets allow each widget to be larger. Scale
data from additional configured scales can be shown by
scrolling up or down through all configured scales,
including a total scale widget, if configured.
WDGT#n=1, scale_widget_size, scales_displayed,
screen_number
where:
n=widget number
1= scale widget type
scale_widget_size = 1–6 (size refers to numeral height)
1: 1/4 "
2: 1/2"
3: 3/4"
4: 7/8 "
5: 1"
6: 1 5/32 "
scales_displayed = 1–4
screen_number = 1–10
Example:
WDGT#1=1,2,1,2<CR>
creates a single 1/2" scale widget for screen number 2.
10.2.2 Bitmap Widgets
Bitmap widgets provide a representation of vertical or
horizontal tanks or a hopper. The location, size, and
border style of the widget are specified on the WDGT
command.
WDGT#n=2, left, top, width, height,border_style,
bitmap_widget_style, name/alias, visible,
screen_number
where:
n=widget number
2= bitmap widget type
left = left edge location, in pixels
top = top edge location, in pixels
width = width, in pixels
height = height, in pixels
border_style = 1 (none)
bitmap_widget_style = 1 (vertical tank), 2 (horizontal tank),
3 (hopper)
name/alias = text name or alias
visible = 1 (on) or 2 (off)
screen_number = 1–10
Example:
WDGT#2=2,30,30,120,120,1,3,Hopper1,1,2<CR>
creates a visible, 1.5" x 1.5" (120 x 120 pixel) hopper
widget for screen 2, named Hopper1, with no border,
with the upper left-hand corner of the bitmap at pixel
location 30,30 (near upper left corner of display).