NAME

DoNameSet − Create a nameset modifying object

SYNOPSIS

C:

DtObject DoNameSet(n, members, setop)
DtIntn;
DtIntmembers[];
DtSetOperation setop;

Fortran:

INTEGER∗4 DONS(N, MEMBER, SETOP)
INTEGER∗4 N
INTEGER∗4 MEMBER(N)
INTEGER∗4 SETOP

DESCRIPTION

DoNameSet creates an organizational object for modifying nameset attributes.  Nameset attributes, in conjunction with filter attributes, provide a high-level control over the invisibility and pickability.  See DoFilter for details. 

The parameter members is a list of members of the specified nameset to be affected.  n is the number of elements in the list.  The argument setop specifies how the status of the members referred to in members is to be affected. The valid choices for setop are:

DcSetAdd <DCSADD>
Adds the members listed in members to the current nameset. 

DcSetDelete <DCSDEL>
Removes the members listed in members from the current nameset. 

DcSetInvert <DCSINV>
Causes all members of the nameset listed in members to take on the opposite of their current values.  In other words, if the given set members are not in the current nameset, they will be added; if they are included, they will be removed. 

DcSetReplace <DCSREP>
Replaces the current value of the specified nameset with one that includes only the members listed in members. 

ERRORS

DoNameSet will fail if an invalid setop value is specified. 

[FATAL - invalid set operation]

DEFAULTS

The default nameset is empty. 

SEE ALSO

DoFilter(3D), DoInvisSwitch(3D), DoPickSwitch(3D)

September 29, 2021