inAreaArray: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " <nowiki>[</nowiki>" to " [<nowiki/>")
No edit summary
 
(53 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma3 |Game=
|game1= arma3
|version1= 1.66


|1.66|Game Version= (number surrounded by NO SPACES)
|gr1= Triggers


|arg= |Multiplayer Arguments= ("local" or "global")
|gr2= Markers


|eff= |Multiplayer Effects= ("local" or "global")
|gr3= Locations


|serverExec= |= Multiplayer Execution ("server" or empty)
|gr4= Positions
____________________________________________________________________________________________


| Filters given list of [[Object]]s and/or [[Position]]s in relation to the given area, defined by a trigger, marker, location or array. Returns array of [[Object]]s and/or [[Position]]s from the list that are inside the area |DESCRIPTION=
|descr= Returns given list of [[Object]]s and/or [[Position]]s that are in the given area, area defined by a trigger, marker, location or array.
____________________________________________________________________________________________


|positions '''inAreaArray''' trigger |SYNTAX=
{{Feature|important| By default all positions given as [[Array]] or as objects are treated as [[PositionAGL]]. Since {{GVI|arma3|2.20|size= 0.75}} there is an option to force them to [[PositionWorld]] format.}}


|p1= positions: [[Array]] - [[Object]]s and/or [[Position]]s to check|PARAMETER1=
|s1= positions [[inAreaArray]] area


|p2= trigger: [[Object]] - trigger with given area |PARAMETER2=
|p1= positions: [[Array]] of [[Object]]s and/or [[Position]]s


| [[Array]]: [[Object]]s and/or [[Position]]s inside the trigger area|RETURNVALUE=
|p2= area: [[Object]], [[Location]] or [[String]] - the defined area:
* [[Object]] - trigger
* [[Location]] - location
* [[String]] - marker name


|s2=positions '''inAreaArray''' marker |SYNTAX2=
|r1= [[Array]]: [[Object]]s and/or [[Position]]s inside the trigger area


|p21= positions: [[Array]] - [[Object]]s and/or [[Position]]s to check|PARAMETER21=
|s2= positions [[inAreaArray]] [centre, a, b, angle, isRectangle, c, usePosWorld]


|p22= marker: [[String]] - marker with given area |PARAMETER2=
|p21= positions: [[Array]] - [[Object]]s and/or [[Position]]s to check. [[Position]]s must be [[Position#PositionAGL|PositionAGL]] if area is checked in 3D (see note in description)


|r2= [[Array]]: [[Object]]s and/or [[Position]]s inside the marker area|RETURNVALUE=
|p22= centre: [[Array]] format [[Position#Introduction|Position2D]] or [[Position#PositionAGL|PositionAGL]], {{GVI|arma3|2.14|size= 0.75}} [[Object]] or [[Group]]


|s3=positions '''inAreaArray''' location |SYNTAX3=
|p23= a: [[Number]] - x axis (x / 2)


|p41= positions: [[Array]] - [[Object]]s and/or [[Position]]s to check|PARAMETER1=
|p24= b: [[Number]] - y axis (y / 2)


|p42= location: [[Location]] - location with given area |PARAMETER2=
|p25= angle: [[Number]] - (Optional, default 0) rotation angle


|r3= [[Array]]: [[Object]]s and/or [[Position]]s inside the location area|RETURNVALUE=
|p26= isRectangle: [[Boolean]] - (Optional, default [[false]]) [[true]] if rectangle, [[false]] if ellipse


|s4= positions '''inAreaArray''' [center, a, b, angle, isRectangle, c]|SYNTAX=
|p27= c: [[Number]] - (Optional, default -1: unlimited) z axis (z / 2)
|p61= positions: [[Array]] - [[Object]]s and/or [[Position]]s to check|PARAMETER1=
|p62= [center, a, b, angle, isRectangle, c]: [[Array]]|PARAMETER2=
|p63= center: [[Array]] - center of the area in format [[Position3D]], [[Position2D]] |PARAMETER2=
|p64= a: [[Number]] - x axis (x / 2) |PARAMETER2=
|p65= b: [[Number]] - y axis (y / 2) |PARAMETER2=
|p66= angle (Optional): [[Number]] - rotation angle. Default: 0  |PARAMETER2=
|p67= isRectangle (Optional): [[Boolean]] - [[true]] if rectangle, [[false]] if ellipse. Default: [[false]]|PARAMETER2=
|p68= c (Optional): [[Number]] - z axis (z / 2). Default: -1 (unlimited)|PARAMETER2=
|r4= [[Array]]: [[Object]]s and/or [[Position]]s inside the area |RETURNVALUE=
____________________________________________________________________________________________


|x1= <code>[[vehicles]] [[inAreaArray]] trigger_1;</code> |EXAMPLE1=
|p28= usePosWorld: [[Boolean]] - (Optional, default [[false]]) set to [[true]] to treat all positions as [[PositionWorld]]
|x2= <code>[[allUnits]] [[inAreaArray]] marker_1;</code> |EXAMPLE2=
|p28since= Arma3 2.20
|x3= <code>[[allPlayers]] [[inAreaArray]] location_1;</code> |EXAMPLE3=
|x4= <code>[[allDead]] [[inAreaArray]] [<nowiki/>[100, 100, 0], 20, 30, 45, [[false]], 10];</code>|=
____________________________________________________________________________________________


|mp= - |Multiplayer Behaviour=
|r2= [[Array]]: [[Object]]s and/or [[Position]]s inside the area


| [[inArea]], [[triggerArea]] |SEEALSO=
|s3= positions [[inAreaArray]] [pos1, pos2, pos3,...]
|s3since= Arma3 2.20
|p41= positions: [[Array]] - [[Object]]s and/or [[Position]]s to check.
|p42 = posN: [[Position]] - polygon vertices in 2d or 3d format (see [[inPolygon]])
|r3= [[Array]]: [[Object]]s and/or [[Position]]s inside the area


}}
|x1= <sqf>vehicles inAreaArray myTrigger;</sqf>
 
|x2= <sqf>allUnits inAreaArray "myMarker";</sqf>


<dl class="command_description">
|x3= <sqf>allPlayers inAreaArray myLocation;</sqf>
<!-- BEGIN Note Section -->
<!-- END Note Section -->
</dl>


<h3 style="display:none">Bottom Section</h3>
|x4= <sqf>allDead inAreaArray [[100, 100, 0], 20, 30, 45, false, 10];</sqf>
<!-- Appropriate categories go here -->


[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
|seealso= [[inAreaArrayIndexes]] [[inArea]] [[triggerArea]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
}}


<!-- CONTINUE Notes -->
{{Note
<dl class="command_description">
|user= Tankbuster
<dd class="notedate">Posted on June 11, 2017 - 21:33 (UTC)</dd>
|timestamp= 20170611213300
<dt class="note">[[User:Tankbuster|Tankbuster]]</dt>
|text= The array you send the command can be filtered. For example:
<dd class="note">
<sqf>vehicles select { _x isKindOf "StaticWeapon" } inAreaArray "myMarker"</sqf>
The array you send the command can be filtered. For example:
Will return only the statics inside the given marker.
<code>[[vehicles]] [[inAreaArray]] "mymarker" [[select]] {_x [[isKindOf]] "StaticWeapon"}</code>
}}
Will return only the statics inside the given marker
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 22:37, 1 November 2024

Arma 3 logo black.png1.66
Hover & click on the images for description

Description

Description:
Returns given list of Objects and/or Positions that are in the given area, area defined by a trigger, marker, location or array.
⚠
By default all positions given as Array or as objects are treated as PositionAGL. Since Arma 3 logo black.png2.20 there is an option to force them to PositionWorld format.
Groups:
TriggersMarkersLocationsPositions

Syntax 1

Syntax:
positions inAreaArray area
Parameters:
positions: Array of Objects and/or Positions
area: Object, Location or String - the defined area:
Return Value:
Array: Objects and/or Positions inside the trigger area

Syntax 2

Syntax:
positions inAreaArray [centre, a, b, angle, isRectangle, c, usePosWorld]
Parameters:
positions: Array - Objects and/or Positions to check. Positions must be PositionAGL if area is checked in 3D (see note in description)
centre: Array format Position2D or PositionAGL, Arma 3 logo black.png2.14 Object or Group
a: Number - x axis (x / 2)
b: Number - y axis (y / 2)
angle: Number - (Optional, default 0) rotation angle
isRectangle: Boolean - (Optional, default false) true if rectangle, false if ellipse
c: Number - (Optional, default -1: unlimited) z axis (z / 2)
since Arma 3 logo black.png2.20
usePosWorld: Boolean - (Optional, default false) set to true to treat all positions as PositionWorld
Return Value:
Array: Objects and/or Positions inside the area

Syntax 3

Syntax:
positions inAreaArray [pos1, pos2, pos3,...]
Parameters:
positions: Array - Objects and/or Positions to check.
posN: Position - polygon vertices in 2d or 3d format (see inPolygon)
Return Value:
Array: Objects and/or Positions inside the area

Examples

Example 1:
vehicles inAreaArray myTrigger;
Example 2:
allUnits inAreaArray "myMarker";
Example 3:
allPlayers inAreaArray myLocation;
Example 4:
allDead inAreaArray [[100, 100, 0], 20, 30, 45, false, 10];

Additional Information

See also:
inAreaArrayIndexes inArea triggerArea

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
Tankbuster - c
Posted on Jun 11, 2017 - 21:33 (UTC)
The array you send the command can be filtered. For example:
vehicles select { _x isKindOf "StaticWeapon" } inAreaArray "myMarker"
Will return only the statics inside the given marker.
Retrieved from "https://community.bistudio.com/wiki?title=inAreaArray&oldid=370139"