Name

PREPDE − Returns the maximal paths of descendants (in the archive file) that are referenced by the archived structure. 

Operating States: PHOP, ∗, ∗, AROP
PHIGS standard function

Syntax

PREPDE (AFID, STRID, PTHORD, PTHDEP, IPTHSZ, N, OL, APTHSZ, PATHS)

Argument        Data Type       Access    Description
---------------------------------------------------------------------------
AFID            Integer         Read      Archive file identifier
STRID           Integer         Read      Structure identifier
PTHORD          Integer         Read      Path order
PTHDEP          Integer         Read      Path depth
IPTHSZ          Integer         Read      Size of the path buffer
N               Integer         Read      Element in the list of paths
OL              Integer         Write     Number of paths available
APTHSZ          Integer         Write     Actual size of the Nth
                                          structure path
PATHS(2,
IPTHSZ)         Integer         Write     Nth structure path
---------------------------------------------------------------------------

Constants

Defined Argument      Constant      Description
---------------------------------------------------------------------------
PTHORD                PPOTOP        Top first.
                      PPOBOT        Bottom first.
---------------------------------------------------------------------------

Description

PREPDE returns the maximal paths in the archive file that are referenced by the specified archived structure.  The maximal path of descendants of a structure is a path ((structure, E0), (D1, E1), (D2, E2), ... , (DN, 0)).  DN cannot contain any execute structure elements.  The arguments PTHDEP and PTHORD determine the portion of the path returned by Digital PHIGS. 

The path order and path depth determine the section of each path to be returned, as follows:

Path Depth   Path Order       Description
--------------------------------------------------------------------------
0            TOP FIRST        Digital PHIGS returns all distinct paths
                              from the specified structure.
1            TOP FIRST        Digital PHIGS returns element references
                              in the specified structure as separate
                              path lists.
1            BOTTOM FIRST     Can be used to determine the bottommost
                              structures of the structure network.
--------------------------------------------------------------------------

Digital PHIGS Version 3.1 does not support this function.

See Also

PQCST
PQCSTN
POPARF
PREPAN