transferPitVBL

From RPTools Wiki
Revision as of 03:54, 5 June 2023 by Azhrei (talk | contribs) (Added description; fleshed out the rest of the page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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

transferPitVBL() Function

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

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

Usage

transferPitVBL(direction)
transferPitVBL(direction, delete)
transferPitVBL(direction, id)
transferPitVBL(direction, delete, id)

This function can be used to transfer token Pit VBL to normal Pit 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) Pit VBL to token (yellow) Pit VBL
    • 1 transfer token (yellow) Pit VBL to normal (blue) Pit VBL
  • delete - Defines if the transferred Pit 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 Pit VBL from Token to Map
[h: transferPitVBL(1, "Dragon")]
[h: transferPitVBL(0)]

Example: Transfer Pit VBL from Map to current Token

[h: transferPitVBL(0)]

Example: Clear Pit VBL from Token after transfer

[h: transferPitVBL(1, 1)]

See Also