Determines if a binary polygon overlap has occurred and, if so, returns the polygon that is in overlap with the input polygon.
Syntax
intl gdlFindPolygonOverlap( gdlFileHandle hFile, gdlShape polygon, gdlShape* output );
Arguments
hFile
The gdlFileHandle returned by gdlOpenSpatialFile. Input.
polygon
The polygon with which to determine overlap. Input
output
A pointer to the overlapping polygon. Output.
Return values
GDL_WRONG_TYPE
GDL_NOT_FOUND
GDL_ERROR
GDL_OK
Prerequisites
gdlOpenSpatialFile
Alternates
gdlFindPolygonOverlapPercentage
gdlGenerateErrorSurface
Notes
Following instances of this function, you should call gdlShapeFree with the output polygon when you are finished using the output polygon to release system resources.
The following diagram illustrates a polygon that is in overlap with an input polygon: