getTokenNativeWidth: Difference between revisions
Jump to navigation
Jump to search
m (Text replacement - "source>" to "syntaxhighlight>") |
m (Text replacement - "<source" to "<syntaxhighlight") |
||
Line 8: | Line 8: | ||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
getTokenNativeWidth() | getTokenNativeWidth() | ||
getTokenNativeWidth(id) | getTokenNativeWidth(id) | ||
Line 23: | Line 23: | ||
|example= | |example= | ||
Assuming a token called {{code|"Dragon"}}, with 120px native image width, medium size, on a 50px square grid , then: | Assuming a token called {{code|"Dragon"}}, with 120px native image width, medium size, on a 50px square grid , then: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[r: getTokenWidth("Dragon")] | [r: getTokenWidth("Dragon")] | ||
</syntaxhighlight> | </syntaxhighlight> | ||
returns: | returns: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
120 | 120 | ||
</syntaxhighlight> | </syntaxhighlight> |
Revision as of 20:54, 14 March 2023
getTokenWidth() Function
• Introduced in version 1.5.1
Retrieves the token's native image width in pixels (native size).
Usage
getTokenNativeWidth()
getTokenNativeWidth(id)
getTokenNativeWidth(id, mapname)
Parameters
id
- The token id of the token to check for its width, 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 token's native (image) width in pixels.
Example
Assuming a token called
"Dragon"
, with 120px native image width, medium size, on a 50px square grid , then:
[r: getTokenWidth("Dragon")]
returns:
120
See Also
Version Changes
- 1.5.4 - Added
mapname
parameter option.