setSize: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
Line 16: | Line 16: | ||
{{param|id|The token {{code|id}} of the token which will have its [[Token Size]] set. Defaults to the [[Current Token]].}} | {{param|id|The token {{code|id}} of the token which will have its [[Token Size]] set. Defaults to the [[Current Token]].}} | ||
{{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.}} | ||
The sizes available on the Token Layer are: | |||
* {{code|Fine}} | |||
* {{code|Diminutive}} | |||
* {{code|Tiny}} | |||
* {{code|Small}} | |||
* {{code|Medium}} | |||
* {{code|Large}} | |||
* {{code|Huge}} | |||
* {{code|Gargantuan}} | |||
* {{code|Colossal}} | |||
| |||
The sizes available on the Hidden, Object and Background Layers are: | |||
* {{code|1/6}} | |||
* {{code|1/4}} | |||
* {{code|1/3}} | |||
* {{code|1/3}} | |||
* {{code|1/3}} | |||
* {{code|Medium}} | |||
* {{code|Large}} | |||
* {{code|Huge}} | |||
* {{code|Homongous}} | |||
| |||
|examples= | |examples= |
Revision as of 18:26, 6 April 2024
setSize() Function
Note: This function can only be used in a Trusted Macro
• Introduced in version 1.3b48
Sets the size of a Token with one of the defined sizes according to each Grid Type. The sizes can be found on the Token Size page. "Free" or "Native" are also valid values.
Usage
setSize(size)
setSize(size, id)
setSize(size, id, mapname)
Parameters
size
- A Token Size to set the token to. Can be "Free" or "Native" as well.id
- The tokenid
of the token which will have its Token Size set. Defaults to the Current Token.mapname
- The name of the map to find the token. Defaults to the current map.
The sizes available on the Token Layer are:
Fine
Diminutive
Tiny
Small
Medium
Large
Huge
Gargantuan
Colossal
The sizes available on the Hidden, Object and Background Layers are:
1/6
1/4
1/3
1/3
1/3
Medium
Large
Huge
Homongous
Examples
To set the size of the current token to
Medium
:
[h: setSize("Medium")]
To set the size of the current token to whatever string is stored in the macro variable mySize:
[h: mySize = "Large"]
[h: setSize(mySize)]
See Also
Version Changes
- 1.3b51 - Added
id
parameter option. - 1.5.4 - Added
mapname
parameter option.