Difference between revisions of "VisionaireObject Command: getBool"

From The Official Visionaire Studio: Adventure Game Engine Wiki
 
(One intermediate revision by the same user not shown)
Line 17: Line 17:
 
|-
 
|-
 
| field
 
| field
| int
+
| integer
 
| The field which specifies a boolean value. The field type must be "t_bool".
 
| The field which specifies a boolean value. The field type must be "t_bool".
''Specify the field by the field constant (V + object table name in singular + field name) or by its id, see the example.''
+
''Specify the field constant name (V + object table name in singular + field name) or the field id, see the example.''
 
|}
 
|}
  
Line 39: Line 39:
 
'''Example 1:''' Get the boolean value of a condition.
 
'''Example 1:''' Get the boolean value of a condition.
 
<syntaxhighlight lang="lua">
 
<syntaxhighlight lang="lua">
-- Specify the field by the field constant or by its id
+
-- Specify the field constant name or the field id
 
local door_state = getObject("Conditions[door_closed]"):getBool(VConditionValue)
 
local door_state = getObject("Conditions[door_closed]"):getBool(VConditionValue)
 
local door_state = getObject("Conditions[door_closed]"):getBool(194)
 
local door_state = getObject("Conditions[door_closed]"):getBool(194)

Latest revision as of 21:13, 11 August 2023

Returns the boolean value of a VisionaireObject field.


Syntax

getBool(field)


Parameters

Parameter Type Description
field integer The field which specifies a boolean value. The field type must be "t_bool".

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


Return values

Type Description
boolean The boolean value of the field.


Examples

Example 1: Get the boolean value of a condition.

-- Specify the field constant name or the field id
local door_state = getObject("Conditions[door_closed]"):getBool(VConditionValue)
local door_state = getObject("Conditions[door_closed]"):getBool(194)

-- The shorthand notation offers a more convenient way to achieve the same
local door_state = Conditions["door_closed"].Value