setSize

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 names of each size are based on the type of grid the map uses. 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, mapRef)

Parameters

• size - A Token Size to set the token to. Can be "Free" or "Native" as well.
• id - The token id of the token which will have its Token Size set. Defaults to the Current Token.
• mapRef - The Name or ID of the map to find the token. Defaults to the current map.

The sizes available on the for Square grid maps are:

• Fine
• Diminutive
• Tiny
• Small
• Medium
• Large
• Huge
• Gargantuan
• Colossal

 

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

getSize() resetSize()

Version Changes

• 1.3b51 - Added id parameter option.
• 1.5.4 - Added mapname parameter option.