getTokenFacing

getTokenFacing() Function

• Introduced in version 1.3b51

Gets the facing angle for the specified or current token. Values will range from -179 to +180. Default facing is -90 degrees or down, 0 degrees is to the right, +90 degrees is up, +180 degrees is to the left. The jump in the value range is the difference between "exactly left" (+180) and "almost exactly left, but tilted 1 degree down" (-179).
Note that math.atan2_r can be used to calculate facing from a direction given in two coordinate pairs.

Usage

<source lang="mtmacro" line> getTokenFacing() getTokenFacing(id) getTokenFacing(id, mapname) </syntaxhighlight> Parameters

• id - The id of the token to get the facing from, defaults to the current token.

   Note: This parameter can only be used in a Trusted Macro. 

• mapname - The name of the map to find the token. Defaults to the current map.

Returns The angle in degrees or "" if no facing has been set

Example

<source lang="mtmacro" line>

[h: switchToken("Mage")] [r: token.name]: [r: r = getTokenFacing()]
[h: switchToken("Elf")] [r: token.name]: [r: r = getTokenFacing()]
[h: switchToken("Hero")] [r: token.name]: [r: r = getTokenFacing()]
[h: switchToken("Troll")] [r: token.name]: [r: r = getTokenFacing()] </syntaxhighlight> Returns:

See Also

setTokenFacing
getTokenRotation

Version Changes

• 1.5.4 - Added mapname parameter option.