PSHLFT(3g) — Subroutines
Name
PSHLFT − Defines inclusion and exclusion sets of names used to determine whether primitives are highlighted.
Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function
Syntax
PSHLFT (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
PSHLFT specifies name set values for the highlighting inclusion set and highlighting exclusion set. These sets are in the workstation state list on the workstation specified by the workstation identifier.
During structure traversal, the workstation compares the specified highlighting inclusion and exclusion set values against the values in the current name set entry in the PHIGS traversal state list.
The workstation determines if Digital PHIGS highlights subsequent primitives, based on the results of the comparison.
Digital PHIGS highlights primitives on the workstation in the following circumstances:
•When at least one member of the primitive’s name set in the PHIGS traversal state list is present in the highlighting inclusion list (that is, the intersection of the name set and the inclusion set is not empty)
•When no member of the primitive’s name set in the PHIGS traversal state list is present in the highlighting 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 not highlighted.
See Also
PADS
PQHLFT
PRES
DSHI
DSHR