Difference between revisions of "Osiris/API/GetVarInteger"
From Divinity Engine Wiki
| Line 8: | Line 8: | ||
===== Notes ===== | ===== Notes ===== | ||
* The variable has to be a global variable. The '''_Varname''' does not include the prefix % that is used for global variables in behaviourscript. E.g. a variable that is called ''%Variable'' in behaviourscript would simply be '''Variable''' for the purposes of this query. | * The variable has to be a global variable. The '''_Varname''' does not include the prefix % that is used for global variables in behaviourscript. E.g. a variable that is called ''%Variable'' in behaviourscript would simply be '''Variable''' for the purposes of this query. | ||
| + | * Can also be used to query variables of the SURFACE type. Because Osiris works with string names, however, a conversion with [[Osiris/API/GetSurfaceNameByTypeIndex]] is required. | ||
| + | * Other types stored in Enums can also be queried with this, but there are currently no conversion functions. | ||
===== See Also ===== | ===== See Also ===== | ||
* [[Osiris/API/GetVarObject|GetVarObject]] | * [[Osiris/API/GetVarObject|GetVarObject]] | ||
Revision as of 17:33, 20 December 2017
Full Definition(s)
- query GetVarInteger([in](GUIDSTRING)_Source, [in](String)_Varname, [out](INTEGER)_VarValue)
Description
Returns the value of the variable %<_Varname> of _Source, if it is an integer.
Return Values
- Success/Failure: Fails if _Source does not exist, or if the variable does not exist (or exists but has the wrong type).
- _VarValue: The value of the queried integer variable.
Notes
- The variable has to be a global variable. The _Varname does not include the prefix % that is used for global variables in behaviourscript. E.g. a variable that is called %Variable in behaviourscript would simply be Variable for the purposes of this query.
- Can also be used to query variables of the SURFACE type. Because Osiris works with string names, however, a conversion with Osiris/API/GetSurfaceNameByTypeIndex is required.
- Other types stored in Enums can also be queried with this, but there are currently no conversion functions.
