Difference between revisions of "Osiris/API/ObjectSetFlag"

From Divinity Engine Wiki
Jump to: navigation, search
m
m
 
(5 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
* call '''ObjectSetFlag'''(''(GUIDSTRING)'''''_Target''', ''(STRING)'''''_Flag''', ''(INTEGER)'''''_DialogInstance''')
 
* call '''ObjectSetFlag'''(''(GUIDSTRING)'''''_Target''', ''(STRING)'''''_Flag''', ''(INTEGER)'''''_DialogInstance''')
 
===== Description =====
 
===== Description =====
Sets the (character/item) flag '''_Flag''' from '''_Target'''. The '''_DialogInstance''' parameter can be examined when catching the corresponding [[Osiris/API/ObjectFlagSet|ObjectFlagSet]] event, but is otherwise unused.
+
Sets the (character/item) flag '''_Flag''' on '''_Target'''. The '''_DialogInstance''' parameter can be examined when catching the corresponding [[Osiris/API/ObjectFlagSet|ObjectFlagSet]] event, but is otherwise unused.
===== Return Values =====
 
* None
 
 
===== Notes =====
 
===== Notes =====
 
* There is an overload in the Shared mod without the last parameter, which passes 0.
 
* There is an overload in the Shared mod without the last parameter, which passes 0.
* When a character flag is set or cleared in a dialog, it is only set on the current shapeshift form of the character. This means that if the player afterwards uses the Mask of the Shapeshifter to shapeshift to a different form (or removes the mask while they were wearing it during the dialog), this flag's state will revert to whatever state it had when the player last had that state. However, the Osiris APIs always work on  all shapeshift forms simultaneously. This means that this API will set the flag for all shapeshift forms, including "not shapeshifted".
+
* When an object flag is set or cleared in a dialog on a character, it is only set on the current shapeshift form of the character. This means that if the player afterwards uses the Mask of the Shapeshifter to shapeshift to a different form (or removes the mask while they were wearing it during the dialog), this flag's state will revert to whatever state it had when the player last had that form. However, the Osiris APIs always work on  all shapeshift forms simultaneously. This means that this API will set the flag for all shapeshift forms, including "not shapeshifted".
 
===== See Also =====
 
===== See Also =====
 +
* [[Osiris/API/GlobalSetFlag|GlobalSetFlag]]
 
* [[Osiris/API/ObjectClearFlag|ObjectClearFlag]]
 
* [[Osiris/API/ObjectClearFlag|ObjectClearFlag]]
 +
* [[Osiris/API/ObjectFlagCleared|ObjectFlagCleared]]
 
* [[Osiris/API/ObjectFlagSet|ObjectFlagSet]]
 
* [[Osiris/API/ObjectFlagSet|ObjectFlagSet]]
 +
* [[Osiris/API/ObjectGetFlag|ObjectGetFlag]]
 +
* [[Osiris/API/PartySetFlag|PartySetFlag]]
 +
* [[Osiris/API/UserSetFlag|UserSetFlag]]
 
   
 
   
 
[[Category:Osiris Calls|ObjectSetFlag]]
 
[[Category:Osiris Calls|ObjectSetFlag]]

Latest revision as of 21:40, 18 July 2019

Full Definition(s)
  • call ObjectSetFlag((GUIDSTRING)_Target, (STRING)_Flag, (INTEGER)_DialogInstance)
Description

Sets the (character/item) flag _Flag on _Target. The _DialogInstance parameter can be examined when catching the corresponding ObjectFlagSet event, but is otherwise unused.

Notes
  • There is an overload in the Shared mod without the last parameter, which passes 0.
  • When an object flag is set or cleared in a dialog on a character, it is only set on the current shapeshift form of the character. This means that if the player afterwards uses the Mask of the Shapeshifter to shapeshift to a different form (or removes the mask while they were wearing it during the dialog), this flag's state will revert to whatever state it had when the player last had that form. However, the Osiris APIs always work on all shapeshift forms simultaneously. This means that this API will set the flag for all shapeshift forms, including "not shapeshifted".
See Also