Difference between revisions of "Osiris/API/DialogAddActor"

From Divinity Engine Wiki
Jump to: navigation, search
m
(Corrected description)
Line 2: Line 2:
 
* call '''DialogAddActor'''(''''(INTEGER)'''''_InstanceID''''',''(GUIDSTRING)'''''_Actor''')
 
* call '''DialogAddActor'''(''''(INTEGER)'''''_InstanceID''''',''(GUIDSTRING)'''''_Actor''')
 
===== Description =====
 
===== Description =====
Adds character or item '''_Actor''' as an '''''observer''''' to the ongoing dialog with ID '''_InstanceID'''. I.e., '''_Actor''' will follow the dialog along with its participants and will see/hear everything that gets said, but cannot make any choices in the dialog.
+
Adds character or item '''_Actor''' to the ongoing dialog with ID '''_InstanceID'''.
 +
 
 +
When starting a dialog, you can specify NULL as one or more speakers. These speakers can afterwards be filled in using this API or [[Osiris/API/DialogAddActorAt|DialogAddActorAt]].
 +
 
 +
If the dialog instance has a null speaker slot available right after its last non-null speaker slot, this API will fill that speaker slot with the '''_Actor''' and '''_Actor''' will participate in the dialog as if it had been added from the start. If no such slot is available, '''_Actor''' will be added as an '''''observer''''', which means '''_Actor''' will follow the dialog along with its participants and will see/hear everything that gets said, but cannot make any choices in the dialog.
 
===== Notes =====
 
===== Notes =====
 
* Take care that '''_Actor''' is close enough to the characters participating in the dialog, otherwise you may get visual culling issues in multiplayer.
 
* Take care that '''_Actor''' is close enough to the characters participating in the dialog, otherwise you may get visual culling issues in multiplayer.

Revision as of 13:57, 19 February 2019

Full Definition(s)
  • call DialogAddActor('(INTEGER)_InstanceID,(GUIDSTRING)_Actor)
Description

Adds character or item _Actor to the ongoing dialog with ID _InstanceID.

When starting a dialog, you can specify NULL as one or more speakers. These speakers can afterwards be filled in using this API or DialogAddActorAt.

If the dialog instance has a null speaker slot available right after its last non-null speaker slot, this API will fill that speaker slot with the _Actor and _Actor will participate in the dialog as if it had been added from the start. If no such slot is available, _Actor will be added as an observer, which means _Actor will follow the dialog along with its participants and will see/hear everything that gets said, but cannot make any choices in the dialog.

Notes
  • Take care that _Actor is close enough to the characters participating in the dialog, otherwise you may get visual culling issues in multiplayer.
  • (DOS2 Classic) Used to be DialogAddCharacter
See Also