globalmapper.GetLineFeatureEx

globalmapper.GetLineFeatureEx(GM_LayerHandle_t32 aLayer, uint32 aLineIndex, GM_GetFeatureFlags_t32 aFlags, uint32 aReserved=0) → GM_LineFeature_t[source]

Returns the line feature at the given index in the layer. Returns 0 if the layer does not contain a line at the given index or if a registration key was not found and aLineIndex 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 FreeLineFeature when you are done accessing the feature.

Parameters:

  • aLayer (GM_LayerHandle_t32) – Layer to get line from

  • aLineIndex (uint32) – Index of line feature to retrieve

  • aFlags (GM_GetFeatureFlags_t32) – Flags for getting feature

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

Returns:

The line feature at index aLineIndex within aLayer

Return type:

GM_LineFeature_t