setSize

Contents 1 setSize() Function 2 Grid Sizes and Scales 2.1 Usage 2.2 Examples 2.3 See Also 2.4 Version Changes

setSize() Function

Sets the Size of a Token.

Grid Sizes and Scales

The valid sizes for each type of grid are documented below, where Medium is always 1 full grid cell. The Scale is a multiplier for the size of the image after configuring it to fit within the stated footprint. For example, the Huge size on a square grid occupies a 3x3 cell area and the image is scaled (1.0) to exactly fit that area. But the Large size on a hex grid is 3 hexes scaled down 10% (0.9) so as to keep the image slightly within the border of the 3 cells.

Hex Grid	Scale
1/6	0.408
1/4	0.5
1/3	0.577
1/2	0.707
2/3	0.816
Medium	1.0
Large	0.9 (3 cells)
Huge	1.0 (6 cells)
Humongous	1.0 (19 cells)

Square Grid	Scale
Fine	0.5
Diminutive	0.5
Tiny	0.5
Small	0.75
Medium	1.0
Large	1.0 (2x2)
Huge	1.0 (3x3)
Gargantuan	1.0 (4x4)
Colossal	1.0 (6x6)

Gridless	Scale	Gridless	Scale	Gridless	Scale
-11	0.086	0	1.0	11	7.43
-10	0.107	1	1.2	12	8.916
-9	0.134	2	1.44	13	10.699
-8	0.168	3	1.728	14	12.839
-7	0.21	4	2.074	15	15.407
-6	0.262	5	2.488	16	18.488
-5	0.328	6	2.986	17	22.186
-4	0.41	7	3.583	18	26.623
-3	0.512	8	4.3	19	31.948
-2	0.64	9	5.16	20	38.338
-1	0.8	10	6.192

Usage

Parameters

• size - The Size to set the token to.
• id - The token id of the token which has its Size set, defaults to the Current Token.

• Note that if the token is in 'Free size' or 'Native size' you will get an error when you use 'setSize' on the token.

Examples

• To set the size of the current token to Medium:

• To set the size of the current token to whatever string is stored in the macro variable mySize:

See Also

getSize()

Version Changes

• 1.3b51 - Added id parameter option.

Token: A visual marker representing a character, monster, or NPCTrusted Macro: A macro run from a Library token or run by the GM, that cannot be edited by a player.Macro: A series of text instructions used to automate processes in MapTool.