[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

DELETE STRUCTURE NETWORK (PHOP,*,*,*)

Purpose

Use Delete Structure Network to delete the specified structure and to delete structures referenced, either directly or indirectly, by the specified structure, depending on the value of the reference handling flag:

  • If the flag is set to KEEP, then this subroutine does not delete the structures in the network that are referenced by structures outside the structure network. However, this subroutine deletes all other structures in the network hierarchy as if the application called the Delete Structure subroutine for each of them.

  • If the flag is set to DELETE, then this subroutine deletes all the structures in the network as if the application called the Delete Structure subroutine for each of the structures regardless of whether they were referenced by a structure outside the network hierarchy or not.

    The graPHIGS API also deletes all execute structure-type elements referencing any of the deleted structures.

    Language Bindings

    • C

    pdel_struct_net (struct_id, ref_flag)

    Input Parameters

    Pint struct_id
    Structure identifier.

    Pref_flag ref_flag
    Reference handling flag (0=PFLAG_DEL, 1=PFLAG_KEEP).

    FORTRAN

    PDSN (strid, refhnf).

    Input Parameters

    integer strid
    Structure identifier.

    integer refhnf
    Reference handling flag (0=PDELE, 1=PKEEP).

    Errors

    2
    Function Requires State (PHOP,*,*,*)

    Related Subroutines

  • Delete Structure

    • [ Previous | Next | Contents | Glossary | Home | Search ]