getTokenNativeWidth: Difference between revisions
Jump to navigation
Jump to search
(add getTokenNativeWidth function) |
m (Text replacement - "<source" to "<syntaxhighlight") |
||
(5 intermediate revisions by 4 users not shown) | |||
Line 8: | Line 8: | ||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
getTokenNativeWidth() | getTokenNativeWidth() | ||
getTokenNativeWidth(id) | getTokenNativeWidth(id) | ||
</ | getTokenNativeWidth(id, mapname) | ||
</syntaxhighlight> | |||
'''Parameters''' | '''Parameters''' | ||
{{param|id|The token id of the token to check for its width, defaults to the [[Current Token]].}}{{TrustedParameter}} | {{param|id|The token id of the token to check for its width, defaults to the [[Current Token]].}}{{TrustedParameter}} | ||
{{param|mapname|The name of the map to find the token. Defaults to the current map.}} | |||
'''Result'''<br /> | '''Result'''<br /> | ||
The token's native (image) width in pixels. | The token's native (image) width in pixels. | ||
|example= | |example= | ||
Assuming a token called {{code|"Dragon"}}, medium size, on a 50px square grid | 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> | ||
returns: | returns: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
120 | 120 | ||
</ | </syntaxhighlight> | ||
|changes= | |||
{{change|1.5.4|Added {{code|mapname}} parameter option.}} | |||
|also= | |also= |
Latest 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.