Programmer Guide/Command Reference/EVAL/pgitest

Check the relation (outside, inside, overlap) of a given point, line or simple polygon p to the polygon x.

---

Usage 1

pgitest(X, IX, PXscalar, PYscalar)

X

a closed point-list or a polygon-stream defining one or more polygons.

IX

The index of the polygon of X to be tested; 0 <= IX < pgget(X))

PX, PY

The point P=<PX,PY> to be tested.

Result 1

The result r is a scaler.

r=0	... point P is outside the polygon XIX
r=1	... point P is inside the polygon XIX

---

Usage 2

pgitest(X, IX, PXscalar, PYvector)

pgitest(X, IX, PXvector, PYscalar)

pgitest(X, IX, PXvector, PYvector)

PX, PY

The points P[i]=<PX[i],PY[i]> to be tested. One of these arguments must be a vector.

Result 2

The result r is a vector containing the test result for each point P[i].

r[i]=0	... point P[i] is outside the polygon XIX
r[i]=1	... point P[i] is inside the polygon XIX

---

Usage 3

pgitest(X, IX, PX1scalar, PY1scalar), PX2scalar, PY2scalar)

PX1, PY1, PX2, PY2

The points <PX1,PY1> and <PX2,PY2> defining the line P to be tested.

Result 3

The result r is a scalar.

r=0	... the line P is outside the polygon XIX
r=1	... the line P is inside the polygon XIX
r=2	... the line P intersects the polygon XIX

---

Usage 4

pgitest(X, IX, P, IP)

P

a closed point-list or a polygon-stream defining one or more polygons.

IP

The index of the polygon of P to be tested; 0 <= IP < pgget(P))

Result 4

The result r is a scalar.

r=0	... the polygon PIP is outside the polygon XIX
r=1	... the polygon PIP is included in the polygon XIX
r=2	... the polygons PIP and XIX are partly overlapping
r=3	... the polygon XIX is included in the polygon PIP

---

See also

pginit, pgget, pgiline, pgxgrid, pgsplit, pgtrans, pghull

<function list>