Arguments

track  (optional) if not NIL, allows to return 2d/3d point coordinate list

mode  (optional) integer, combination of bit flags; specifies the possible operations

cursor  (optional) integer: 0 = normal crosshair cursor, 1 = no cursor,  2 = selection box cursor (default 0)

for  mode:the following bit values can be combined :
bit 0 = 1 : allow dragging coordinates
bit 1 = 2 : allow all keyboard keys, including function keys, cursor keys, etc.
bit 2 = 4 : allow cursor specification from cursor argument
bit 3 = 8 : no "cancelled" or "error" message is user finishes by ESCAPE key

Return

list (type  integer|point)   first element is the input type, second element is an integer or a point;
for 'type' :
2 keyboard; integer is key code
3 pick point; point is 3d point list
4 popup or pulldown menu by mouse selection; integer is menu item identifier
5 dragging point (if enabled by mode); point is 3d point list
6 menu item from BUTTONS menu;  integer is button ident
7 TABLET1 menu item; integer is menu item identifier
8 TABLET2 menu item; integer is menu item identifier
9 TABLET3 menu item; integer is menu item identifier
10 TABLET4 menu item; integer is menu item identifier
11 AUX menu item; integer is menu item identifier
12 position point after type = 6 or type = 11 input; point is 3d point list

Example

(grread  T  (+ 1 2 8) 0)

Remarks

see (grarc) and (grfill) functions (specific for BricsCAD)