Purpose
Use Remove Names from Set to insert a Remove Names from Set structure element into the open structure following the element pointer or replace the element pointed at by the element pointer with a Remove Names from Set structure element, depending on the current edit mode.
The class set traversal state consists of a list of class names. During structure traversal, this structure element removes one or more names from the list but does not completely replace the traversal state as other attributes do.
Class names let an application control the eligibility of a primitive for pickability (detectability), highlighting, and invisibility by associating the primitive with a class set. The child structures inherit the effects of adding a class name to or removing a class name from the current class set.
When the graPHIGS API encounters a primitive during structure traversal, it uses the list of class names in the class set to determine the pickability (detectability), highlighting, and invisibility aspects. If the workstation does not support a specified name, then the graPHIGS API ignores the name and the name has no effect on the primitive.
Also use class names to create inclusion and exclusion filters for the specified workstation. The graPHIGS API uses these filters in conjunction with the class set traversal state to determine whether pickability, highlighting, and visibility apply. The filters act independently of each other. During structure traversal, the graPHIGS API compares the current class set to the current filters. When root structure traversal begins, the current class set is null.
For a complete discussion of class names and filters, see The graPHIGS Programming Interface: Understanding Concepts.
Language Bindings
| premove_names_set (names) |
| PRES (n, namset) |
Errors
Related Subroutines