Name

PADS − Adds the group names to the current name set. 

Operating States: PHOP, ∗, STOP, ∗
PHIGS standard function
Creates a structure element

Syntax

PADS (N, NAMSET)

Argument    Data Type       Access    Description
---------------------------------------------------------------------------
N           Integer         Read      Number of names in the name set.
                                      The maximum number of names allowed
                                      in the name set is 1024.
NAMSET(N)   Array of                  Name set.
            Integers
---------------------------------------------------------------------------

Description

PADS creates an add names to set element that adds the group names to the current name set.  One or more group names can be specified, up to 1024 in each program. 

Depending on the current edit mode, this function either inserts the new structure element directly after the element indicated by the pointer or replaces the element indicated by the pointer. The pointer then points to the new add names to set element. 

During structure traversal, the add names to set element adds the specified names to the existing current name set entry in the PHIGS traversal state list.  (The entry is associated with subsequent primitives.) 

  If Digital PHIGS is in immediate mode, it performs this function immediately, but the function does not create a structure element. 

A name set is an attribute that can be associated with all output primitives.  You use a name set to manipulate groups of primitives for additional control of the display.  Name sets work in conjunction with inclusion and exclusion sets to define primitives that will have the properties of invisibility, highlighting, or detectability (ability to be picked). 

Each workstation maintains a name inclusion set and a name exclusion set in its workstation state list for each of the three properties:

•Invisibility inclusion set

•Invisibility exclusion set

•Highlighting inclusion set

•Highlighting exclusion set

•Pick (detectability) inclusion set

•Pick (detectability) exclusion set

Invisibility and highlighting are output features; the contents of the inclusion and exclusion sets are specified in the PSIVFT and PSHLFT attribute functions.  The contents of the pick inclusion and exclusion sets are pick input features; see the PSPKFT function for more information. 

See Also

PISS
PISS3
PQHLFT
PQIVFT
PQPHF
PRES
PSHLFT
PSIVFT
PSPKFT