getTokenNativeWidth: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Text replacement - "source>" to "syntaxhighlight>")
m (Text replacement - "<source" to "<syntaxhighlight")
Line 8: Line 8:


|usage=
|usage=
<source lang="mtmacro" line>
<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:
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[r: getTokenWidth("Dragon")]
[r: getTokenWidth("Dragon")]
</syntaxhighlight>
</syntaxhighlight>
returns:
returns:
<source lang="mtmacro" line>
<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.