nearTargets

1.071.001.501.000.50

Hover & click on the images for description

Description

Description:

Returns a list of targets within the defined range. "Targets" are not restricted to enemy units.

Groups:

Object Detection

Syntax

Syntax:

unit nearTargets range

Parameters:

unit: Object

range: Number

Return Value:

Array of Arrays in format [position, type, side, subjectiveCost, object, positionAccuracy]:

• position: Array format Position3D - perceived position including judgment and memory errors
• type: String - perceived, gives only what was recognized
• side: Side - perceived side
• subjectiveCost: Number - positive for enemies, more positive for more important or more dangerous enemies
• object: Object object type, can be used to get more information if needed
• positionAccuracy: Number - assumed accuracy of the perceived position

Examples

Example 1:

player nearTargets 100; // can return e.g /* [ [[2555.33,2535.33,1.32708],"SoldierEB",EAST,214222,EAST 1-1-A:1], [[2550.39,2482.5,1.32696],"SoldierWB",WEST,0,WEST 1-1-A:2] ] */

Additional Information

See also:

targets targetsQuery targetsAggregate targetKnowledge knowsAbout reveal forgetTarget setTargetAge getHideFrom findNearestEnemy nearestBuilding nearestObject nearestObjects nearObjects nearestLocation nearEntities nearSupplies nearestLocationWithDubbing nearObjectsReady nearRoads nearestMines

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

mrcurry - c

Posted on Feb 17, 2011 - 16:00 (UTC)

A subjective cost greater than 0 does not necessarily mean the target is an enemy unit. Any unit, that have yet to be identified by the unit, have a small positive cost in the range 0 to 1.

.kju - c

Posted on Jan 15, 2012 - 17:45 (UTC)

The quality/detail level of the info depends on the knowsAbout value of the sourceUnit about the targetUnit:

• For infantry:
  • ] 0 , 1.5 [ - side unknown, some position offset, identified as SoldierWB
  • [ 1.5, 1.6 [ - side identified, subjective cost set
  • [ 1.6, 2 [ - type identified better (USMC_Soldier_Base)
  • [ 2 , 3.6 [ - type identified precisely (USMC_Soldier)
  • [ 3.6, 4 ] - position identified precisely

The values seems closely linked to the accuracy value of the given targetUnit class and its parents up in the config tree:

• 0 class CAManBase: Man
• 1.6 class SoldierWB: CAManBase
• 2 class USMC_Soldier_Base: SoldierWB
• 3.9 class USMC_Soldier: USMC_Soldier_Base

• For tanks:
  • ] 0 , 0.03 [ - side unknown, some position offset, identified as LandVehicle
  • [ 0.03, 0.13 [ - type identified better (Tank)
  • [ 0.13, 0.3 [ - type identified better (M1A1)
  • [ 0.3 , 1.5 [ - side identified, subjective cost set
  • [ 1.5 , 3.6 [ - side identified precisely (CIV), subjective cost adjusted
  • [ 3.6 , 4 ] - position identified precisely

The values seems closely linked to the accuracy value of the given targetUnit class and its parents up in the config tree:

• 0 class All
• class AllVehicles: All
  • 0.0005 class Land: AllVehicles
  • 0.02 class LandVehicle: Land
  • 0.12 class Tank: LandVehicle
  • 0.25 class M1A1: Tank

.kju - c

Posted on Jan 17, 2012 - 16:14 (UTC)

• When an unit dies, it is nearTargets array gets emptied after some seconds.
• When an unit dies, its reference will get removed from other units nearTargets' arrays immediately.
• A target will be removed from the array after about 360 seconds without contact.

.kju - c

Posted on Jan 21, 2012 - 20:00 (UTC)

Position accuracy seems to be a radius in meters from the perceived position.