setTokenSnapToGrid: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Conversion script moved page SetTokenSnapToGrid to setTokenSnapToGrid: Converting page titles to lowercase)
No edit summary
 
(One intermediate revision by the same user not shown)
Line 6: Line 6:


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
setTokenSnapToGrid(snap)
setTokenSnapToGrid(snap)
setTokenSnapToGrid(snap, id)
setTokenSnapToGrid(snap, id)
setTokenSnapToGrid(snap, id, mapname)
setTokenSnapToGrid(snap, id, mapRef)
</source>
</syntaxhighlight>


'''Parameters'''
'''Parameters'''
{{param|snap|A value {{true}} or {{false}}.}}
{{param|snap|A value {{true}} or {{false}}.}}
{{param|id|The id of the token to set its snap behaviour.}}
{{param|id|The id of the token to set its snap behaviour.}}
{{param|mapname|The name of the map to find the token.  Defaults to the current map.}}
{{param|mapRef|The Name or ID of the map to find the token.  Defaults to the current map.}}




|example=
|example=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h: setTokenSnapToGrid(0)]
[h: setTokenSnapToGrid(0)]
[h: setTokenSnapToGrid(1, currentToken())]</source>
[h: setTokenSnapToGrid(1, currentToken())]</syntaxhighlight>


|changes=
|changes=

Latest revision as of 23:59, 14 March 2023

setTokenSnapToGrid() Function

Introduced in version 1.4
Sets the "snap to" behaviour for the Current Token or a specified token.

Usage

setTokenSnapToGrid(snap)
setTokenSnapToGrid(snap, id)
setTokenSnapToGrid(snap, id, mapRef)

Parameters

  • snap - A value true(1) or false(0).
  • id - The id of the token to set its snap behaviour.
  • mapRef - The Name or ID of the map to find the token. Defaults to the current map.

Example

[h: setTokenSnapToGrid(0)]
[h: setTokenSnapToGrid(1, currentToken())]

See Also

Version Changes

  • 1.5.4 - Added mapname parameter option.