transferHillVBL: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
(Created stub for transferHillVBL function)
 
m (Added description; fleshed out the rest of the page)
 
(2 intermediate revisions by one other user not shown)
Line 2: Line 2:
{{MacroFunction
{{MacroFunction
|name=transferHillVBL
|name=transferHillVBL
|proposed=false
|trusted=true
|version=1.12
|version=1.12
|description=
|description=
Directly transfers Hill VBL from token to the Hill VBL layer if {{code|true}}; otherwise, it transfers from the Hill VBL layer to the token's Hill VBL.


|usage=
|usage=
<syntaxhighlight lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
transferHillVBL(direction)
transferHillVBL(direction)
transferHillVBL(direction, delete)
transferHillVBL(direction, id)
transferHillVBL(direction, delete, id)
</syntaxhighlight>
</syntaxhighlight>


<syntaxhighlight lang="mtmacro" line>
This function can be used to transfer token Hill VBL to normal Hill VBL, or vice versa. Token VBL moves with the token, can be set under the VBL tab on the Token Editor Dialog, and is colored YELLOW.  Normal VBL is static, can be created with the VBL drawing tools, or with the use of the VBL functions, and is colored BLUE.
transferHillVBL(direction, id)
 
'''Parameters'''
{{param| direction |This value can be:
** {{code|0}} transfer normal (blue) Hill VBL to token (yellow) Hill VBL
** {{code|1}} transfer token (yellow) Hill VBL to normal (blue) Hill VBL}}
{{param|delete|Defines if the transferred Hill VBL is deleted from the source.}}
{{param|id|OPTIONAL: The token {{code|id}} of the token being acted upon. Defaults to the [[Current Token]].}}
 
|examples=
''Example: Transfer Hill VBL from Token to Map''
<syntaxhighlight lang="mtmacro">
[h: transferHillVBL(1, "Dragon")]
[h: transferHillVBL(0)]
</syntaxhighlight>
</syntaxhighlight>


<syntaxhighlight lang="mtmacro" line>
''Example: Transfer Hill VBL from Map to current Token''
transferHillVBL(direction, delete, id)
<syntaxhighlight lang="mtmacro">
[h: transferHillVBL(0)]
</syntaxhighlight>
</syntaxhighlight>


'''Parameters'''
''Example: Clear Hill VBL from Token after transfer''
{{param|direction|}}
<syntaxhighlight lang="mtmacro">
{{param|delete|}}
[h: transferHillVBL(1, 1)]
{{param|id|}}
</syntaxhighlight>


|also=
[[Introduction to Vision Blocking]], {{func|eraseHillVBL}}, {{func|drawHillVBL}}, {{func|setTokenHillVBL}}
}}
}}
[[Category:Miscellaneous Function]]
[[Category:VBL Function]]
[[Category:VBL Function]]

Latest revision as of 03:52, 5 June 2023

 This article is a stub, you can help the RPTools Wiki project by contributing content to expand this article.

transferHillVBL() Function

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

Introduced in version 1.12
Directly transfers Hill VBL from token to the Hill VBL layer if true; otherwise, it transfers from the Hill VBL layer to the token's Hill VBL.

Usage

transferHillVBL(direction)
transferHillVBL(direction, delete)
transferHillVBL(direction, id)
transferHillVBL(direction, delete, id)

This function can be used to transfer token Hill VBL to normal Hill VBL, or vice versa. Token VBL moves with the token, can be set under the VBL tab on the Token Editor Dialog, and is colored YELLOW. Normal VBL is static, can be created with the VBL drawing tools, or with the use of the VBL functions, and is colored BLUE.

Parameters

  • direction - This value can be:
    • 0 transfer normal (blue) Hill VBL to token (yellow) Hill VBL
    • 1 transfer token (yellow) Hill VBL to normal (blue) Hill VBL
  • delete - Defines if the transferred Hill VBL is deleted from the source.
  • id - OPTIONAL: The token id of the token being acted upon. Defaults to the Current Token.

Examples

Example: Transfer Hill VBL from Token to Map
[h: transferHillVBL(1, "Dragon")]
[h: transferHillVBL(0)]

Example: Transfer Hill VBL from Map to current Token

[h: transferHillVBL(0)]

Example: Clear Hill VBL from Token after transfer

[h: transferHillVBL(1, 1)]

See Also