Difference between revisions of "VisionaireObject Command: clearLink"

From The Official Visionaire Studio: Adventure Game Engine Wiki
Line 32: Line 32:
 
'''Example 1:''' Clear the link to the currently used item (will remove a dragged item from the cursor).
 
'''Example 1:''' Clear the link to the currently used item (will remove a dragged item from the cursor).
 
<syntaxhighlight lang="lua">
 
<syntaxhighlight lang="lua">
-- Specify the field constant name
+
-- Specify the field constant name or the field id
 
game:clearLink(VGameUsedItem)
 
game:clearLink(VGameUsedItem)
 
-- Or specify the field id
 
 
game:clearLink(686)
 
game:clearLink(686)
  

Revision as of 20:08, 11 August 2023

Removes a link from the VisionaireObject.


Syntax

clearLink(field)


Parameters

Parameter Type Description
field int The object field to be cleared; has to be of "t_link" type.

Specify the field constant name (V + object table name in singular + field name) or the field id, see the example.


Return values

none


Examples

Example 1: Clear the link to the currently used item (will remove a dragged item from the cursor).

-- Specify the field constant name or the field id
game:clearLink(VGameUsedItem)
game:clearLink(686)

-- Setting an empty object leads to the same result
game:setValue(VGameUsedItem, emptyObject)

-- The shorthand notation offers a more convenient way to achieve the same
game.UsedItem = emptyObject