NAME

endselect - turns off selecting mode

SPECIFICATION

C
long endselect(buffer)
short buffer[];

FORTRAN
integer*4 function endsel(buffer)
integer*2 buffer(*)

Pascal
function endselect(var buffer: Short): longint;

DESCRIPTION

endselect takes the IRIS out of selecting mode.  Any hits caused by drawing commands that occurred between the calls to select and endselect are stored in the buffer.  Every hit that occurs causes the entire contents of the name stack to be recorded in the buffer, preceded by the number of names in the stack.  Thus, if the name stack contained 5, 9, 17 when a hit occurred, the numbers 3, 5, 9, 17 are added to the buffer.  The magnitude of the value returned by endselect is the number of such name lists in the buffer.  If the value returned is positive, then all hits are recorded in the name lists, if it is negative, the buffer was not large enough to hold them all. 

SEE ALSO

select, gethitcode, clearhitcode, loadname, initnames

NOTE

This command can be used only in immediate mode. 

Version 2.4  —  May 08, 1986