graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPIVF - Set Invisibility Filter

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

Purpose

Use GPIVF to set the inclusion and exclusion invisibility filters for the specified workstation.

The new filters take effect when the application updates the workstation. The filters consist of class names which indicate which classes the graPHIGS API includes or excludes from invisibility. The same classes may exist in both the inclusion and exclusion filter. If a class is in both filters when the application updates the workstation, then the graPHIGS API excludes the class. 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 invisibility 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 invisibility 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
GPQIVF: Inquire Invisibility Filter
GPQNCN: Inquire Number of Available Class Names
GPRCN: Remove Class Name from Set

RCP code

201335043 (X'0C002103')