Defines "Region A" polygons for use in determining whether two regions overlap.
Syntax
intl pipAddRegionAPolygon ( pipOverlapHandle over_h, intl
num_points, intl *points );
Arguments
over_h
Handle from pipInitializeOverlapCheck. Input.
num_points
Number of points in the polygon. Input.
*points
Points describing the polygon (can be user-defined or long/lat). Input.
Return Values
PIP_OK
PIP_ERROR
Prerequisites
pipInitializeOverlapCheck
Alternates
None.
Notes
You must also call pipAddRegionBPolygon.
This function defines the first region used by pipCheckForRegionOverlap when comparing two regions.
You can compare multiple RegionA polygons to a single second region using the same handle returned by pipInitializeOverlapCheck. Call pipClearRegionAPolygon after pipCheckForRegionOverlap or pipCheckForRegionOverlapEx and before additional calls to pipAddRegionAPolygon.