Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.12.7  graf_multirubber                                           TOS

 Name:         »Graphics rubberbox« - Draw two 'rubber band' outline 
               rectangles on the screen.

 Opcode:       69

 Syntax:       int16_t graf_multirubber(int16_t x, int16_t y, int16_t 
               minw, int16_t minh, GRECT *rec, int16_t *outw, int16_t 
               *outh)

 Description:  The call graf_multirubber displays a pair of 'rubber 
               bands' in the form of rectangles on the screen, whose 
               top left corner remains fixed and bottom right corner 
               can be moved while the left mouse button is held down. 
               Similar to graf_rubberbox, but with two rectangles. The 
               following apply:

                Parameter       Meaning

                x               X-coordinate, and
                y               Y-coordinate of initial corner
                minw            Minimum width of rubber band box
                min             Minimum height of rubber band box
                rec
                gr_rlastwidth   Width of rubber band box when 
                                releasing the mouse button
                gr_rlastheight  Height of rubber band box when 
                                releasing the mouse button

               Note: For the reasons mentioned above, the function 
               should only be called with an already pressed mouse 
               button, since it returns when the button is released. 
               It's interesting that the minimum width and height 
               parameters may also take negative values; the rubber 
               band may then be stretched from bottom right to top 
               left.

 Return value: An error has arisen only if the value 0 is returned.

 Availability: The function is only available under N.AES.

 Group:        Graphics library

 See Also:     Binding