OnGainLOS - Form

Member of: ActiveMagicEffect Script, Alias Script, and Form Script

Event called when a viewer goes from not seeing the target, to seeing the target - if this active magic effect/alias/form is registered for it.

Syntax

Event OnGainLOS(Actor akViewer, ObjectReference akTarget)

Parameters

• akViewer: The Actor that sees the target.
• akTarget: The ObjectReference that the actor can now see.

Example

Function SomeFunction()
  RegisterForSingleLOSGain(Game.GetPlayer(), SecretDocuments) ; Before we can use OnGainLOS we must register.
EndFunction

Event OnGainLOS(Actor akViewer, ObjectReference akTarget)
	;/ If other registrations had been done, we would want to check the viewer and target
	   But since we only registered for one we know what it is
	   Since we only did single los gain, we'll only get this once /;
	Debug.Trace("Player just saw the documents!")
endEvent

Notes

• Aliases and quests will automatically unregister for this event when the quest stops. Active magic effects will automatically unregister when they are removed.
• This event is not relayed to any aliases or magic effects attached to the form.

See Also

• ActiveMagicEffect Script
• Alias Script
• Form Script
• RegisterForLOS - Form
• RegisterForSingleLOSGain - Form
• RegisterForSingleLOSLost - Form
• UnregisterForLOS - Form
• OnLostLOS - Form
• HasLOS - Actor