setTokenShape: Difference between revisions
Jump to navigation
Jump to search
m (Conversion script moved page setTokenShape to SetTokenShape without leaving a redirect: Converting page title to first-letter uppercase) |
No edit summary |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 9: | Line 9: | ||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
setTokenShape(shape) | setTokenShape(shape) | ||
setTokenShape(shape, id) | setTokenShape(shape, id) | ||
setTokenShape(shape, id, | setTokenShape(shape, id, mapRef) | ||
</ | </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"}}.}} | ||
{{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| | {{param|mapRef|The Name or ID of the map to find the token. Defaults to the current map.}} | ||
| 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= | ||
Latest revision as of 23:59, 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, mapRef)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.
mapRef- The Name or ID 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.