Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Fileform_dial()
graf_shrinkbox()
Graphics Library
graf_growbox()                                                          AES

Syntax

WORD graf_growbox( x1, y1, w1, h1, x2, y2, w2, h2 )
WORD x1, y1, w2, h2, x2, y2, w2, h2;

Function       graf_growbox() is used to provide a visual 'clue' to a user
               by animating an outline of a box from one set of
               coordinates to another.  It is the complement function to
               graf_shrinkbox().

Opcode         73 (0x49)

Availability   All AES versions.

Parameters     x1, y1, w1, and h1 are the screen coordinates of the
               starting rectangle (where the outline will grow from).
               x2, y2, w2, and h2 are the screen coordinates of the
               ending rectangle (where the outline will grow to).

Binding        intin[0] = x1;
               intin[1] = y1;
               intin[2] = w1;
               intin[3] = h1;
               intin[4] = x2;
               intin[5] = y2;
               intin[6] = w2;
               intin[7] = h2;

               return crys_if(0x49);

Return Value   graf_growbox() returns 0 if an error occured or non-zero
               otherwise.

Caveats        There is currently no defined method of handling an error
               generated by this function.

Comments       This function is what is called by GEM's
               form_dial(FMD_GROW,...

See Also       form_dial(), graf_shrinkbox()

Group          Graphics Library