Name

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

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

Syntax

PREPAN (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

PREPAN returns the maximal paths in the archive file that are referenced by the specified archived structure.  The maximal path of ancestors of a structure is a path ((A1, E1), (A2, E2), ... , (S, 0)).  A1 cannot be referenced in any execute structure element in the archive file.  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
                              to the specified structure.
1            TOP FIRST        Digital PHIGS returns all element references
                              heading a path to the specified structure.
2            BOTTOM FIRST     Digital PHIGS returns all element references
                              to the structure.
--------------------------------------------------------------------------

Digital PHIGS Version 3.1 does not support this function.

See Also

PQCST
PQCSTN
POPARF
PREPDE