globalmapper.FindNearestFeatures

globalmapper.FindNearestFeatures(GM_Point_t aPixelSearchPt, [GM_LayerHandle_t32] aLayerList, GM_FindFlags_t32 aFindFlags, GM_Rectangle_t aWorldBounds, GM_PixelRect_t aPixelRect, uint32 MAX_OUTPUT_LEN, uint32 aMaxDistPixels) → GM_Error_t32, GM_FoundFeature_t, uint32[source]

Searches the provided list of layers for any visible vector features within the provided search distance (aMaxDistPixels) of the pixel search location (aPixelSearchPt). The aFindFlags parameter specifies what types of features to search on.

Parameters:

  • aPixelSearchPt (GM_Point_t) – Search location in pixel coordinates

  • aLayerList ([GM_LayerHandle_t32]) – List of layers to search or None for all vector layers

  • aFindFlags (GM_FindFlags_t32) – Flags controlling how the find is performed

  • aWorldBounds (GM_Rectangle_t) – World bounds for search space or None for last drawn

  • aPixelRect (GM_PixelRect_t) – Pixel bounds for search space or None for last drawn

  • MAX_OUTPUT_LEN (uint32) – Max number of nearest features to find

  • aMaxDistPixels (uint32) – Max distance in pixels to search

Returns:

Error Code

Return type:

GM_Error_t32

Returns:

List of nearest features

Return type:

GM_FoundFeature_t

Returns:

Number of nearest features returned in list

Return type:

uint32