getTokenImage: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 8: Line 8:
getTokenImage()
getTokenImage()
getTokenImage(size)
getTokenImage(size)
getTokenImage(size, id)
getTokenImage(size, id, mapname)
</source>
</source>
'''Parameters'''
{{size|value|OPTIONAL: The size the picture should be returned as. If a blank string "", no size adjustment is done. Defaults to "".}}
{{param|id|OPTIONAL: The token {{code|id}} of the token for which you want to retrieve the token image, defaults to the [[Current Token]]. }}
{{param|mapname|OPTIONAL: The name of the map to find the token.  Defaults to the current map.}}


|examples=
|examples=
Line 16: Line 23:
</source>
</source>


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>
</source>
 
|changes={{change|1.5.4|Added {{code|id}} and {{code|mapname}} parameter options.}}
|also=
|also=
[[getImage|getImage]]
[[getImage|getImage]]
}}
}}
[[Category:Token Function]]
[[Category:Token Function]]

Revision as of 04:07, 15 August 2019

getTokenImage() Function

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

Usage

getTokenImage()
getTokenImage(size)
getTokenImage(size, id)
getTokenImage(size, id, mapname)

Parameters Template:size

  • 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.
<img src='[r:getTokenImage()]'></img>

To get the image of any token using its id and the token roll option.

[h, token(tokenId): imgAsset = getTokenImage()]

See Also

Version Changes

  • 1.5.4 - Added id and mapname parameter options.