globalmapper.GetAreaFeatureEx

globalmapper.GetAreaFeatureEx(GM_LayerHandle_t32 aLayer, uint32 aAreaIndex, GM_GetFeatureFlags_t32 aFlags, uint32 aReserved=0) → GM_AreaFeature_t[source]

Returns the area feature at the given index in the layer. Returns 0 if the layer does not contain an area at the given index or if a registration key was not found and aAreaIndex was greater than GM_MAX_NON_REGISTERED_VECTOR_IDX.

Using the aFlags parameter you can control whether the coordinates for the features are returned in the native projection of the layer or in the current set projection. You can also indicate that you don’t want the coordinates at all.

Any features returned from this function must be freed using a call to FreeAreaFeature when you are done accessing the feature.

Parameters:

  • aLayer (GM_LayerHandle_t32) – Layer to get area from

  • aAreaIndex (uint32) – Index of area feature to retrieve

  • aFlags (GM_GetFeatureFlags_t32) – Flags for getting feature

  • aReserved (int) – Reserved for future use; defaults to 0

Returns:

The area feature at index aAreaIndex within aLayer

Return type:

GM_AreaFeature_t