GM_GetPixelColorRow

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

Syntax

GM_DLL_EXPORTED GM_Error_t32 __stdcall GM_GetPixelColorRow
(
GM_LayerHandle_t32      aLayer,     // IN: Layer to get color from
sint32                  aRow,       // IN: Y coord of pixel (0 is topmost)
COLORREF*               aColorRow,  // OUT: Buffer to hold color values
COLORREF                aInvalidVal // IN: Value to use for invalid pixels
);