Finds the first polygon that contains the input point.
Syntax
intl gdlPointInPolygon( gdlFileHandle hFile, gdlShape point, gdlShape* polygon );
Arguments
hFile
The gdlFileHandle returned by gdlOpenSpatialFile. Input.
point
Pointer to a gdlShape that contains the geocode coordinates. Input.
polygon
A pointer to the first polygon found to contain the input point. Output.
Return values
GDL_WRONG_TYPE
GDL_NOT_FOUND
GDL_ERROR
GDL_OK
Prerequisites
gdlOpenSpatialFile
gdlShapeCreate or gldGenerateErrorSurface
Alternates
None.
Notes
Call gdlShapeFree on the output polygon.
The following diagram illustrates the first polygon that contains the input point: