setTokenVBL: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
(Expanded on text and links to other VBL funcs.)
(Added example that clears VBL from token.)
Line 19: Line 19:
{{param|id|OPTIONAL: The token {{code|id}} of the token for which you want to set this setting, defaults to the [[Current Token]]. }}
{{param|id|OPTIONAL: The token {{code|id}} of the token for which you want to set this setting, defaults to the [[Current Token]]. }}


''Example:''<source lang="mtmacro">
''Example: Transfer VBL from one Token to another''<source lang="mtmacro">
[h: vbl = getTokenVBL("Door, Steel")]
[h: vbl = getTokenVBL("Door, Steel")]
[h: setTokenVBL(vbl, "Door, Wood")]
[h: setTokenVBL(vbl, "Door, Wood")]
</source><br />
''Example: Erase VBL from Token''<source lang="mtmacro">
[r: finalVblData = "{'shape':'none'}"]
[r: setTokenVBL(finalVblData)]
</source><br />
</source><br />



Revision as of 16:29, 3 February 2019

setTokenVBL() Function

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

Introduced in version 1.4.1.6
Sets the VBL of a token to that given in the JSON object parameter.

Usage

setTokenVBL(vbl, id)

This function is used to attach the TOKEN VBL passed in as a JSON object to a token. The JSON object may be be created by calling getTokenVBL() on a different token and may also be used with drawVBL() or eraseVBL().

Token VBL moves with the token, can be set under the VBL tab on the token edit menu and is colored YELLOW. Normal VBL is static, can be created with the VBL drawing tools or with the use of VBL functions and is colored BLUE.

Parameters

  • vbl - A JSON object containing the vbl to be added to the token. Use getTokenVBL() to get VBL from another token.
  • id - OPTIONAL: The token id of the token for which you want to set this setting, defaults to the Current Token.

Example: Transfer VBL from one Token to another

[h: vbl = getTokenVBL("Door, Steel")]
[h: setTokenVBL(vbl, "Door, Wood")]


Example: Erase VBL from Token

[r: finalVblData = "{'shape':'none'}"]
[r: setTokenVBL(finalVblData)]



See Also