getTokenRotation

From RPTools Wiki
Jump to navigationJump to search

getTokenRotation() Function

Introduced in version 1.5.0
Retrieves the angle of rotation for the token from the default position. Returned value is in degrees.

For Square, Round or Figure token types, this is the change in the facing indicator from the default of 0 degrees or no change in facing. Positive is CW and negative is CCW. Values will range from -270 to +85.

For Top Down tokens, this is the rotation of the token image itself from the default of 0 degrees.

Usage

getTokenRotation()
getTokenRotation(id)
getTokenRotation(id, mapname)

Parameters

  • id - The token id of the token to retrieve the rotation angle. 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.

Result
The function returns the token's rotation as a numeric value measured in degrees.

Example

Get the rotation for the four tokens shown below.
[h: switchToken("Mage")]
[r: token.name] - [r: r = getTokenRotation()]<br>
[h: switchToken("Elf")]
[r: token.name] - [r: r = getTokenRotation()]<br>
[h: switchToken("Hero")]
[r: token.name] - [r: r = getTokenRotation()]<br>
[h: switchToken("Troll")]
[r: token.name] - [r: r = getTokenRotation()]

Returns: getTokenRotation.png

Relation to Token Facing

When the facing is defined, the relation between a token's rotation and the token's facing can be expressed as

rotation = -(facing + 90)
When no facing has been set, getTokenFacing will return the blank string "" but getTokenRotation will return 0.

See Also

Version Changes

  • 1.5.4 - Added mapname parameter option.