setTokenImage: Difference between revisions

Revision as of 18:52, 29 November 2019

• Introduced in version 1.3b48

Sets the image for the for the Current Token. The function accepts an Asset ID or an Image Token name. You can get Asset IDs from macro functions such as tblImage() or getTokenImage(). Image Tokens are special tokens whose name starts with "image:".

setTokenImage(assetId)
setTokenImage(assetId, id)
setTokenImage(assetId, id, mapname)

setTokenImage(imageToken)
setTokenImage(imageToken, id)
setTokenImage(imageToken, id, mapname)

Parameters

assetId - The Asset ID for an image.
imageToken - The name of an image token e.g. "image:myimage"
id - OPTIONAL: The token id of the token for which you want to set the image, defaults to the Current Token.
mapname - OPTIONAL: The name of the map to find the token. Defaults to the current map.

[h: setTokenImage(tblImage("elfImages", 1))]
[h: setTokenImage("image:Elf-Dead")]

@@ Line 3: / Line 3: @@
 |version=1.3b48
 |description=
-Sets the image for the for the [[Current Token]]. The image can come from several sources. It can come from a function that returns an [[asset id]] such as [[Macros:Functions:tblImage |tblImage()]] or [[Macros:Functions:getTokenImage|getTokenImage()]]. Or it could come from a [[Image Token|Image Token]].
+Sets the image for the for the [[Current Token]].  The function accepts an [[Asset ID]] or an [[Image_Token|Image Token]] name. You can get [[Asset ID]]s from macro functions such as {{func|tblImage}} or {{func|getTokenImage}}. [[Image Token]]s are special tokens whose name starts with "image:".
 |usage=
@@ Line 12: / Line 12: @@
 </source>
 <source lang="mtmacro" line>
-setTokenImage(tokenImageName)
+setTokenImage(imageToken)
-setTokenImage(tokenImageName, id)
+setTokenImage(imageToken, id)
-setTokenImage(tokenImageName, id, mapname)
+setTokenImage(imageToken, id, mapname)
 </source>
 '''Parameters'''
+{{param|assetId|The Asset ID for an image.}}
+{{param|imageToken|The name of an image token e.g. "image:myimage"}}
 {{param|id|OPTIONAL: The token {{code|id}} of the token for which you want to set the image, defaults to the [[Current Token]]. }}
 {{param|mapname|OPTIONAL: The name of the map to find the token.  Defaults to the current map.}}