2 Visual Components Manuals

Introduction to Visual Components 2.3
{
if (!ready)
{
VC_HANDLE = VA_Setup(1 "vga"); ,
if (VC_HANDLE)
ready = 1;
}
if (ready)
{
if (!VA_Saccess(1,VC_HANDLE))
{
1, VC_HANDLE, VA_QuitAlarms(
Groupnumber);
VA_Srelease (1,VC_HANDLE);
}
}
}
3.3.8.20 Graphics and Text Output − VA_Rect
A rectangle is drawn with the VA_Rect command.
3.3.8.20.1 Parameter
I/O Parameter Type Meaning
IN enable BOOL This function is only executed if enable is TRUE.
IN VCHandle UDINT The handle returned by VA_Setup
IN x1/y1 UINT Coordinates of the upper left corner of the rectangle
IN width/height UINT Width and height of the rectangle
IN fill UINT Filling color of the rectangle
IN color UINT Border color of the rectangle
OUT Return Value UINT Not equal to 0 if error occurs
VGA:
If fill == 255, then an empty rectangle is drawn. Otherwise, it is filled with the color in fill.
PP41:
If fill == 0, then an empty rectangle is drawn. Otherwise, it is filled with the color in fill.
On the PP41, a rectangle can be deleted by setting color and fill to 0.
3.3.8.20.2
Example for Automation Basic
(* cyclic program *)
x1 = 100
y1 = 150
x2 = 250
y2 = 150
fill = 255 ; Transparent
color = 0 ; Black
if ready 1 then
VC_HANDLE = VA_Setup(1 "vga") ,
VC_HANDLE if 0 then
ready = 1
endif
endif
if ready = 1 then
VA_Saccess(1,VC_HANDLE)= if
0 then
VA_Rect (1,VC_HANDLE,x1,y1,x2,y2,fill,color)
VA_Srelease(1,VC_HANDLE)
endif
endif
3.3.8.20 Graphics and Text Output − VA_Rect 155