Previous Next Up Title Contents Index Functions Index Top Library

DELETE STRUCTURE

PDEL_STRUCT


CALL SEQUENCE

void pdel_struct(
)

PHIGS STATE

(PHOP, *, *, *).

EFFECT

DELETE STRUCTURE deletes the structure struct_id from the centralized structure store (CSS).

When struct_id designates a closed structure:

The structure struct_id in the CSS is destroyed; its identifier, its elements and all the references to struct_id in the other structures are destroyed. If the structure is posted on a workstation, it is unposted.

If the open structure contains a reference to struct_id, the element is then destroyed and all the following elements are renumbered. If the element destroyed was indicated by element pointer, element pointer then points to the previous element.

When struct_id designates the open structure:

In this case, the open structure is replaced by a non-referenced empty structure. The effect is similar to calling the functions: CLOSE STRUCTURE, DELETE STRUCTURE and OPEN STRUCTURE.

EXTENSION TO THE PHIGS STANDARD

The effect of this function can differ from the standard if used in combination with GPHIGS extended view extensions. The structure is not unposted with the standard UNPOST STRUCTURE function, it is unposted by calling UNPOST STRUCTURE FROM ALL VIEWS.

ERRORS

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

SEE ALSO

open structure, empty structure, delete element, delete element range, delete element between labels, delete structure network, delete all structures, unpost structure, unpost structure from all views (ext), inquire structure identifiers, inquire structure status


Previous Next Up Title Contents Index Functions Index Top Library