endselect(3G) — Silicon Graphics

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 turns off selecting mode. The buffer stores any hits drawing routines generate between gselect and endselect. 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 contains 5, 9, 17 when a hit occurs, 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 is not large enough to hold all the hits that occurred.

NOTE

This routine is available only in immediate mode.

BUGS

When using a debugger, do not stop the graphics between gselect and endselect because the graphics are frozen and the results cannot appear on the screen.

Version 3.6 — December 20, 1987