setTokenShape: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 15: | Line 15: | ||
</source> | </source> | ||
'''Parameters''' | '''Parameters''' | ||
{{param|shape|String value: {{code|" | {{param|shape|String value: {{code|"TOP_DOWN"}}, {{code|"CIRCLE"}}, {{code|"SQUARE"}}, {{code|"FIGURE"}}.}} | ||
{{param|id|The token id of the token to set to a new shape, defaults to the [[Current Token]].}}{{TrustedParameter}} | {{param|id|The token id of the token to set to a new shape, defaults to the [[Current Token]].}}{{TrustedParameter}} | ||
{{param|mapname|The name of the map to find the token. Defaults to the current map.}} | {{param|mapname|The name of the map to find the token. Defaults to the current map.}} | ||
| Line 21: | Line 21: | ||
'''Result'''<br /> | '''Result'''<br /> | ||
The function returns the token's shape as a string value: {{code|" | The function returns the token's shape as a string value: {{code|"TOP_DOWN"}}, {{code|"CIRCLE"}}, {{code|"SQUARE"}}, {{code|"FIGURE"}}. | ||
|example= | |example= | ||
| Line 35: | Line 35: | ||
With Token ID. | With Token ID. | ||
<source lang="mtmacro" line> | <source lang="mtmacro" line> | ||
[h: newShape = " | [h: newShape = "TOP_DOWN"] | ||
[h: tokenName = "Some Token"] | [h: tokenName = "Some Token"] | ||
[r: setTokenShape(newShape,tokenName)] | [r: setTokenShape(newShape,tokenName)] | ||
| Line 45: | Line 45: | ||
|changes= | |changes= | ||
{{change|1.9.0|Shape parameter {{code|TOP_DOWN}} works with or without underscore character.}} | |||
{{change|1.5.4|Added {{code|mapname}} parameter option.}} | {{change|1.5.4|Added {{code|mapname}} parameter option.}} | ||
Revision as of 13:23, 11 May 2021
This article is a stub, you can help the RPTools Wiki project by contributing content to expand this article.
This article needs: No examples yet.
setTokenShape() Function
• Introduced in version 1.3b89
Sets the token's shape (top down, circle, square, figure).
Usage
setTokenShape(shape)
setTokenShape(shape, id)
setTokenShape(shape, id, mapname)Parameters
shape- String value:"TOP_DOWN","CIRCLE","SQUARE","FIGURE".id- The token id of the token to set to a new shape, 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 function returns the token's shape as a string value: "TOP_DOWN", "CIRCLE", "SQUARE", "FIGURE".
Example
On current token.
[h: newShape = "CIRCLE"]
[r: setTokenShape(newShape)]Returns:
CircleWith Token ID.
[h: newShape = "TOP_DOWN"]
[h: tokenName = "Some Token"]
[r: setTokenShape(newShape,tokenName)]Returns:
Top downSee Also
Version Changes
- 1.9.0 - Shape parameter
TOP_DOWNworks with or without underscore character. - 1.5.4 - Added
mapnameparameter option.