REMOVE NAMES FROM SET

PREMOVE_NAMES_SET

CALL SEQUENCE

void premove_names_set(

const Pint_list	*names	/* name set to be removed 	*/

)

TYPES

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

PHIGS STATE

EFFECT

A REMOVE NAMES FROM SET element is inserted in the open structure after element pointer or replaces the element indicated by element pointer, depending on edit mode. Element pointer then points to the REMOVE NAMES FROM SET element. The values specified by the function parameter are associated with the element.

When the REMOVE NAMES FROM SET element is interpreted, the names set specified in names is removed from the current name set entry in the PHIGS traversal state list.

The primitives which follow in the structure network will have the current name set as an attribute.

The names set changes only affect the current structure and its sub-structures.

The current name set in the PHIGS traversal state list is compared to the eligibility filters for:

- visibility

- picking

- highlighting.

EXTENSION TO THE PHIGS STANDARD

If GPHIGS is in NRS mode, the effect of this function is different from the effect described in the standard.

In NRS mode, (see OPEN PIPE), the element is not stored in a structure. It is sent to the workstation on which the pipe is opened.

ERRORS

5

Ignoring function, function requires state (PHOP,*, STOP,*)

SEE ALSO

add name to set, set highlighting filter, set invisibility filter, set pick filter, open structure, open pipe (ext), inquire current element content, inquire current element type and size