setTokenShape: Difference between revisions
Jump to navigation
Jump to search
m (Conversion script moved page SetTokenShape to setTokenShape: Converting page titles to lowercase) |
No edit summary |
||
| Line 9: | Line 9: | ||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
setTokenShape(shape) | setTokenShape(shape) | ||
setTokenShape(shape, id) | setTokenShape(shape, id) | ||
setTokenShape(shape, id, mapname) | setTokenShape(shape, id, mapname) | ||
</ | </syntaxhighlight> | ||
'''Parameters''' | '''Parameters''' | ||
{{param|shape|String value: {{code|"TOP_DOWN"}}, {{code|"CIRCLE"}}, {{code|"SQUARE"}}, {{code|"FIGURE"}}.}} | {{param|shape|String value: {{code|"TOP_DOWN"}}, {{code|"CIRCLE"}}, {{code|"SQUARE"}}, {{code|"FIGURE"}}.}} | ||
| Line 25: | Line 25: | ||
|example= | |example= | ||
On current token. | On current token. | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h: newShape = "CIRCLE"] | [h: newShape = "CIRCLE"] | ||
[r: setTokenShape(newShape)] | [r: setTokenShape(newShape)] | ||
</ | </syntaxhighlight> | ||
Returns: | Returns: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
Circle | Circle | ||
</ | </syntaxhighlight> | ||
With Token ID. | With Token ID. | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h: newShape = "TOP_DOWN"] | [h: newShape = "TOP_DOWN"] | ||
[h: tokenName = "Some Token"] | [h: tokenName = "Some Token"] | ||
[r: setTokenShape(newShape,tokenName)] | [r: setTokenShape(newShape,tokenName)] | ||
</ | </syntaxhighlight> | ||
Returns: | Returns: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
Top down | Top down | ||
</ | </syntaxhighlight> | ||
|changes= | |changes= | ||
Revision as of 17:49, 14 March 2023
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.