graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPHLF - Set Highlighting Filter

GPHLF (wsid, inclen, incl, exclen, excl)

Purpose

Use GPHLF to set the inclusion and exclusion highlighting filters for the specified workstation. The new filters take effect when the workstation is updated.

The filters consist of class names which indicate which classes are to be included or excluded from highlighting. The same class names may exist in both the inclusion and exclusion filter. If a class name is in both filters when the workstation is updated, the class will be excluded. For more information on classes and class names see The graPHIGS Programming Interface: Understanding Concepts

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

inclen -- specified by user, fullword integer

Inclusion filter list length (>=0)

incl -- specified by user, array of fullword integers

List of class names to be included in the highlighting filter (0<=class name<=workstation maximum.)

exclen -- specified by user, fullword integer

Exclusion filter list length (>=0)

excl -- specified by user, array of fullword integers

List of class names to be excluded from the highlighting filter (0<=class name<=workstation maximum.)

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
321: FILTER VALUE IS INVALID
531: FILTER LIST LENGTH < ZERO

Related Subroutines

GPADCN: Add Class Name to Set
GPQHLF: Inquire Highlighting Filter
GPQNCN: Inquire Number of Available Class Names
GPRCN: Remove Class Name from Set

RCP code

201335042 (X'0C002102')