nearTargets: Difference between revisions
Jump to navigation
Jump to search
m (see also & example formating) |
Lou Montana (talk | contribs) m (Some wiki formatting) |
||
(60 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
{{ | {{RV|type=command | ||
| | |game1= arma1 | ||
|version1= 1.07 | |||
|1. | |game2= arma2 | ||
|version2= 1.00 | |||
| | |game3= arma2oa | ||
|version3= 1.50 | |||
| | |game4= tkoh | ||
|version4= 1.00 | |||
| | |game5= arma3 | ||
| | |version5= 0.50 | ||
| | |gr1= Object Detection | ||
|descr= Returns a list of targets within the defined range. "Targets" are not restricted to enemy units. | |||
|s1= unit [[nearTargets]] range | |||
| | |||
| [[ | |p1= unit: [[Object]] | ||
|p2= range: [[Number]] | |||
|r1= [[Array]] of [[Array]]s in format [position, type, side, subjectiveCost, object, positionAccuracy]: | |||
* position: [[Array]] format [[Position#Position3D|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 | |||
< | |x1= <sqf> | ||
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] | |||
] | |||
*/ | |||
</sqf> | |||
|seealso= [[targets]] [[targetsQuery]] [[targetsAggregate]] [[targetKnowledge]] [[knowsAbout]] [[reveal]] [[forgetTarget]] [[setTargetAge]] [[getHideFrom]] [[findNearestEnemy]] [[nearestBuilding]] [[nearestObject]] [[nearestObjects]] [[nearObjects]] [[nearestLocation]] [[nearEntities]] [[nearSupplies]] [[nearestLocationWithDubbing]] [[nearObjectsReady]] [[nearRoads]] [[nearestMines]] | |||
}} | |||
{{Note | |||
|user= mrcurry | |||
|timestamp= 20110217160000 | |||
|text= A subjective cost greater than 0 does not necessarily mean the target is an enemy unit. <b>Any</b> unit, that have yet to be identified by the unit, have a small positive cost in the range 0 to 1. | |||
}} | |||
The | {{Note | ||
|user= .kju | |||
|timestamp= 20120115174500 | |||
|text= The quality/detail level of the info depends on the [[knowsAbout]] value of the sourceUnit about the targetUnit: | |||
For | * 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: | 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 | |||
}} | |||
{{Note | |||
</ | |user= .kju | ||
|timestamp= 20120117161400 | |||
|text= <nowiki/> | |||
* 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. | |||
}} | |||
{{Note | |||
|user= .kju | |||
|timestamp= 20120121200000 | |||
|text= Position accuracy seems to be a radius in meters from the perceived position. | |||
}} | |||
Latest revision as of 12:50, 12 March 2024
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
- 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.
- 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
- 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
- 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
- For infantry:
- 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.
- Posted on Jan 21, 2012 - 20:00 (UTC)
- Position accuracy seems to be a radius in meters from the perceived position.
Categories:
- Scripting Commands
- Introduced with Armed Assault version 1.07
- ArmA: Armed Assault: New Scripting Commands
- ArmA: Armed Assault: Scripting Commands
- Arma 2: Scripting Commands
- Arma 2: Operation Arrowhead: Scripting Commands
- Take On Helicopters: Scripting Commands
- Arma 3: Scripting Commands
- Command Group: Object Detection