pginit

Check or initialise a polygon stream.

Usage

pginit(X {, N=0, {number}E=0} )

X

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

N

The requested number of simple polygons:

N<=0	undefined, polygons are counted during initialization
N>0	exactly N simple polygons must be contained in X

E

The maximum error for polygon simplification. If E<=0 the simplification is skipped.

Result

A polygon-stream P containing all simple-polygons defined by X. The function failes if:

• no simple polygons can be found or one of the detected polygons is invalid
• N>0 and the number of polygons defined by X is not equal to N

See also

pgget, pgitest, pgiline, pgxgrid, pgsplit, pgtrans, pghull

<function list>