getTokenFacing: Difference between revisions
Jump to navigation
Jump to search
m (Conversion script moved page getTokenFacing to GetTokenFacing without leaving a redirect: Converting page title to first-letter uppercase) |
No edit summary |
||
| (5 intermediate revisions by 2 users not shown) | |||
| Line 8: | Line 8: | ||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
getTokenFacing() | getTokenFacing() | ||
getTokenFacing( | getTokenFacing(tokenRef) | ||
getTokenFacing( | getTokenFacing(tokenRef, mapRef) | ||
</ | </syntaxhighlight> | ||
'''Parameters''' | '''Parameters''' | ||
{{param|id| | {{param|tokenRef|Either the token [[getSelected|{{code|id}}]] or [[getTokenName|Token Name]] of the token to get the facing from, defaults to the current token.}}{{TrustedParameter}} | ||
{{param| | {{param|mapRef|The Name or ID of the map to find the token. Defaults to the current map.}} | ||
{{Note|Token IDs are unique, but Token Names can be duplicated. Using Token Name when more than one token has the same name can produce unexpected results.}} | |||
'''Returns''' | '''Returns''' | ||
| Line 21: | Line 22: | ||
|example= | |example= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h: switchToken("Mage")] | [h: switchToken("Mage")] | ||
[r: token.name]: [r: r = getTokenFacing()]<br> | [r: token.name]: [r: r = getTokenFacing()]<br> | ||
| Line 30: | Line 31: | ||
[h: switchToken("Troll")] | [h: switchToken("Troll")] | ||
[r: token.name]: [r: r = getTokenFacing()] | [r: token.name]: [r: r = getTokenFacing()] | ||
</ | </syntaxhighlight> | ||
'''Returns:'''<br /> | '''Returns:'''<br /> | ||
[[File: | [[File:GetTokenFacing.png]] | ||
|also= | |also= | ||
[[setTokenFacing]]<br />[[getTokenRotation]] | [[setTokenFacing]]<br />[[getTokenRotation]] | ||
Latest revision as of 23:59, 14 May 2024
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.
Note that math.atan2_r can be used to calculate facing from a direction given in two coordinate pairs.
Usage
getTokenFacing()
getTokenFacing(tokenRef)
getTokenFacing(tokenRef, mapRef)Parameters
tokenRef- Either the tokenidor Token Name of the token to get the facing from, defaults to the current token.Note: This parameter can only be used in a Trusted Macro.
mapRef- The Name or ID of the map to find the token. Defaults to the current map.
Token IDs are unique, but Token Names can be duplicated. Using Token Name when more than one token has the same name can produce unexpected results.
Returns
The angle in degrees or "" if no facing has been set
Example
[h: switchToken("Mage")]
[r: token.name]: [r: r = getTokenFacing()]<br>
[h: switchToken("Elf")]
[r: token.name]: [r: r = getTokenFacing()]<br>
[h: switchToken("Hero")]
[r: token.name]: [r: r = getTokenFacing()]<br>
[h: switchToken("Troll")]
[r: token.name]: [r: r = getTokenFacing()]Returns:
See Also
Version Changes
- 1.5.4 - Added
mapnameparameter option.