Name

PISS − Searches the structure, beginning at the specified element. 

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

Syntax

PISS (SRPX, SRPY, SDIST, SPTHSZ, SPATH, MCLIPF, SRCHCI, NFLN, NFLISX,
NFLIS, NFLESX, NFLES, IFLN, IFLISX, IFLIS, IFLESX, IFLES, IPTHSZ, ERRIND,
FPTHSZ, FPATH)

Argument     Data Type     Access    Description
---------------------------------------------------------------------------
SRPX, SRPY   Real          Read      Search reference point, in world
                                     coordinates
SDIST        Real          Read      Search distance
SPTHSZ       Integer       Read      Number of elements in the starting path
SPATH(2,     Integer       Read      Starting path
SPTHSZ)
MCLIPF       Integer       Read      Modeling clipping flag
SRCHCI       Integer       Read      Search ceiling index
NFLN         Integer       Read      Number of normal filters
NFLISX       Array of      Read      Array of end indexes of normal filter
(NFLN)       integers                inclusion sets
NFLIS(∗)     Array of      Read      Normal filter inclusion sets
             integers
NFLESX(NFLN  Array of      Read      Array of end indexes of normal
             integers                filter exclusion sets
NFLES(∗)     Array of      Read      Normal filter exclusion sets
             integers
IFLN         Integer       Read      Number of inverted filters
IFLISX(IFLN) Array of      Read      Array of end indexes of inverted
             integers                filter inclusion sets
IFLIS(∗)     Array of      Read      Inverted filter inclusion sets
             integers
IFLESX(IFLN) Array of      Read      Array of end indexes of
             integers                inverted filter exclusion sets
IFLES(∗)     Array of      Read      Inverted filter exclusion sets
             integers
IPTHSZ       Integer       Read      Size of the found path array
ERRIND       Integer       Write     Error indicator
FPTHSZ       Integer       Write     Found path size
FPATH(2,     Integer       Write     Found path
IPTHSZ)
---------------------------------------------------------------------------

Constants

Defined Argument     Constant     Description
---------------------------------------------------------------------------
MCLIPF               PNCLIP       Clipping disabled
                     PCLIP        Clipping enabled
---------------------------------------------------------------------------

Description

PISS searches the structure beginning at the element following the position specified by the starting path.  The search succeeds if the function finds an output structure element that satisfies the search filter and part of the output structure element lies within the world coordinate distance of the search reference point (expanded to three dimensions).  Digital PHIGS assumes the z-component is 0. 

If the clipping indicator is PNCLIP, Digital PHIGS does not perform any clipping.  If the clipping indicator is PCLIP, Digital PHIGS performs modeling clipping during the incremental spatial search.  If the search distance is less than or equal to 0, the output structure element intersects the reference point.  The function returns the complete path to the element as the found path. 

The search ceiling index defines a structure in the starting path.  Traversal ends when the function reaches the end of the structure.  If traversal stops because of the search ceiling, the function returns a null path.  If the ceiling index is 1, the topmost structure of the search path is the ceiling, and the search operates without a ceiling. 

Digital PHIGS Version 3.1 does not support this function.

See Also

PADS
PISS3
PRES