Previous Next Up Title Contents Index Functions Index Top Library

INCREMENTAL SPATIAL SEARCH 3

PISS3


CALL SEQUENCE

CALL PISS3	(SRPX, SRPY, SRPZ, SDIST, SPTHSZ, SPATH, SRCHCI, NFLN, NFLISX, NFLIS, NFLESX, NFLES, IFLN, IFLISX, IFLIS, IFLESX, IFLES, IPTHSZ, ERRIND, FPTHSZ, FPATH).

INPUT PARAMETERS

REAL SRPX, SPRY, SPRZ
Search reference point (WC).
REAL SDIST
Search distance.
INTEGER SPTHSZ
Number of elements in start path.
INTEGER SPATH(2,SPTHSZ)
Start path.
INTEGER SRCHCI
Search threshold index.
INTEGER NFLN
Number of normal filters.
INTEGER NFLISX(NFLN
Index list of normal filter inclusion set end.
INTEGER NFLIS(*)
Normal filter inclusion set.
INTEGER NFLESX
Index list of normal filter exclusion set end.
INTEGER NFLES(*)
Normal filter exclusion set.
INTEGER IFLN
Number of inverted filters.
INTEGER IFLISX(IFLN)
Index list of inverted filter inclusion set end.
INTEGER IFLIS(*)
Inverted filter inclusion set.
INTEGER IFLESX(IFLN)
Index list of inverted filter exclusion set end.
INTEGER IFLES(*)
Inverted filter exclusion set.
INTEGER IPTHSZ
Found path list size.

OUTPUT PARAMETERS

INTEGER ERRIND
Error indicator.
FPTHSZ
Found path size.
FPATH(2,IPTHSZ)
Found path.

PHIGS STATE

(PHOP, *, *, *).

EFFECT

Carries out an incremental spatial element search in a structure network according to the inclusion and exclusion lists and geometrical criteria.

The search starts at the element following the position specified by the start path. The search is traversal. As with all traversals, the initial PHIGS traversal state list values are defined in the PHIGS description table . The search is successful if a graphic structure element is found which verifies the search filters and of which part of the graphic description is found near the reference point. If the modelling clipping indicator is PCLIP, modelling clipping is not carried out during the incremental search. If it is set to PNOCLIP, modelling clipping is carried out. If the search distance is less than or equal to 0, the graphic elements must intersect the reference point. The full access path to the element is returned as 0.

The search threshold index indicates a structure in the start path. The traversal starts when the end of this structure is reached. A zero path is returned when the traversal ends by reaching the search threshold. If the threshold index is 1, the structure at the head of the start path is the threshold and therefore the search is carried out without a threshold.

The search is incremental due to the fact that having found a first element by its path, the incremental search continues from this path.

The filters operate on primitive eligibility by comparison with the current name set of the PHIGS traversal state list in the same way as for invisibility, highlighting and picking. These filters are organized in two lists: normal list and inverted list. A structure element can be searched for if it is accepted by all the normal list filters and rejected by all the inverted list filters. If the normal list is empty, all the elements are considered as having satisfied the acceptance criterion. If the inverted list is empty, all the structure elements are considered as having satisfied the rejection criterion.

ERRORS

2
Ignoring function, function requires state (PHOP, *,*,*)
203
Ignoring function, specified starting path not found in CSS
204
Ignoring function, specified search ceiling index out of range

SEE ALSO

open structure, incremental spatial search, element search, inquire element content, inquire element types and size.


Previous Next Up Title Contents Index Functions Index Top Library