resetSize

From RPTools Wiki
(Redirected from ResetSize)
Jump to navigation Jump to search

resetSize() Function

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

Introduced in version 1.3b48
Resets the Size of a Token to the default for grid type of the map it occupies. See setSize() for details about the default size for different grid types.

Usage

resetSize()
resetSize(tokenRef)
resetSize(tokenRef, mapname)

Parameters

  • tokenRef - Either the token id or Token Name of the token to reset, defaults to the Current Token.
  • mapName - Optional map name to find the token. Defaults to current map.
Token IDs are unique, but Token Names can be duplicated. Using Token Name when more than one token has the same name can produce unexpected results.

Examples

To reset the size of the current token to the default for the map:
[h: resetSize()]

To reset the size of token Chocolate Moose on map Cadbury:

[h: tok = "Chocolate Moose"]
[h: map = "Cadbury"]
[h: resetSize(tok, map)]

See Also

Version Changes

  • 1.5.4 - Added mapName parameter option.