endpick(3G) — Silicon Graphics

NAME

endpick − turns off picking mode

SPECIFICATION

C
long endpick(buffer)
short buffer[];

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

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

DESCRIPTION

endpick turns off picking mode. When a drawing routine draws in the picking region, the contents of the name stack are stored in buffer, along with the number of names in the stack. For example, 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 endpick 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 calls to pick and endpick because the graphics are frozen and the results cannot appear on the screen.

Version 3.6 — December 20, 1987