setSize: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Not a stub anymore)
mNo edit summary
Line 12: Line 12:
<table class="wikitable" border="1" style="border-collapse: collapse; float: left; margin-right: 2em">
<table class="wikitable" border="1" style="border-collapse: collapse; float: left; margin-right: 2em">
<tr style="background-color:#e0ddd5"><th>Hex Grid</th><th>Scale</th></tr>
<tr style="background-color:#e0ddd5"><th>Hex Grid</th><th>Scale</th></tr>
<tr><td>{{code|1/6}}<td>0.408
<tr><td>{{code|1/6}}</td><td>0.408</td></tr>
<tr><td>{{code|1/4}}<td>0.5
<tr><td>{{code|1/4}}</td><td>0.5</td></tr>
<tr><td>{{code|1/3}}<td>0.577
<tr><td>{{code|1/3}}</td><td>0.577</td></tr>
<tr><td>{{code|1/2}}<td>0.707
<tr><td>{{code|1/2}}</td><td>0.707</td></tr>
<tr><td>{{code|2/3}}<td>0.816
<tr><td>{{code|2/3}}</td><td>0.816</td></tr>
<tr><td>{{code|Medium}}<td>1.0
<tr><td>{{code|Medium}}</td><td>1.0</td></tr>
<tr><td>{{code|Large}}<td>0.9 (3 cells)
<tr><td>{{code|Large}}</td><td>0.9 (3 cells)</td></tr>
<tr><td>{{code|Huge}}<td>1.0 (6 cells)
<tr><td>{{code|Huge}}</td><td>1.0 (6 cells)</td></tr>
<tr><td>{{code|Humongous}}<td>1.0 (19 cells)
<tr><td>{{code|Humongous}}</td><td>1.0 (19 cells)</td></tr>
</table>
</table>



Revision as of 04:40, 27 February 2019

setSize() Function

 Note: This function can only be used in a Trusted Macro

Introduced in version 1.3b48
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 GridScale
1/60.408
1/40.5
1/30.577
1/20.707
2/30.816
Medium1.0
Large0.9 (3 cells)
Huge1.0 (6 cells)
Humongous1.0 (19 cells)
Square GridScale
Fine0.5
Diminutive0.5
Tiny0.5
Small0.75
Medium1.0
Large1.0 (2x2)
Huge1.0 (3x3)
Gargantuan1.0 (4x4)
Colossal1.0 (6x6)
GridlessScale GridlessScale GridlessScale
-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

Needs Clarification:
It would be nice to include pictures that demonstrate how the grid cells are composed; at least for the hex grids.

Usage

setSize(size)
setSize(size, id)

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:
[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.