Difference between revisions of "inAreaArray"

From Bohemia Interactive Community
Jump to navigation Jump to search
m (template:command argument fix)
m (template:command argument fix)
Line 4: Line 4:
 
| arma3 |= Game
 
| arma3 |= Game
  
|1.66|= Game Version (number surrounded by NO SPACES)
+
|1.66|Game Version= (number surrounded by NO SPACES)
  
|arg=  |= Multiplayer Arguments ("local" or "global")
+
|arg=  |Multiplayer Arguments= ("local" or "global")
  
|eff=  |= Multiplayer Effects ("local" or "global")
+
|eff=  |Multiplayer Effects= ("local" or "global")
  
 
|exec=  |= Multiplayer Execution ("server" or empty)
 
|exec=  |= Multiplayer Execution ("server" or empty)
Line 58: Line 58:
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
  
|mp= - |= Multiplayer Behaviour
+
|mp= - |Multiplayer Behaviour=
  
 
| [[inArea]], [[triggerArea]] |SEEALSO=
 
| [[inArea]], [[triggerArea]] |SEEALSO=

Revision as of 12:09, 5 August 2019

Introduced with Arma 3 version 1.661.66
Hover & click on the images for descriptions

Description

Description:
Filters given list of Objects and/or Positions in relation to the given area, defined by a trigger, marker, location or array. Returns array of Objects and/or Positions from the list that are inside the area
Multiplayer:
-

Syntax

Syntax:
positions inAreaArray trigger
Parameters:
positions: Array - Objects and/or Positions to check
trigger: Object - trigger with given area
Return Value:
Array: Objects and/or Positions inside the trigger area

Alternative Syntax

Syntax:
positions inAreaArray marker
Parameters:
positions: Array - Objects and/or Positions to check
marker: String - marker with given area
Return Value:
Array: Objects and/or Positions inside the marker area

Alternative Syntax 2

Syntax:
positions inAreaArray location
Parameters:
positions: Array - Objects and/or Positions to check
location: Location - location with given area
Return Value:
Array: Objects and/or Positions inside the location area

Alternative Syntax 3

Syntax:
positions inAreaArray [center, a, b, angle, isRectangle, c]
Parameters:
positions: Array - Objects and/or Positions to check
[center, a, b, angle, isRectangle, c]: Array
center: Array - center of the area in format Position3D, Position2D
a: Number - x axis (x / 2)
b: Number - y axis (y / 2)
angle (Optional): Number - rotation angle. Default: 0
isRectangle (Optional): Boolean - true if rectangle, false if ellipse. Default: false
c (Optional): Number - z axis (z / 2). Default: -1 (unlimited)
Return Value:
Array: Objects and/or Positions inside the area

Examples

Example 1:
vehicles inAreaArray trigger_1;
Example 2:
allUnits inAreaArray marker_1;
Example 3:
allPlayers inAreaArray location_1;
Example 4:
allDead inAreaArray [[100, 100, 0], 20, 30, 45, false, 10];

Additional Information

See also:
inAreatriggerArea
Groups:
Uncategorised

Notes

i
Only post proven facts here. Report bugs on the Feedback Tracker and discuss on the Arma Discord or on the Forums.

Bottom Section

Posted on June 11, 2017 - 21:33 (UTC)
Tankbuster
The array you send the command can be filtered. For example: vehicles inAreaArray "mymarker" select {_x isKindOf "StaticWeapon"} Will return only the statics inside the given marker