PerceptionSystem

PerceptionSystem calculates vision, FOV cone, line-of-sight raycasting, and hearing alert detection.

Constructor

new PerceptionSystem(configopt)

Parameters:
NameTypeAttributesDescription
configObject<optional>

Classes

PerceptionSystem

Methods

canHear(observer, target) → {boolean}

Checks if observer can hear target (within hearing/alert radius and emitting sound/alert).

Parameters:
NameTypeDescription
observerObject
targetObject
Returns:
Type: 
boolean

canSee(observer, target, obstaclesopt) → {boolean}

Checks if observer can see target (in range, in cone, and LOS unobstructed).

Parameters:
NameTypeAttributesDescription
observerObject
targetObject
obstaclesArray<optional>
Returns:
Type: 
boolean

hasLineOfSight(from, to, obstaclesopt) → {boolean}

Checks if line-of-sight from source to target is unobstructed by obstacles.

Parameters:
NameTypeAttributesDescription
fromObject
toObject
obstaclesArray<optional>
Returns:
Type: 
boolean

isAudibleCandidate(candidate) → {boolean}

Determines whether a candidate emits sound or alert signals.

Parameters:
NameTypeDescription
candidateObject
Returns:
Type: 
boolean

isInFov(observer, target) → {boolean}

Checks if target is within observer's field of view (FOV) cone.

Parameters:
NameTypeDescription
observerObject
targetObject
Returns:
Type: 
boolean

isInVisionRange(observer, target) → {boolean}

Checks if target is within observer's vision range.

Parameters:
NameTypeDescription
observerObject
targetObject
Returns:
Type: 
boolean

observe(observer, candidates, obstaclesopt, optionsopt) → {Array}

Filters candidate entities, returning visible and audible candidates.

Parameters:
NameTypeAttributesDescription
observerObject
candidatesArray
obstaclesArray<optional>
optionsObject<optional>
Returns:
Type: 
Array