findCover: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " {2,}\}\}" to " }}")
m (Some wiki formatting)
(22 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command
{{RV|type=command


| arma1
|game1= arma1
|version1= 1.00


|1.00
|game2= arma2
|version2= 1.00
 
|game3= arma2oa
|version3= 1.50
 
|game4= tkoh
|version4= 1.00
 
|game5= arma3
|version5= 0.50


|gr1= Broken Commands
|gr1= Broken Commands


| Returns the object around where the unit finds cover. The minDist, visibilityPosition and ignoreObject parameters are optional.<br><br>
|descr= Returns the object around where the unit finds cover. The minDist, visibilityPosition and ignoreObject parameters are optional.
{{Important | Not implemented in Arma 2 or Arma 3, always returns [[objNull]]}}
{{Feature|important|Not implemented in {{arma2}} and later titles (always returns [[objNull]]).}}


| object '''findCover''' [position, hidePosition, maxDist, minDist, visibilityPosition, ignoreObject]
|s1= object [[findCover]] [position, hidePosition, maxDist, minDist, visibilityPosition, ignoreObject]


|p1= object: [[Object]]
|p1= object: [[Object]]
|p2= [position, hidePosition, maxDist, minDist, visibilityPosition, ignoreObject]: [[Array]]
|p3= position: [[Array]] - format [[Position]] |=Paramater 3
|p4= hidePosition: [[Array]] - format [[getHideFrom]]. Position of that which the unit should hide from
|p5= maxDist: [[Number]]
|p6= minDist: [[Number]] (Optional)
|p7= visibilityPosition: [[Array]] - format [[Position]] (Optional) used to select cover that unit can see in that direction from
|p8= ignoreObject: [[Object]] (Optional) Ignore this object in visibility check
| [[Object]] - always [[objNull]]
|x1= -
| [[getHideFrom]], [[setHideBehind]], [[isHidden]]
}}


<dl class="command_description">
|p2= position: [[Array]] format [[Position]]
<!-- CONTINUE Notes -->
 
|p3= hidePosition: [[Array]] format [[Position#PositionATL]] - [[getHideFrom]]-like position from which the unit should hide
 
|p4= maxDist: [[Number]]
 
|p5= minDist: [[Number]] - (Optional)
 
|p6= visibilityPosition: [[Array]] format [[Position]] - (Optional) used to select cover that unit can see in that direction from
 
|p7= ignoreObject: [[Object]] (Optional) ignore this object in visibility check
 
|r1= [[Object]] - always [[objNull]]


<dd class="notedate">Posted on July 4, 2015 - 22:01 (UTC)
|x1= <sqf>unit1 findCover [ASLToATL aimPos unit2, 30];</sqf>
<dt class="note">[[User:SnowSky|SnowSky]]
<dd class="note">An alternative function in Arma 3 might be [[BIS_fnc_findSafePos]]


<!-- DISCONTINUE Notes -->
|seealso= [[getHideFrom]] [[setHideBehind]] [[isHidden]]
</dl>
}}


[[Category:Scripting Commands|FINDCOVER]]
{{Note
{{GameCategory|arma1|Scripting Commands}}
|user= SnowSky
{{GameCategory|arma2|Scripting Commands}}
|timestamp= 20150704220100
{{GameCategory|arma3|Scripting Commands}}
|text= An alternative function in Arma 3 might be [[BIS_fnc_findSafePos]].
{{GameCategory|tkoh|Scripting Commands}}
}}

Revision as of 18:00, 15 August 2022

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.