globalmapper.GetLineFeatureEx
=============================

.. currentmodule:: globalmapper
.. py:function:: GetLineFeatureEx (GM_LayerHandle_t32 aLayer, uint32 aLineIndex, GM_GetFeatureFlags_t32 aFlags, int aReserved) -> GM_LineFeature_t

    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
    :doc:`FreeLineFeature<globalmapper.FreeLineFeature>` when you are done accessing the feature.

    :param GM_LayerHandle_t32 aLayer: Layer to get line from
    :param uint32 aLineIndex: Index of line feature to retrieve
    :param GM_GetFeatureFlags_t32 aFlags: Flags for getting feature
    :param int aReserved: Reserved for future use; must be 0.
    :returns: The line feature at index *aLineIndex* within *aLayer*
    :rtype: GM_LineFeature_t