getTokenNativeWidth

From RPTools Wiki
Revision as of 19:36, 14 March 2023 by Taustin (talk | contribs) (Text replacement - "source>" to "syntaxhighlight>")
Jump to navigation Jump to search

getTokenWidth() Function

Introduced in version 1.5.1
Retrieves the token's native image width in pixels (native size).

Usage

<source lang="mtmacro" line> getTokenNativeWidth() getTokenNativeWidth(id) getTokenNativeWidth(id, mapname) </syntaxhighlight>

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:

<source lang="mtmacro" line> [r: getTokenWidth("Dragon")] </syntaxhighlight> returns: <source lang="mtmacro" line> 120

</syntaxhighlight>

See Also

Version Changes

  • 1.5.4 - Added mapname parameter option.