GetTileMainLight1Color(location)

Determines the color of the first main light of a tile.

int GetTileMainLight1Color(
    location lTile
);

Parameters

lTile

The location of the tile.


Description

Returns the color (TILE_MAIN_LIGHT_COLOR_*) for the main light 1 of the tile at lTile.



Remarks

This is another one of those counter intuitive functions. While you are affecting a specific tile that tile is being identified by a location. Also the location used to locate a tile is different than the location used to locate an object, a tile is located by the integer portion of a location in that tile / 10. Or for me I just remember that tiles are numbered in a zero based integer matrix, so the lower left tile in a 3X3 area would be located with a Location-object that has a member vector whose x and y = 0.


Version

1.26

Example

//First we need to know what area the tiles are in
string sArea = "My Area Name";

//Next we need to create a new vector to identify a particular tile
vector vTile = Vector(0.0, 0.0, 0.0);

//Next we build a location for the specific tile, in this case the 
//tile located at 0,0 in the area.
location lTile = Location(GetObjectByTag(sAreaTag, 0), vTile, 0.0);

//With the location lTile we can now get the light color for that tile.
int iLight = GetTileMainLight1Color (lTile);

// ---
//First we need to know what area the tiles are in
string sArea = "My Area Name";

//Next we need to create a new vector to identify a particular tile vector vTile = Vector(1.0, 2.0, 0.0);

//Next we build a location for the specific tile, in this case the //tile located at the second column and third row (counting //from the lower left corner). location lTile = Location(GetObjectByTag(sAreaTag, 0), vTile, 0.0);

//With the location lTile we can now get the light color for that tile. int iLight = GetTileMainLight1Color (lTile);

See Also

functions: GetTileMainLight2Color | GetTileSourceLight1Color | GetTileSourceLight2Color | RecomputeStaticLighting
categories: Area Functions | Get Data from Object Functions | Lighting Effects Functions
constants: TILE_MAIN_LIGHT_COLOR_* Constants


 author: Michael Nork, editor: Charles Feduke, additional contributor(s): Roy Fisher