getTokenImage: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Conversion script moved page GetTokenImage to getTokenImage: Converting page titles to lowercase)
m (Text replacement - "source>" to "syntaxhighlight>")
Line 10: Line 10:
getTokenImage(size, id)
getTokenImage(size, id)
getTokenImage(size, id, mapname)
getTokenImage(size, id, mapname)
</source>
</syntaxhighlight>


'''Parameters'''
'''Parameters'''
Line 21: Line 21:
<source lang="mtmacro" line>
<source lang="mtmacro" line>
<img src='[r:getTokenImage()]'></img>
<img src='[r:getTokenImage()]'></img>
</source>
</syntaxhighlight>


To get the image of any [[Token:token|token]] using its id and the token roll option.
To get the image of any [[Token:token|token]] using its id and the token roll option.
<source lang="mtmacro" line>
<source lang="mtmacro" line>
[h, token(tokenId): imgAsset = getTokenImage()]  
[h, token(tokenId): imgAsset = getTokenImage()]  
</source>
</syntaxhighlight>
|changes={{change|1.5.4|Added {{code|id}} and {{code|mapname}} parameter options.}}
|changes={{change|1.5.4|Added {{code|id}} and {{code|mapname}} parameter options.}}
|also=
|also=

Revision as of 19:36, 14 March 2023

getTokenImage() Function

Returns the asset id of the image for the for the Current Token.

Usage

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

Parameters

  • size - OPTIONAL: The size in pixels the image should be returned as. If a blank string "", no size adjustment is done. Defaults to "".
  • id - OPTIONAL: The token id of the token for which you want to retrieve the token image, defaults to the Current Token.
  • mapname - OPTIONAL: The name of the map to find the token. Defaults to the current map.

Examples

To display the image for the current token.

<source lang="mtmacro" line> <img src='[r:getTokenImage()]'></img> </syntaxhighlight>

To get the image of any token using its id and the token roll option. <source lang="mtmacro" line> [h, token(tokenId): imgAsset = getTokenImage()]

</syntaxhighlight>

See Also

Version Changes

  • 1.5.4 - Added id and mapname parameter options.