Tile Access



int tileInfo(unsigned int x, unsigned int y, BaseStruct *base)

x - X coordinate in pixels of the tile you want information on
y - Y coordinate in pixels of the tile you want information on
*base - A BaseStruct to save the information to

returns - 0 on error or non-zero if sucessful.

Given a coordinate in PIXELS, this function modifies the "base" parameter
passed in to contain all the data on the desired base layer tile.
A return value of 0 means error, such as out of bounds for your (x,y)
pair, and 1 if successful. 


int tileInfo(unsigned int x, unsigned int y, FringeStruct *fringe)

x - X coordinate in pixels of the tile you want information on
y - Y coordinate in pixels of the tile you want information on
*fringe - A FringeStruct to save the information to

returns - 0 on error or non-zero if sucessful.

Given a coordinate in PIXELS, this function modifies the "fringe" parameter
passed in to contain all the data on the desired base layer tile.
A return value of 0 means error, such as out of bounds for your (x,y)
pair, and 1 if successful. 


int tileInfo(unsigned int x, unsigned int y, ObjectStruct *obj)

  x - X coordinate in pixels of the tile you want information on
  y - Y coordinate in pixels of the tile you want information on
  *obj - An ObjStruct to save the information to

returns - 0 on error or non-zero if sucessful.

Given a coordinate in PIXELS, this function modifies the "obj" parameter
passed in to contain all the data on the desired base layer tile.
A return value of 0 means error, such as out of bounds for your (x,y)
pair, and 1 if successful. .



int tileInfo(unsigned int x, unsigned int y, RoofStruct *roof)

  x - X coordinate in pixels of the tile you want information on
  y - Y coordinate in pixels of the tile you want information on
  *roof - A RoofStruct to save the information to

returns - 0 on error or non-zero if sucessful.

Given a coordinate in PIXELS, this function modifies the "roof" parameter
passed in to contain all the data on the desired base layer tile.
A return value of 0 means error, such as out of bounds for your (x,y)
pair, and 1 if successful. .


int modifyTile(unsigned int x, unsigned int y, BaseStruct bs)

x - X coordinate in pixels of the tile you want information on
y - Y coordinate in pixels of the tile you want information on
bs - A BaseStruct containing the information to modify

returns - 0 on error or non-zero if sucessful.

Given a coordinate specified in PIXELS, this function will modify
the tile at that location to contain exactly the same values of the
fields specified by the struct parameter.  NOTE: this only affects tiles
in memory, it does not alter the contents of the disk file.
A return value of 0 indicates error, most likely out of bounds, whereas
1 indicates success.



int modifyTile(unsigned int x, unsigned int y, FringeStruct fs)

x - X coordinate in pixels of the tile you want information on
y - Y coordinate in pixels of the tile you want information on
fs - A FringeStruct containing the information to modify

returns - 0 on error or non-zero if sucessful.

Given a coordinate specified in PIXELS, this function will modify
the tile at that location to contain exactly the same values of the
fields specified by the struct parameter.  NOTE: this only affects tiles
in memory, it does not alter the contents of the disk file.
A return value of 0 indicates error, most likely out of bounds, whereas
1 indicates success.



int modifyTile(unsigned int x, unsigned int y, ObjectStruct os)

x - X coordinate in pixels of the tile you want information on
y - Y coordinate in pixels of the tile you want information on
os - An ObjectStruct containing the information to modify

returns - 0 on error or non-zero if sucessful.

Given a coordinate specified in PIXELS, this function will modify
the tile at that location to contain exactly the same values of the
fields specified by the struct parameter.  NOTE: this only affects tiles
in memory, it does not alter the contents of the disk file.
A return value of 0 indicates error, most likely out of bounds, whereas
1 indicates success.



int modifyTile(unsigned int x, unsigned int y, RoofStruct rs)

x - X coordinate in pixels of the tile you want information on
y - Y coordinate in pixels of the tile you want information on
rs - A RoofStruct containing the information to modify

returns - 0 on error or non-zero if sucessful.

Given a coordinate specified in PIXELS, this function will modify
the tile at that location to contain exactly the same values of the
fields specified by the struct parameter.  NOTE: this only affects tiles
in memory, it does not alter the contents of the disk file.
A return value of 0 indicates error, most likely out of bounds, whereas
1 indicates success.