NAME

DoNameSet − Create a name set modifying object

SYNOPSIS

C:

DtObject DoNameSet(n, members, setop)
DtInt n;
DtInt members[];
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 name set attributes.  Name set attributes, in conjunction with filter attributes, provide a high-level control over invisibility and pickability.  See DoFilter for details. 

The parameter members is a list of members of the specified name set 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 name set. 

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

DcSetInvert <DCSINV>
Causes all members of the name set 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 name set, they will be added; if they are included, they will be removed. 

DcSetReplace <DCSREP>
Replaces the current value of the specified name set 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 name set is empty. 

SEE ALSO

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

September 02, 1992