OnDistanceGreaterThan - ScriptObject

From Creation Kit
Jump to: navigation, search

Member of: ScriptObject

Event called when two objects are farther then the registered distance apart - if this script is registered for it.

This event will only be sent to the specific script that registered for it. Other scripts attached to the same form/alias/active magic effect will not receive the event unless they also register.

Syntax

Event OnDistanceGreaterThan(ObjectReference akObj1, ObjectReference akObj2, float afDistance)

Parameters

  • akObj1: The first ObjectReference which the distance check was performed on.
  • akObj2: The second ObjectReference which the distance check was performed on.
  • afDistance: The exact distance between the two objects at the time the event fired.

Example

Function SomeFunction()
  RegisterForDistanceGreaterThanEvent(Game.GetPlayer(), Bird, 1000.0) ; Before we can use OnDistanceGreaterThan we must register.
EndFunction
 
Event OnDistanceGreaterThan(ObjectReference akObj1, ObjectReference akObj2, float afDistance)
	;/ If other registrations had been done, we would want to check the objects
	   But since we only registered for one we know what it is /;
	Debug.Trace("Player is now " + afDistance + " units away from the bird - let's land")
endEvent

Notes

  • The two objects are interchangeable. They always match the order they were registered in, assuming someone else didn't register with the opposite order first.
  • Aliases and quests will automatically unregister for this event when the quest stops. Active magic effects will automatically unregister when they are removed.

See Also