Name

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

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

Syntax

void padd_names_set (
  const Pint_list   ∗set   /∗ (I) Name set.  The maximum number of names
                                  allowed in the name set is 1024. ∗/
)

Data Structures

typedef struct {
    Pint      num_ints;  /∗ number of Pints in the list ∗/
    Pint     ∗ints;      /∗ list of integers ∗/
} Pint_list;

Description

padd_names_set 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 pset_invis_filter and pset_highl_filter attribute functions.  The contents of the pick inclusion and exclusion sets are pick input features; see the pset_pick_filter function for more information. 

See Also

pincr_spa_search
pincr_spa_search3
pinq_highl_filter
pinq_invis_filter
pinq_phigs_facs
premove_names_set
pset_highl_filter
pset_invis_filter
pset_pick_filter