globalmapper.GetPointFeatureEx
==============================

.. currentmodule:: globalmapper
.. py:function:: GetPointFeatureEx (GM_LayerHandle_t32 aLayer, uint32 aPointIndex, GM_GetFeatureFlags_t32 aFlags, int aReserved) -> GM_PointFeature_t

    Returns the point feature at the given index in the layer. Returns 0 if the layer does not contain an point at
    the given index or if a registration key was not found and *aPointIndex* 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:`FreePointFeature<globalmapper.FreePointFeature>` when you are done accessing the feature.

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