Difference between revisions of "Osiris/API/DialogAddActor"
From Divinity Engine Wiki
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 | + | 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
- DialogAddActorAt
- DialogActorJoined
- DialogActorLeft
- Helper DB DialogNPCs
- Helper DB DialogPlayers
- Helper Proc_StartDialog
