GetActorsByProcessingLevel

From GECK
Jump to: navigation, search


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, excluding the player ref itself. 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