graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPPKF - Set Pick Filter

GPPKF (wsid, device, inclen, incl, exclen, excl)

Purpose

Use GPPKF to set the pick inclusion and exclusion filters for the given pick device.

The filters consist of class names which indicate to the specified workstation which class names to include and which to exclude from pickability (detectability)

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

device -- specified by user, fullword integer

Pick device number (>=1)

inclen -- specified by user, fullword integer

Inclusion filter list length (>=0)

incl -- specified by user, array of fullword integers

List of class names (>=0)

exclen -- specified by user, fullword integer

Exclusion fliter list length (>=0)

excl -- specified by user, array of fullword integers

List of class names (>=0)

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
140: DEVICE NUMBER < ONE OR DEVICE NOT AVAILABLE
321: FILTER VALUE IS INVALID
531: FILTER LIST LENGTH < ZERO

Related Subroutines

GPADCN: Add Class Name to Set
GPQLI: Inquire List of Logical Input Devices
GPRCN: Remove Class Name from Set

RCP code

201335041 (X'0C002101')