NAME

pick − puts the system in picking mode

SPECIFICATION

C
pick(buffer, numnames)
short buffer[];
long numnames;

FORTRAN
subroutine pick(buffer, numnam)
integer*2 buffer(*)
integer*4 numnam

Pascal
procedure pick(var buffer: Short; numnames:
longint);

DESCRIPTION

pick facilitates the cursor as a pointing object.  When you draw an image in picking mode, nothing is drawn.  It places a special viewing matrix on the stack, which discards everything in the image that does not intersect a small region around the lower-left corner of the cursor. 

The graphical items that intersect the picking region are hits and store the contents of the name stack in buffer.  numnames specifies the maximum number of names the system saves.  Picking does not work if you issue a new viewport while in picking mode. 

SEE ALSO

clearhitcode, endpick, endselect, gethitcode, gselect, loadname, picksize, pushname, popname, Programming Guide, Section 9.2, Picking

NOTE

This routine is available only in immediate mode. 

BUGS

When using a debugger, do not stop the graphics between calls to pick and endpick because the graphics are frozen and the results cannot appear on the screen. 

Version 3.6  —  December 20, 1987