Table of Contents

map_GetPixel

Description

Get the value of a pixel in a map.

Function prototype

bool CExtAPI::map_GetPixel(ZMAP hMap, long x, long y, void* pValue);

Arguments

Name Type Comment
hMap ZMAP A ZMAP handle to a map, the pixel of which is to be retrieved.
x long The x-coordinate of the pixel.
y long The y-coordinate of the pixel.
pValue void* A pointer (of unknown type) to the user-supplied entity that shall receive the pixel value.

Return value

False if an error occurred, and true otherwise.

Comments

None.

Example

int nx = theAPI.map_GetWidth(hMap);
int ny = theAPI.map_GetHeight(hMap);

// check the map type before messing with pixels
if(theAPI.map_GetTypeID(hMap)!=MAP_Heightfield)
  return false;

float val;

// step through all pixels
for(int j=0; j<ny; j++) {
  for(int i=0; i<nx; i++) {
    if(!theAPI.map_GetPixel(hMap, i, j, &val)) // get the pixel value
      return false;
 
    val+=10.0f; // increment the value by 10

    if(!theAPI.map_SetPixel(hMap, i, j, &val)) // set the pixel value again
      return false;
  }
}

return true;