Osiris/API/CharacterSawCharacter - Revision history

Tinkerer: Document in detail when exactly CharacterSawCharacter events get thrown

2019-01-22T21:20:59Z

Document in detail when exactly CharacterSawCharacter events get thrown

← Older revision		Revision as of 21:20, 22 January 2019
Line 2:		Line 2:
	* event '''CharacterSawCharacter'''(''(CHARACTERGUID)'''''_Character''','' (CHARACTERGUID)'''''_OtherCharacter''')		* event '''CharacterSawCharacter'''(''(CHARACTERGUID)'''''_Character''','' (CHARACTERGUID)'''''_OtherCharacter''')
	===== Description =====		===== Description =====
	Thrown when one '''_Character''' sees '''_OtherCharacter'''. Note that this event is only thrown if '''_Character''' ~~has been registered as~~ an event generator.		Thrown when one '''_Character''' sees '''_OtherCharacter'''. Note that this event is only thrown if '''_Character''' is an event generator, or if the sight relation between '''_Character''' and '''_OtherCharacter''' has been previously created and is still active.
	===== Parameters =====		===== Parameters =====
	* '''_Character''': the character that does the seeing.		* '''_Character''': the character that does the seeing.
	* '''_OtherCharacter''': the character that is seen		* '''_OtherCharacter''': the character that is seen
	===== Notes =====		===== Notes =====
	* ~~By default, only~~ player-controlled characters are event generators. Once you call [[Osiris/API/CharacterCanSee\|CharacterCanSee]] with an NPC as first parameter, ~~an event generator is also registered~~ for this NPC and ~~it will also start throwing '''CharacterSawCharacter''' events~~. This ~~event generator~~ will ~~only work temporarily though~~, ~~so only rely on these events being thrown~~ for ~~player~~ characters.		* Only player-controlled characters that are not summons, are event generators.
			* Once you call [[Osiris/API/CharacterCanSee\|CharacterCanSee]] with an NPC as first parameter and a character as second parameter, a sight relation gets created for this NPC and the specified target. This sight relation will last between 0.5 and 1.0 seconds (random, to avoid having to re-evaluate the vision checks for all sight relations in the same frame).
			** If you call [[Osiris/API/CharacterCanSee\|CharacterCanSee]] again for this NPC and the same target during that period, the sight relation will be extended for another random period of similar duration.
			** If a game is saved while a sight relation for two characters is active, it will only be stored into the savegame (and hence restored while loading) if the NPC can currently see the registered target.
	* This call takes sneaking into account		* This call takes sneaking into account

Line 14:		Line 17:
	* [[Osiris/API/CharacterLostSightOfCharacter\|CharacterLostSightOfCharacter]]		* [[Osiris/API/CharacterLostSightOfCharacter\|CharacterLostSightOfCharacter]]
	* [[Osiris/API/HasLineOfSight\|HasLineOfSight]]		* [[Osiris/API/HasLineOfSight\|HasLineOfSight]]
			* Helper [[Osiris/Shared/DB_Sees\|DB_Sees]]

	[[Category:Osiris Events\|CharacterSawCharacter]]		[[Category:Osiris Events\|CharacterSawCharacter]]

Tinkerer: /* Notes */

2018-10-04T09:59:07Z

Notes

← Older revision		Revision as of 09:59, 4 October 2018
Line 7:		Line 7:
	* '''_OtherCharacter''': the character that is seen		* '''_OtherCharacter''': the character that is seen
	===== Notes =====		===== Notes =====
	* By default, only player-controlled characters are event generators. Once you call [[Osiris/API/CharacterCanSee\|CharacterCanSee]] with an NPC as first parameter, an event generator is also registered for this NPC and it will also start throwing '''CharacterSawCharacter''' events. This event generator ~~may~~ only work temporarily though, so ~~in general~~ only rely on these events be thrown for player characters.		* By default, only player-controlled characters are event generators. Once you call [[Osiris/API/CharacterCanSee\|CharacterCanSee]] with an NPC as first parameter, an event generator is also registered for this NPC and it will also start throwing '''CharacterSawCharacter''' events. This event generator will only work temporarily though, so only rely on these events being thrown for player characters.
	* This call takes sneaking into account		* This call takes sneaking into account

	===== See Also =====		===== See Also =====
	* [[Osiris/API/CharacterCanSee\|CharacterCanSee]]		* [[Osiris/API/CharacterCanSee\|CharacterCanSee]]

Tinkerer at 20:36, 13 September 2018

2018-09-13T20:36:58Z

← Older revision		Revision as of 20:36, 13 September 2018
Line 12:		Line 12:
	* [[Osiris/API/CharacterCanSee\|CharacterCanSee]]		* [[Osiris/API/CharacterCanSee\|CharacterCanSee]]
	* [[Osiris/API/CharacterLostSightOfCharacter\|CharacterLostSightOfCharacter]]		* [[Osiris/API/CharacterLostSightOfCharacter\|CharacterLostSightOfCharacter]]
			* [[Osiris/API/HasLineOfSight\|HasLineOfSight]]

	[[Category:Osiris Events\|CharacterSawCharacter]]		[[Category:Osiris Events\|CharacterSawCharacter]]

Tinkerer at 16:27, 18 January 2018

2018-01-18T16:27:42Z

← Older revision		Revision as of 16:27, 18 January 2018
Line 8:		Line 8:
	===== Notes =====		===== Notes =====
	* By default, only player-controlled characters are event generators. Once you call [[Osiris/API/CharacterCanSee\|CharacterCanSee]] with an NPC as first parameter, an event generator is also registered for this NPC and it will also start throwing '''CharacterSawCharacter''' events. This event generator may only work temporarily though, so in general only rely on these events be thrown for player characters.		* By default, only player-controlled characters are event generators. Once you call [[Osiris/API/CharacterCanSee\|CharacterCanSee]] with an NPC as first parameter, an event generator is also registered for this NPC and it will also start throwing '''CharacterSawCharacter''' events. This event generator may only work temporarily though, so in general only rely on these events be thrown for player characters.
			* This call takes sneaking into account
	===== See Also =====		===== See Also =====
	* [[Osiris/API/CharacterCanSee\|CharacterCanSee]]		* [[Osiris/API/CharacterCanSee\|CharacterCanSee]]

Tinkerer at 14:08, 19 December 2017

2017-12-19T14:08:09Z

← Older revision		Revision as of 14:08, 19 December 2017
Line 12:		Line 12:
	* [[Osiris/API/CharacterLostSightOfCharacter\|CharacterLostSightOfCharacter]]		* [[Osiris/API/CharacterLostSightOfCharacter\|CharacterLostSightOfCharacter]]

	[[Category:Osiris Events]]		[[Category:Osiris Events\|CharacterSawCharacter]]

Tinkerer at 20:37, 25 August 2017

2017-08-25T20:37:53Z

← Older revision		Revision as of 20:37, 25 August 2017
Line 7:		Line 7:
	* '''_OtherCharacter''': the character that is seen		* '''_OtherCharacter''': the character that is seen
	===== Notes =====		===== Notes =====
	* By default, only player-controlled characters are event generators. Once you call ~~'''~~CharacterCanSee~~'''~~ with an NPC as first parameter, an event generator is also registered for this NPC and it will also start throwing '''CharacterSawCharacter''' events. This event generator may only work temporarily though, so in general only rely on these events be thrown for player characters.		* By default, only player-controlled characters are event generators. Once you call [[Osiris/API/CharacterCanSee\|CharacterCanSee]] with an NPC as first parameter, an event generator is also registered for this NPC and it will also start throwing '''CharacterSawCharacter''' events. This event generator may only work temporarily though, so in general only rely on these events be thrown for player characters.
	===== See Also =====		===== See Also =====
	* [[Osiris/API/CharacterCanSee]]		* [[Osiris/API/CharacterCanSee\|CharacterCanSee]]
	* [[Osiris/API/CharacterLostSightOfCharacter]]		* [[Osiris/API/CharacterLostSightOfCharacter\|CharacterLostSightOfCharacter]]

	[[Category:Osiris Events]]		[[Category:Osiris Events]]

Tinkerer: Osiris Core APIs

2017-08-08T13:52:35Z

Osiris Core APIs

New page

===== Full Definition(s) =====
* event '''CharacterSawCharacter'''(''(CHARACTERGUID)'''''_Character''','' (CHARACTERGUID)'''''_OtherCharacter''')
===== Description =====
Thrown when one '''_Character''' sees '''_OtherCharacter'''. Note that this event is only thrown if '''_Character''' has been registered as an event generator.
===== Parameters =====
* '''_Character''': the character that does the seeing.
* '''_OtherCharacter''': the character that is seen
===== Notes =====
* By default, only player-controlled characters are event generators. Once you call '''CharacterCanSee''' with an NPC as first parameter, an event generator is also registered for this NPC and it will also start throwing '''CharacterSawCharacter''' events. This event generator may only work temporarily though, so in general only rely on these events be thrown for player characters.
===== See Also =====
* [[Osiris/API/CharacterCanSee]]
* [[Osiris/API/CharacterLostSightOfCharacter]]

[[Category:Osiris Events]]

← Older revision		Revision as of 20:36, 13 September 2018
Line 12:		Line 12:
	* [[Osiris/API/CharacterCanSee\|CharacterCanSee]]		* [[Osiris/API/CharacterCanSee\|CharacterCanSee]]
	* [[Osiris/API/CharacterLostSightOfCharacter\|CharacterLostSightOfCharacter]]		* [[Osiris/API/CharacterLostSightOfCharacter\|CharacterLostSightOfCharacter]]
			* [[Osiris/API/HasLineOfSight\|HasLineOfSight]]

	[[Category:Osiris Events\|CharacterSawCharacter]]		[[Category:Osiris Events\|CharacterSawCharacter]]