findNearestEnemy: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
(Updated SEE ALSO)
 
(56 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma |= Game name
|game1= arma1
|version1= 1.00


|1.00|= Game version
|game2= arma2
____________________________________________________________________________________________
|version2= 1.00


| Find the nearest enemy to the specified position. Returns a null object if the object's group does not [[knowsAbout|know about]] any enemies. |= Description
|game3= arma2oa
____________________________________________________________________________________________
|version3= 1.50


| object '''findNearestEnemy''' position |= Syntax
|game4= tkoh
|version4= 1.00


|p1= object: [[Object]]|= Parameter 1
|game5= arma3
|version5= 0.50


|p2= position: [[Object]] or [[Array]]|= Parameter 2
|gr1= Object Detection


| [[Object]] |= Return value
|descr= Finds the nearest enemy to the specified position. Returns a null object if the object's group does not [[knowsAbout|know about]] any enemies. This command will return nearest object that is known to the unit and is considered enemy. An empty vehicle that is part of enemy group assets (see [[addVehicle]]) can be returned as valid nearest target.
____________________________________________________________________________________________


|x1= <code>_myNearestEnemy = ([[units]] _myGroup [[select]] 0) [[findNearestEnemy]] [[player]];</code> |= Example 1
|s1= object [[findNearestEnemy]] position


|x2= <code>_myNearestEnemy = [[player]] [[findNearestEnemy]] [[player]];</code> |= Example 2
|p1= object: [[Object]]
____________________________________________________________________________________________


| [[nearestBuilding]], [[nearestObject]], [[nearestObjects]], [[nearObjects]], [[nearestLocation]], [[nearEntities]], [[nearTargets]], [[nearSupplies]], [[nearestLocationWithDubbing]], [[nearObjectsReady]], [[nearRoads]] |= See also
|p2= position: [[Object]] or [[Array]] in format [[Position#PositionAGL|PositionAGL]] or [[Position#Introduction|Position2D]]


}}
|r1= [[Object]]


<h3 style="display:none">Notes</h3>
|x1= <sqf>_myNearestEnemy = (units _myGroup select 0) findNearestEnemy player;</sqf>
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|x2= <sqf>_myNearestEnemy = player findNearestEnemy player;</sqf>
</dl>


<h3 style="display:none">Bottom Section</h3>
|seealso= [[targets]] [[targetsQuery]] [[nearTargets]] [[targetsAggregate]] [[targetKnowledge]] [[knowsAbout]] [[reveal]] [[forgetTarget]] [[setTargetAge]] [[getHideFrom]] [[nearestBuilding]] [[nearestObject]] [[nearestObjects]] [[nearObjects]] [[nearestLocation]] [[nearEntities]] [[nearSupplies]] [[nearestLocationWithDubbing]] [[nearObjectsReady]] [[nearRoads]] [[nearestMines]]
[[Category:Scripting Commands|FINDNEARESTENEMY]]
}}
[[Category:Scripting Commands ArmA|FINDNEARESTENEMY]]
[[Category:Command_Group:_Object_Information|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on September 25, 2015 - 04:26 (UTC)</dd>
<dt class="note">[[User:Pierre MGI|Pierre MGI]]</dt>
<dd class="note">
The bad point of this command is a lack of parameter to define priority/pound on enemy "value".
I often use this command in a "on each frame" HUD, while in group assault or alone. My experience is nearest enemy (NE) is often car or tank even if multiple enemy units are closer. More than that, if you shoot this vehicle and its crew disembark, it remains the "nearsest enemy". It's weird for an empty vehicle. Kill the crew, it's still NE. For sure, the situation could change, but you have time to kill the crew and jump into the vehicle, or destroy it!
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 12:43, 7 September 2022

Hover & click on the images for description

Description

Description:
Finds the nearest enemy to the specified position. Returns a null object if the object's group does not know about any enemies. This command will return nearest object that is known to the unit and is considered enemy. An empty vehicle that is part of enemy group assets (see addVehicle) can be returned as valid nearest target.
Groups:
Object Detection

Syntax

Syntax:
object findNearestEnemy position
Parameters:
object: Object
position: Object or Array in format PositionAGL or Position2D
Return Value:
Object

Examples

Example 1:
_myNearestEnemy = (units _myGroup select 0) findNearestEnemy player;
Example 2:
_myNearestEnemy = player findNearestEnemy player;

Additional Information

See also:
targets targetsQuery nearTargets targetsAggregate targetKnowledge knowsAbout reveal forgetTarget setTargetAge getHideFrom 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