graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPIPKC - Set Initial Pick Correlation State

GPIPKC (wsid, device, state)

Purpose

Use GPIPKC to change the initial pick correlation state of the pick device.

Similar to other input device initialization subroutines, GPIPKC can only be called when the device is in Request mode, and takes effect the next time the device becomes active.

This subroutine is assigned escape identifier 1004.

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.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

device -- specified by user, fullword integer

Device number (>=1)

state -- specified by user, fullword integer

Initial pick correlation state (1=OFF, 2=ON )

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
166: INITIAL PICK CORRELATION STATE IS INVALID

Related Subroutines

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

RCP code

201337349 (X'0C002A05')