graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPPKSC - Set Pick Selection Criteria

GPPKSC (wsid, device, criteria)

Purpose

Use GPPKSC to set the criteria that is used to select the primitive(s) that are to be accumulated during pick correlation.

As with other input device control subroutines, GPPKSC can only be called when the specified input device is in Request mode.

If a workstation does not support hidden line/hidden surface removal, then the graPHIGS API ignores the visible aspect of the criteria. Therefore, criteria 4-6 behaves as criteria 1-3.

This subroutine is assigned escape identifier 1005.

Note:

This subroutine is an escape subroutine and therefore may not be available on all workstations. Use the Inquire List of Available Escape Subroutines (GPQES) subroutine to determine if this subroutine is supported by a specific workstation. See also the workstation description information in The graPHIGS Programming Interface: Technical Reference

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

device -- specified by user, fullword integer

Device number (>=1)

criteria -- specified by user, fullword integer

Pick selection criteria (1=FIRST, 2=LAST, 3=ALL, 4=FIRST_VISIBLE, 5=LAST_VISIBLE, 6=ALL_VISIBLE ) 1=FIRST and 2=LAST refer to the order in which views, structures and elements are traversed for output.

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
38: WORKSTATION HAS ONLY OUTPUT CAPABILITIES
140: DEVICE NUMBER < ONE OR DEVICE NOT AVAILABLE
141: INPUT DEVICE NOT IN CORRECT MODE
167: PICK SELECTION CRITERIA IS INVALID

Related Subroutines

GPPKMO: Set Pick Mode
GPQES: Inquire List of Available Escape Subroutines

RCP code

201337350 (X'0C002A06')