getDistance

getDistance() Function

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

• Introduced in version 1.3b51

Returns the distance between two tokens or objects.

Usage

<source lang="mtmacro" line> getDistance(target) </syntaxhighlight> <source lang="mtmacro" line> getDistance(target, units) </syntaxhighlight> <source lang="mtmacro" line> getDistance(target, units, source) </syntaxhighlight> <source lang="mtmacro" line> getDistance(target, units, source, metric) </syntaxhighlight> Parameters

• target - The id of the token that the distance is measured to.
• units - If set to false(0), the distance is given in cells, otherwise the default is to return the distance in Distance Per Cell units.
• source - The id of the token to measure the distance from, the default is the current token.
• metric - The movement metric to use which defaults to the movement metric in the users preferences, the metric can be one of the following strings
  • NO_GRID - The grid is ignored and straight line distance between the tokens is returned.
  • ONE_TWO_ONE - First Diagonal movement costs 1, second 2, and so on (Square grid only).
  • ONE_ONE_ONE - Diagonal movement costs a single square (Square grid only).
  • MANHATTAN - Diagonal movement costs 2 (Square grid only).
  • NO_DIAGONALS - No diagonal movement is allowed (Square grid only).

Example

To get the distance from the current token to the Altar.

<source lang="mtmacro" line> [h: dist = getDistance("Altar")] </syntaxhighlight>

To get the distance between the Altar and the Sacrifice in the number of squares or hexes. <source lang="mtmacro" line> [h: dist = getDistance("Altar", 0, "Sacrifice")] </syntaxhighlight>

To get the distance between the Altar and the Sacrifice in map distance units. <source lang="mtmacro" line> [h: dist = getDistance("Altar", 1, "Sacrifice")] </syntaxhighlight>

To get the straight line distance between the Altar and the Sacrifice. <source lang="mtmacro" line> [h: dist = getDistance("Altar", 1, "Sacrifice", "NO_GRID")]

</syntaxhighlight>

See Also

getDistanceToXY() getTokens()

Version Changes

• 1.3b55 - Added the optional metric argument.