Osiris/API/SetOnStage: Difference between revisions

From Divinity Engine Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(4 intermediate revisions by the same user not shown)
Line 7: Line 7:
* it becomes inactive: none of its reactions or scriptframes in behaviour scripts will run;
* it becomes inactive: none of its reactions or scriptframes in behaviour scripts will run;
* it will ''still'' receive events;
* it will ''still'' receive events;
* it becomes invisible and cannot be interacted with by anything or anyone using game mechanics (combat, surfaces, ...)
* it becomes invisible and cannot be interacted with by anything or anyone using game mechanics (combat, surfaces, ...);
* it won't take up room on the AI-grid: other items/characters can occupy the space where the object was located


===== Notes =====
===== Notes =====
* /
* If a player character is set off-stage, the camera will automatically move to another player character controlled by the same user if there are any. NPCs and items near the player that was moved off-stage will also become inactive unless other (non-off-stage) player characters are still nearby.
 
===== See Also =====
===== See Also =====
* [[Osiris/API/CharacterAppear|CharacterAppear]]
* [[Osiris/API/CharacterAppear|CharacterAppear]]
Line 17: Line 19:
* [[Osiris/API/CharacterAppearOutOfSightTo|CharacterAppearOutOfSightTo]]
* [[Osiris/API/CharacterAppearOutOfSightTo|CharacterAppearOutOfSightTo]]
* [[Osiris/API/CharacterAppearOutOfSightToObject|CharacterAppearOutOfSightToObject]]
* [[Osiris/API/CharacterAppearOutOfSightToObject|CharacterAppearOutOfSightToObject]]
* [[Osiris/API/CharacterSetDetached|CharacterSetDetached]]
* [[Osiris/API/CharacterWentOnStage|CharacterWentOnStage]]
* [[Osiris/API/ItemWentOnStage|ItemWentOnStage]]
* [[Osiris/API/SetVisible|SetVisible]]
* [[Osiris/API/SetVisible|SetVisible]]


[[Category:Osiris Calls]]
[[Category:Osiris Calls|SetOnStage]]

Latest revision as of 08:57, 24 April 2019

Full Definition(s)
  • call SetOnStage((GUIDSTRING)_Object, (INTEGER)_OnStage)
Description

Depending on whether _OnStage is 0 or 1, sets _Object either off-stage or on-stage. Object can be a character or an item.

By default, all objects are on stage. When an object is set off-stage,

  • it becomes inactive: none of its reactions or scriptframes in behaviour scripts will run;
  • it will still receive events;
  • it becomes invisible and cannot be interacted with by anything or anyone using game mechanics (combat, surfaces, ...);
  • it won't take up room on the AI-grid: other items/characters can occupy the space where the object was located
Notes
  • If a player character is set off-stage, the camera will automatically move to another player character controlled by the same user if there are any. NPCs and items near the player that was moved off-stage will also become inactive unless other (non-off-stage) player characters are still nearby.
See Also