GetActorsByProcessingLevel

From the Fallout3 GECK Wiki
Revision as of 00:30, 2 October 2015 by imported>Jazzisparis (Created page with "{{Function |origin = JIP |summary = Returns an '''array_var''' containing all the actors in the game that are currently in the specified script/AI processing-level. |name =...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
< [[::Category:Functions|Category:Functions]]

A function added by the JIP NVSE Plugin.

Description

Returns an array_var containing all the actors in the game that are currently in the specified script/AI processing-level.

Syntax

[help]
(actors:array_var) GetActorsByProcessingLevel processingLvl:int{0-3}

Processing-Levels

0 (High):

Equivalent to all actors in the currently loaded interior cell or set of exterior cells adjacent to (and including) the player's current cell. Note that this is analogous to using GetRefs for actors, but is much faster and more efficient.


1 (Mid-High):

Equivalent to all actors in cells that are not currently loaded, but which have recently been visited by the player and are still buffered in memory.


2 (Mid-Low):

(Unknown at this time)


3 (Low):

Equivalent to all actors in cells that are neither currently loaded nor buffered in memory. Note that this includes the vast majority of actors in the game (many thousands). Avoid using this unless you have a good reason.

Example

let aActors := GetActorsByProcessingLevel 0

Will return all actors with high processing-level.

See Also