**CIGAL Reference Manual, Chapter 3 (Functions): GETBOX**
===== GETBOX -- Get the upper left and lower right coordinates of a box =====
**usage: iarray = getbox(flag,nx,ny)**

GETBOX lets you use the cursor to select a rectangular region of the screen.
The function returns an integer array of 4 values: the upper-left X and Y
coordinates and the lower-right X and Y coordinates.

If the NX and NY arguments are specified (and greater than 0), GETBOX
will make a box of that size and then expects you to enter 1 screen
position, which it will use as the upper-left corner of the box.

If NX and NY are not specified, GETBOX expects 2 screen positions:
the upper-left and lower-right corners of the box.  (Screen positions
as usual are specified by moving the cursor and then pressing the left
mouse button or the <ENTER> key.)

The FLAG argument can be used to specify whether the returned values
are to be in text position units (FLAG == 1) instead of pixel units,
and whether in 3-dimensions (FLAG == 2) instead of 2 dimensions.
By default, GETBOX returns pixel units if in a graphics mode and text
units if in a non-graphics mode (see [[jvs:cigal:manual:chapter4:vmode|VMODE(4)]]).  GETBOX always returns
values in 2 dimensions when returning text position units.

**See Also:**\\
[[jvs:cigal:manual:chapter2:box|BOX(2)]], 
[[jvs:cigal:manual:chapter4:cursor|CURSOR(4)]], 
[[jvs:cigal:manual:chapter3:gettxt|GETTXT(3)]], 
[[jvs:cigal:manual:chapter4:vmode|VMODE(4)]]

[[jvs:cigal|CIGAL Home]], 
[[jvs:cigal:manual|CIGAL Manual]], 
[[jvs:cigal:manual:chapter3|Functions List]], 
[[jvs:cigal:manual:help|Manual Help]]