PSIVFT(3g) — Subroutines
Name
PSIVFT − Defines inclusion and exclusion sets of names used to determine whether primitives are invisible.
Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function
Syntax
PSIVFT (WKID, ISN, IS, ESN, ES)
Argument Data Type Access Description
---------------------------------------------------------------------------
WKID Integer Read Workstation identifier.
ISN Integer Read Number of names in the inclusion
set. The maximum number of names
is 1024 (in the range 0 to 1023).
IS(ISN) Array of Read Inclusion set.
integers
ESN Integer Read Number of names in the exclusion
set.
ES(ESN) Array of Read Exclusion set.
integers
---------------------------------------------------------------------------
Description
PSIVFT specifies the name set values for the invisibility inclusion set and invisibility exclusion set. These sets are in the workstation state list of the workstation specified by the workstation identifier.
During structure traversal, the workstation compares the specified invisibility inclusion and exclusion set values against the values in the current name set entry in the PHIGS traversal state list to determine whether primitives are invisible.
Primitives will be invisible on the workstation under the following circumstances:
•At least one member of the primitive’s name set in the PHIGS traversal state list is present in the invisibility inclusion list (that is, the intersection of the name set and the inclusion set is not empty).
•No member of the primitive’s name set in the PHIGS traversal state list is present in the invisibility exclusion set (that is, the intersection of the name set and the exclusion set is empty).
A member of the inclusion set cannot also be a member of the exclusion set.
By default, all output is visible.
See Also
PADS
PQIVFT
PRES