transferHillVBL: Difference between revisions
Jump to navigation
Jump to search
m (Conversion script moved page transferHillVBL to TransferHillVBL without leaving a redirect: Converting page title to first-letter uppercase) |
m (Added description; fleshed out the rest of the page) |
||
(One intermediate revision 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" | 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( | |||
'''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" | ''Example: Transfer Hill VBL from Map to current Token'' | ||
transferHillVBL( | <syntaxhighlight lang="mtmacro"> | ||
[h: transferHillVBL(0)] | |||
</syntaxhighlight> | </syntaxhighlight> | ||
'' | ''Example: Clear Hill VBL from Token after transfer'' | ||
<syntaxhighlight lang="mtmacro"> | |||
[h: transferHillVBL(1, 1)] | |||
</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 VBL1
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 tokenid
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)]