getTokenWidth: Difference between revisions
Jump to navigation
Jump to search
(Created empty) |
m (Text replacement - "source>" to "syntaxhighlight>") |
||
(12 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
{{MacroFunction | {{MacroFunction | ||
|name=getTokenWidth | |name=getTokenWidth | ||
|proposed=false | |proposed=false | ||
|trusted= | |trusted=false | ||
|version=1.3b89 | |version=1.3b89 | ||
|description= | |description= | ||
Retrieves the token's image width in pixels (boundary size). | |||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
getTokenWidth() | |||
</ | getTokenWidth(id) | ||
getTokenWidth(id, mapname) | |||
</syntaxhighlight> | |||
'''Parameters''' | |||
{{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 /> | |||
The token's boundary (image) width in pixels. | |||
|example= | |example= | ||
Assuming a token called {{code|"Dragon"}}, medium size, on a 50px square grid, then: | |||
< | <syntaxhighlight lang="mtmacro" line> | ||
[ | [r: getTokenWidth("Dragon")] | ||
</syntaxhighlight> | |||
</ | returns: | ||
<syntaxhighlight lang="mtmacro" line> | |||
< | 50 | ||
</syntaxhighlight> | |||
</ | |||
|changes= | |||
{{change|1.5.4|Added {{code|mapname}} parameter option.}} | |||
|also= | |also= | ||
{{func|getTokenHeight}} | |||
{{func|getTokenNativeHeight}} | |||
{{func|getTokenNativeWidth}} | |||
}} | }} | ||
[[Category:Token Function]] | [[Category:Token Function]] |
Revision as of 21:05, 14 March 2023
getTokenWidth() Function
• Introduced in version 1.3b89
Retrieves the token's image width in pixels (boundary size).
Usage
getTokenWidth()
getTokenWidth(id)
getTokenWidth(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 boundary (image) width in pixels.
Example
Assuming a token called
"Dragon"
, medium size, on a 50px square grid, then:
[r: getTokenWidth("Dragon")]
returns:
50
See Also
Version Changes
- 1.5.4 - Added
mapname
parameter option.