endpick(3G)

NAME
     endpick - turns off picking mode

C SPECIFICATION
     long endpick(buffer)
     short buffer[];

PARAMETERS
     buffer   expects a buffer into which to append the contents of the name
              stack when a drawing routine draws in the picking region. Before
              writing the contents of the name stack, the system appends the
              number of entries it is about to append.  Thus, if the name
              stack contains the values, 5, 9, and 17; then endpick appends
              the values, 3, 5, 9,  and 17, to buffer.

              Because more than one drawing routine may have written in the
              picking region, it is possible for buffer to contain a number of
              readings from the name stack.

FUNCTION RETURN VALUE
     The returned value for the function is the number of times endpick wrote
     the names stack to buffer.

     If the returned function value is negative, then the buffer was too small
     to contain all the readings from the name stack.

DESCRIPTION
     endpick turns off picking mode and writes the hits to a buffer.

SEE ALSO
     initnames, loadname, pick pushname, popname

NOTE
     This routine is available only in immediate mode.