findCover: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(59 intermediate revisions by 9 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


| Returns the object around where the unit finds cover. The minDist, visibilityPosition and ignoreObject parameters are optional. Command is not functional in ArmA 2. |= Description
|game3= arma2oa
____________________________________________________________________________________________
|version3= 1.50


| [[Object]] <nowiki>=</nowiki> object '''findCover''' [position, hidePosition, maxDist, minDist, visibilityPosition, ignoreObject] |= Syntax
|game4= tkoh
|version4= 1.00


|p1= object: [[Object]] |= Parameter 1
|game5= arma3
|p2= [position, hidePosition, maxDist, minDist, visibilityPosition, ignoreObject]: [[Array]] |= Parameter 2
|version5= 0.50
|p3= position: [[Array]] - format [[Position]] |=Paramater 3
|p4= hidePosition: [[Array]] - format [[Position]] Position of that which the unit should hide from|= Parameter 4
|p5= maxDist: [[Number]] |= Parameter 5
|p6= minDist: [[Number]] (Optional)|= Parameter 6
|p7= visibilityPosition: [[Array]] - format [[Position]] (Optional) used to select cover that unit can see in that direction from|= Parameter 7
|p8= ignoreObject: [[Object]] (Optional) Ignore this object in visibility check|= Parameter 8
| [[Object]] |= Return value
____________________________________________________________________________________________
|x1= <pre>temp = _hider findCover [getPos _hider, getPos player,50] </pre> |= Example 1
____________________________________________________________________________________________
|  |= See also


}}
|gr1= Broken Commands
 
|descr= Returns the object around where the unit finds cover. The minDist, visibilityPosition and ignoreObject parameters are optional.
{{Feature|important|Not implemented in {{arma2}} and later titles (always returns [[objNull]]).}}
 
|s1= object [[findCover]] [position, hidePosition, maxDist, minDist, visibilityPosition, ignoreObject]
 
|p1= object: [[Object]]
 
|p2= position: [[Array]] format [[Position]]
 
|p3= hidePosition: [[Array]] format [[Position#PositionATL]] - [[getHideFrom]]-like position from which the unit should hide
 
|p4= maxDist: [[Number]]


<h3 style="display:none">Notes</h3>
|p5= minDist: [[Number]] - (Optional)
<dl class="command_description">
<!-- Note Section BEGIN -->


<dd class="notedate">Posted on 17 Oct, 2009</dd>
|p6= visibilityPosition: [[Array]] format [[Position]] - (Optional) used to select cover that unit can see in that direction from
<dt class="note">'''[[User:Dr_Eyeball|Dr_Eyeball]]'''</dt><dd class="note">
Arma 2: v1.04: Usage creates report log message: "''MicroAI: Command findCover not implemented (<unit id>)''"<br>
</dd>


<dd class="notedate">Posted on 07 Jan, 2011</dd>
|p7= ignoreObject: [[Object]] - (Optional) ignore this object in visibility check
<dt class="note">'''[[User:kju|kju]]'''</dt><dd class="note">
OA: v1.57: Still non functional.
</dd>


<dd class="notedate">Posted on 12 July, 2011</dd>
|r1= [[Object]] - always [[objNull]]
<dt class="note">'''[[User:Demonized|Demonized]]'''</dt><dd class="note">
CO: v1.59: Still non functional.
</dd>


<!-- Note Section END -->
|x1= <sqf>unit1 findCover [ASLToATL aimPos unit2, 30];</sqf>
</dl>


<h3 style="display:none">Bottom Section</h3>
|seealso= [[getHideFrom]] [[setHideBehind]] [[isHidden]]
[[Category:Scripting Commands|FINDCOVER]]
}}
[[Category:Scripting Commands ArmA|FINDCOVER]]
 
[[Category:Command_Group:_Unit_Control|{{uc:{{PAGENAME}}}}]]
{{Note
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
|user= SnowSky
[[Category:Scripting Commands VBS2|{{uc:{{PAGENAME}}}}]]
|timestamp= 20150704220100
|text= An alternative function in Arma 3 might be [[BIS_fnc_findSafePos]].
}}

Latest revision as of 21:21, 28 September 2023

Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
Hover & click on the images for description

Description

Description:
Returns the object around where the unit finds cover. The minDist, visibilityPosition and ignoreObject parameters are optional.
⚠
Not implemented in Arma 2 and later titles (always returns objNull).
Groups:
Broken Commands

Syntax

Syntax:
object findCover [position, hidePosition, maxDist, minDist, visibilityPosition, ignoreObject]
Parameters:
object: Object
position: Array format Position
hidePosition: Array format Position#PositionATL - getHideFrom-like position from which the unit should hide
maxDist: Number
minDist: Number - (Optional)
visibilityPosition: Array format Position - (Optional) used to select cover that unit can see in that direction from
ignoreObject: Object - (Optional) ignore this object in visibility check
Return Value:
Object - always objNull

Examples

Example 1:
unit1 findCover [ASLToATL aimPos unit2, 30];

Additional Information

See also:
getHideFrom setHideBehind isHidden

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
SnowSky - c
Posted on Jul 04, 2015 - 22:01 (UTC)
An alternative function in Arma 3 might be BIS_fnc_findSafePos.
Retrieved from "https://community.bistudio.com/wiki?title=findCover&oldid=347600"