GM_CreateCustomElevGridLayer – Global Mapper

Global Mapper SDK

Creates a new custom layer that represents an in-memory elevation grid. The handle to the newly created layer is returned. You must call GM_CloseLayer on the returned handle when you are done with it. If a problem occurs, NULL is returned for the layer handle.

The layer handle returned can be used just like any other layer handle. This means that you can do things like generate contours and calculate view sheds using the data.

This function is DEPRECATED. You should use the GM_CreateCustomElevGridLayerEx function instead.

Syntax

C++

Copy

GM_LayerHandle_t32 GM_CreateCustomElevGridLayer
(
const char*             aDescription,       // IN: Description to use for layer (can be NULL to use default)
const GM_Projection_t*  aProj,              // IN: Native projection of new layer
const GM_Point_t*       aTopLeft,           // IN: Ground coordinates of top left sample
double                  aXSampleSize,       // IN: Size of each grid cell in the x direction
double                  aYSampleSize,       // IN: Size of each grid cell in the y direction
sint32                  aNumSamplesX,       // IN: Number of samples in the x direction
sint32                  aNumSamplesY,       // IN: Number of samples in the y direction
const void*             aElevGrid,          // IN: Grid of elevation values in row-major order
GM_GridLayout_t8        aGridLayout,        // IN: Layout of elevation grid
float                   aNoDataValue        // IN: Value of samples for which the value isn't known (i.e. -9999.9)
);