setTokenWidth: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
(Created page with "{{MacroFunction |name=setTokenWidth |proposed=false |trusted=false |version=1.3b91 |description= This function set the token's image width in pixels (boundary size). |usage=...")
 
No edit summary
 
(6 intermediate revisions by 5 users not shown)
Line 5: Line 5:
|version=1.3b91
|version=1.3b91
|description=
|description=
This function set the token's image width in pixels (boundary size).
Sets the token's image width in pixels (boundary size).


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
setTokenWidth(size)
setTokenWidth(size, id)
setTokenWidth(size, id)
</source>
setTokenWidth(size, id, mapname)
</syntaxhighlight>


'''Parameters'''
'''Parameters'''
{{param|size|grid size of the token}}
{{param|size|grid size of the token}}
{{param|id|The token id of the token to set its width}}
{{param|id|The token {{code|id}} of the token to set its width.  Defaults to the [[Current_Token|Current Token]].}}{{TrustedParameter}}
{{param|mapname|The name of the map to find the token.  Defaults to the current map.}}


|example=
|example=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[r: setTokenWidth(300, "Dragon")]
[r: setTokenWidth(300, "Dragon")]
[r: setTokenHeight(150, "Dragon")]
[r: setTokenHeight(150, "Dragon")]
</source>
</syntaxhighlight>


|changes=
{{change|1.5.4|Added {{code|mapname}} parameter option.}}


|also=
|also=
{{func|setTokenHeight}}
{{func|setTokenHeight}}, {{func|getTokenHeight}}, {{func|getTokenWidth}}
{{func|getTokenHeight}}
{{func|getTokenWidth}}
}}
}}
[[Category:Token Function]]
[[Category:Token Function]]

Latest revision as of 17:47, 14 March 2023

setTokenWidth() Function

Introduced in version 1.3b91
Sets the token's image width in pixels (boundary size).

Usage

setTokenWidth(size)
setTokenWidth(size, id)
setTokenWidth(size, id, mapname)

Parameters

  • size - grid size of the token
  • id - The token id of the token to set its width. Defaults to the Current Token.

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

  • mapname - The name of the map to find the token. Defaults to the current map.

Example

[r: setTokenWidth(300, "Dragon")]
[r: setTokenHeight(150, "Dragon")]

See Also

Version Changes

  • 1.5.4 - Added mapname parameter option.