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-Filegraf_dragbox()
graf_slidebox()
Graphics Library
graf_rubberbox()                                                        AES

Syntax

WORD graf_rubberbox( bx, by, minw, minh, endw, endh )
WORD bx, by, minw, minh;
WORD *endw, *endh;

Function       graf_rubberbox() allows the user to change the size of
               a box outline with a fixed starting point.

Opcode         70 (0x46)

Availability   All AES versions.

Parameters     bx and by define the fixed upper-left corner of the box to
               stretch or shrink.
               minw and minh specify the minimum width and height that
               the rectangle can be shrunk to.
               endw and endh are WORD pointers which will be filled in
               with the ending width and height of the box when the mouse
               button is released.

Binding        intin[0] = bx;
               intin[1] = by;
               intin[2] = minw;
               intin[3] = minh;

               crys_if(0x46);

               *endw = intout[1];
               *endh = intout[2];

               return intout[0];

Return Value   graf_rubberbox() returns 0 if an error occurred or non-zero
               otherwise.

Caveats        There is currently no defined method for handling an error
               generated by this call.

Comments       This function should only be entered when the user has
               depressed the mouse button as it returns when the mouse
               button is released.

See Also       graf_dragbox(), graf_slidebox()

Group          Graphics Library