inAreaArray: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|Multiplayer Effects= ("local" or "global")" to "|Multiplayer Effects ("local" or "global")=")
(Merge syntaxes)
Line 21: Line 21:
____________________________________________________________________________________________
____________________________________________________________________________________________


| 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=
| 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. |DESCRIPTION=
____________________________________________________________________________________________
____________________________________________________________________________________________


|positions '''inAreaArray''' trigger |SYNTAX=
| positions '''inAreaArray''' area |SYNTAX=


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


|p2= trigger: [[Object]] - trigger with given area |PARAMETER2=
|p2= area: [[Object]], [[Location]] or [[String]] - the defined area:
* [[Object]] - trigger
* [[Location]] - location
* [[String]] - marker name |PARAMETER2=


| [[Array]]: [[Object]]s and/or [[Position]]s inside the trigger area|RETURNVALUE=
| [[Array]]: [[Object]]s and/or [[Position]]s inside the trigger area |RETURNVALUE=


|s2=positions '''inAreaArray''' marker |SYNTAX2=
|s2= positions '''inAreaArray''' [center, a, b, angle, isRectangle, c] |SYNTAX2=


|p21= positions: [[Array]] - [[Object]]s and/or [[Position]]s to check|PARAMETER21=
|p21= positions: [[Array]] - [[Object]]s and/or [[Position]]s to check |PARAMETER21=


|p22= marker: [[String]] - marker with given area |PARAMETER22=
|p22= center: [[Array]] - center of the area in format [[Position3D]], [[Position2D]] |PARAMETER22=


|r2= [[Array]]: [[Object]]s and/or [[Position]]s inside the marker area|RETURNVALUE2=
|p23= a: [[Number]] - x axis (x / 2) |PARAMETER23=


|s3=positions '''inAreaArray''' location |SYNTAX3=
|p24= b: [[Number]] - y axis (y / 2) |PARAMETER24=


|p31= positions: [[Array]] - [[Object]]s and/or [[Position]]s to check|PARAMETER31=
|p25= angle: [[Number]] - (Optional, default 0) rotation angle |PARAMETER25=


|p32= location: [[Location]] - location with given area |PARAMETER32=
|p26= isRectangle: [[Boolean]] - (Optional, default [[false]]) [[true]] if rectangle, [[false]] if ellipse |PARAMETER26=


|r3= [[Array]]: [[Object]]s and/or [[Position]]s inside the location area|RETURNVALUE3=
|p27= c: [[Number]] - (Optional, default -1: unlimited) z axis (z / 2) |PARAMETER27=


|s4= positions '''inAreaArray''' [center, a, b, angle, isRectangle, c]|SYNTAX4=
|r2= [[Array]]: [[Object]]s and/or [[Position]]s inside the area |RETURNVALUE2=
 
|p41= positions: [[Array]] - [[Object]]s and/or [[Position]]s to check|PARAMETER41=
 
|p42= [center, a, b, angle, isRectangle, c]: [[Array]]|PARAMETER42=
 
|p43= center: [[Array]] - center of the area in format [[Position3D]], [[Position2D]] |PARAMETER43=
 
|p44= a: [[Number]] - x axis (x / 2) |PARAMETER44=
 
|p45= b: [[Number]] - y axis (y / 2) |PARAMETER45=
 
|p46= angle (Optional): [[Number]] - rotation angle. Default: 0  |PARAMETER46=
 
|p47= isRectangle (Optional): [[Boolean]] - [[true]] if rectangle, [[false]] if ellipse. Default: [[false]]|PARAMETER47=
 
|p48= c (Optional): [[Number]] - z axis (z / 2). Default: -1 (unlimited)|PARAMETER48=
 
|r4= [[Array]]: [[Object]]s and/or [[Position]]s inside the area |RETURNVALUE4=
____________________________________________________________________________________________
____________________________________________________________________________________________


|x1= <code>[[vehicles]] [[inAreaArray]] trigger_1;</code> |EXAMPLE1=
|x1= <code>[[vehicles]] [[inAreaArray]] myTrigger;</code> |EXAMPLE1=


|x2= <code>[[allUnits]] [[inAreaArray]] marker_1;</code> |EXAMPLE2=
|x2= <code>[[allUnits]] [[inAreaArray]] "myMarker";</code> |EXAMPLE2=


|x3= <code>[[allPlayers]] [[inAreaArray]] location_1;</code> |EXAMPLE3=
|x3= <code>[[allPlayers]] [[inAreaArray]] myLocation;</code> |EXAMPLE3=


|x4= <code>[[allDead]] [[inAreaArray]] [<nowiki/>[100, 100, 0], 20, 30, 45, [[false]], 10];</code>|EXAMPLE4=
|x4= <code>[[allDead]] [[inAreaArray]] [<nowiki/>[100, 100, 0], 20, 30, 45, [[false]], 10];</code>|EXAMPLE4=
Line 79: Line 64:


| [[inArea]], [[triggerArea]] |SEEALSO=
| [[inArea]], [[triggerArea]] |SEEALSO=
}}
}}


Line 88: Line 72:


<h3 style="display:none">Bottom Section</h3>
<h3 style="display:none">Bottom Section</h3>
<!-- Appropriate categories go here -->
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]


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

Revision as of 01:01, 23 December 2020

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.
Groups:
TriggersMarkersLocationsPositions

Syntax

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

Alternative Syntax

Syntax:
positions inAreaArray [center, a, b, angle, isRectangle, c]
Parameters:
positions: Array - Objects and/or Positions to check
center: Array - center of the area in format Position3D, Position2D
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)
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:
inAreatriggerArea

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

Bottom Section

Posted on June 11, 2017 - 21:33 (UTC)
Tankbuster
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=170778"