FindClosestActorFromRef - Game
Revision as of 18:31, 29 June 2013 by imported>Thingy Person (→Syntax)
Member of: Game Script
Finds the closest actor within a given radius of a reference.
Syntax
Actor Function FindRandomActorFromRef(ObjectReference arCenter, float afRadius) global
return FindRandomActor(arCenter.X, arCenter.Y, arCenter.Z, afRadius)
endFunctionParameters
- arCenter: The reference to search around
- afRadius: Maximum distance from center to look for an actor
Return Value
The closest actor found, none if none. The reference provided for arCenter is not excluded from the search, limiting this function's usefulness somewhat. The example code, for example, would always return "player".
Examples
; Find the closest actor to the player, limiting the search to 5 units
Actor closest = Game.FindClosestActorFromRef(RefProperty, 5.0)Notes
- The player is an actor, so this function can return the player if they are the closest actor to arCenter.
- If an actor is used as the center of this search, that actor's reference will always be the one returned by this function, so it cannot be used to find the closest actor to another actor, including the player.