getTokenHeight: Difference between revisions
Jump to navigation
Jump to search
m (Typographical tweaks) |
m (Text replacement - "<source" to "<syntaxhighlight") |
||
(6 intermediate revisions by 5 users not shown) | |||
Line 5: | Line 5: | ||
|version=1.3b89 | |version=1.3b89 | ||
|description= | |description= | ||
Retrieves the token's image height in pixels (boundary size). | |||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
getTokenHeight() | getTokenHeight() | ||
getTokenHeight(id) | getTokenHeight(id) | ||
</ | getTokenHeight(id, mapname) | ||
</syntaxhighlight> | |||
'''Parameter''' | '''Parameter''' | ||
{{param|id|The token id of the token to check for its height, defaults to the [[Current Token]].}} | {{param|id|The token id of the token to check for its height, defaults to the [[Current Token]].}} | ||
{{param|mapname|The name of the map to find the token. Defaults to the current map.}} | |||
'''Result'''<br /> | '''Result'''<br /> | ||
Line 20: | Line 23: | ||
|example= | |example= | ||
Assuming a token called {{code|"Dragon"}}, medium size, on a 50px square grid, then: | Assuming a token called {{code|"Dragon"}}, medium size, on a 50px square grid, then: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[r: getTokenHeight("Dragon")] | [r: getTokenHeight("Dragon")] | ||
</ | </syntaxhighlight> | ||
returns: | returns: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
50 | 50 | ||
</ | </syntaxhighlight> | ||
|changes= | |||
{{change|1.5.4|Added {{code|mapname}} parameter option.}} | |||
|also= | |also= | ||
{{func|getTokenNativeHeight}} | |||
{{func|getTokenWidth}} | {{func|getTokenWidth}} | ||
{{func|getTokenNativeWidth}} | |||
}} | }} | ||
[[Category:Token Function]] | [[Category:Token Function]] |
Latest revision as of 20:57, 14 March 2023
getTokenHeight() Function
• Introduced in version 1.3b89
Retrieves the token's image height in pixels (boundary size).
Usage
getTokenHeight()
getTokenHeight(id)
getTokenHeight(id, mapname)
Parameter
id
- The token id of the token to check for its height, defaults to the Current Token.mapname
- The name of the map to find the token. Defaults to the current map.
Result
The token's boundary (image) height in pixels.
Example
Assuming a token called
"Dragon"
, medium size, on a 50px square grid, then:
[r: getTokenHeight("Dragon")]
returns:
50
See Also
Version Changes
- 1.5.4 - Added
mapname
parameter option.