Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileFORM_DIAL(flag,mi_x,mi_y,mi_w,mi_h,ma_x,ma_y,ma_w,ma_h)

flag, mi_x, mi_y, mi_w, mi_h, ma_x, ma_y, ma_w, ma_h: iexp

This function serves to reserve (or release) a rectangular screen area and for
drawing expanding or shrinking rectangles.

Returns 0 if an error occured.

    flag - Function type:
           0: Reserves a display area         FMD_START
           1: Draws an expanding rectangle    FMD_GROW
           2: Draws a shrinking rectangle     FMD_SHRINK
           3: Releases reserved display area  FMD_FINISH
    mi_x - x-coordinate of top left corner at minimum size
    mi_y - y-coordinate of top left corner at minimum size
    mi_w - Width of rectangle at minimum size
    mi_h - Height of rectangle at minimum size
    ma_x - x-coordinate of top left corner at maximum size
    ma_y - y-coordinate of top left corner at maximum size
    ma_w - Width of rectangle at maximum size
    ma_h - Height of rectangle at maximum size

Example:

    ~FORM_DIAL(1,0,0,0,0,100,100,300,100)

--> Draws an expanding rectangle. The parameter group '0,0,0,0' means that the
    rectangle grows from the center of what will be the full-size rectangle.

form_dial()+