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_slidebox()
Graphics Library
graf_dragbox()                                                          AES

Syntax

WORD graf_dragbox( w, h, sx, sy, bx, by, bw, bh, endx, endy )
WORD w, h, sx, sy, bx, by, bw, bh;
WORD *endx, *endy;

Function       graf_dragbox() allows the user to move a box frame within
               the constraints of a bounding rectangle. This call is most
               often used to give the user a visual 'clue' when an object
               is being moved on screen.

Opcode         71 (0x47)

Availability   All AES versions.

Parameters     w and h specify the initial width and height of the box to
               draw. sx and sy specify the starting x and y screen
               coordinates.
               bx, by, bw, and bh, give the coordinates of the bounding
               rectangle.
               endx and endy are WORD pointers which, on function exit,
               will be filled in with the ending x and y position of the
               box.

Binding        intin[0] = w;
               intin[1] = h;
               intin[2] = sx;
               intin[3] = sy;
               intin[4] = bx;
               intin[5] = by;
               intin[6] = bw;
               intin[7] = bh;

               crys_if(0x47);

               *endx = intout[1];
               *endy = intout[2];

               return intout[0];

Return Value   graf_dragbox() returns a 0 if an error occurred during
               execution or greater than zero otherwise.

Comments       This call should be made only when the mouse button is
               depressed. The call returns when the mouse button is
               released.

See Also       graf_slidebox()

Group          Graphics Library