GM_GetPixelElevationRow

Marius Lazar

September 02, 2026 13:43 Updated

Global Mapper SDK

Retrieves the elevation values for an entire row of the provided layer. If any elevations don't have valid values they will be replaced byy aInvalidVal. This function is much faster than individually getting the elevation value for individual pixels using the GM_GetPixelElevation function, so use this to access large portions of a loaded layer.

Syntax

C++

Copy

GM_DLL_EXPORTED GM_Error_t32 __stdcall GM_GetPixelElevationRow
(
GM_LayerHandle_t32      aLayer,     // IN: Layer to get elevation from
sint32                  aRow,       // IN: Y coord of pixel (0 is topmost)
float*                  aElevRow,   // OUT: Buffer to hold elevation values for row in meters
float                   aInvalidVal // IN: Value to use for invalid samples (i.e. -9999.9)
);