getTokenX

getTokenX() Function

• Introduced in version 1.3b51

Gets the X coordinate of a token.

Usage

getTokenX()

getTokenX(units)

getTokenX(units, id)

Parameters

• units - If set to false(0), the coordinate is a location on the grid in cells. Defaults to true(1), where the coordinate is in Distance Per Cell units (in other words 0:distance in cells, 1: distance in pixels)'.
• id - The id of the token to move, defaults to the Current Token.

Which coordinate is returned for larger tokens With the exception of one case the coordinates of the cell are given where the UPPER LEFT CORNER of the token is in at that moment. The exception to this is when the token is 'Freesize' AND 'Snapped to Grid' AND NOT 'On Background Layer'. In that particular case the coordinates of the cell where the CENTRE of the image of the token is at.

Examples

Moves the Current Token down 5 units, and left 10 units.

[h: CurrentX = getTokenX()]
[h: CurrentY = getTokenY()]
[h: NewX = CurrentX + 5]
[h: NewY = CurrentY - 10]
[h: moveToken(NewX, NewY)]

Moves the Current Token down 5 cells, and left 10 cells.

[h: CurrentX = getTokenX(0)]
[h: CurrentY = getTokenY(0)]
[h: NewX = CurrentX + 5]
[h: NewY = CurrentY - 10]
[h: moveToken(NewX, NewY, 0)]

See Also

moveToken(), getTokenY()