inAreaArray: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (formatted parameters)
m (Text replacement - "<dl class="command_description"> <dd class="notedate">" to "<dl class="command_description"> <dt></dt> <dd class="notedate">")
(39 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Command|=
{{RV|type=command
____________________________________________________________________________________________


| arma3dev |= Game
| arma3


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


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


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


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


| Filters given [[Array]] of [[Object]]s or [[Position]]s by given trigger area. |= Description
|gr1= Triggers
____________________________________________________________________________________________


|[input] '''inAreaArray''' trigger |= Syntax
|gr2= Markers


|p1= input:  [[Array]] of  [[Object]]s or [[Position]]s|= Parameter 1
|gr3= Locations


|p2= trigger: Trigger  |= Parameter 2
|gr4= Positions


| 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.


| [[Array]]: Array with objects or positions inside the trigger area |= Return Value
| positions '''inAreaArray''' area


|p1= positions: [[Array]] of [[Object]]s and/or [[Position]]s


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


|x1= [ [[vehicles]] ] '''inAreaArray''' trigger_1  |= Example 1
| [[Array]]: [[Object]]s and/or [[Position]]s inside the trigger area
____________________________________________________________________________________________


|mp= - |= Multiplayer Behaviour
|s2= positions '''inAreaArray''' [center, a, b, angle, isRectangle, c]


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


|p22= center: [[Array]] - center of the area in format [[Position3D]], [[Position2D]]
|p23= a: [[Number]] - x axis (x / 2)
|p24= b: [[Number]] - y axis (y / 2)
|p25= angle: [[Number]] - (Optional, default 0) rotation angle
|p26= isRectangle: [[Boolean]] - (Optional, default [[false]]) [[true]] if rectangle, [[false]] if ellipse
|p27= c: [[Number]] - (Optional, default -1: unlimited) z axis (z / 2)
|r2= [[Array]]: [[Object]]s and/or [[Position]]s inside the area
|x1= <code>[[vehicles]] [[inAreaArray]] myTrigger;</code>
|x2= <code>[[allUnits]] [[inAreaArray]] "myMarker";</code>
|x3= <code>[[allPlayers]] [[inAreaArray]] myLocation;</code>
|x4= <code>[[allDead]] [[inAreaArray]] [<nowiki/>[100, 100, 0], 20, 30, 45, [[false]], 10];</code>
|seealso= [[inArea]], [[triggerArea]]
}}
}}


<dl class="command_description">
<dl class="command_description">
<!-- BEGIN Note Section -->
<dt></dt>
<!-- For example:
<dd class="notedate">Posted on June 11, 2017 - 21:33 (UTC)</dd>
<dd class="notedate">Posted on Month Day, Year - Time (UTC)</dd>
<dt class="note">[[User:Tankbuster|Tankbuster]]</dt>
<dt class="note">'''[[User:User Name|User Name]]'''</dt>
<dd class="note">
<dd class="note">This is an example note. It is true and verifiable, and contains a little code snippet.
The array you send the command can be filtered. For example:
<code>[[if]] ([[_this]] == anExample) [[then]] { [[hint]] "Leave it here for others to read"; };</code></dd>
<code>[[vehicles]] [[select]] { _x [[isKindOf]] "StaticWeapon" } [[inAreaArray]] "myMarker"</code>
-->
Will return only the statics inside the given marker
<!-- END Note Section -->
</dd>
</dl>
</dl>
<h3 style="display:none">Bottom Section</h3>
<!-- Appropriate categories go here -->
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Revision as of 14:26, 5 April 2021

Game1 needed - Version1 needed
Hover & click on the images for description

Description

Description:
This article is a Stub. You can help BI Community Wiki by expanding it.
Description needed
Groups:
TriggersMarkersLocationsPositions

Syntax

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

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


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=252211"