inAreaArray: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " \|r2=(.*)\|RETURNVALUE=" to " |r2=$1|RETURNVALUE2=")
mNo edit summary
Line 36: Line 36:
|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 |PARAMETER2=
|p22= marker: [[String]] - marker with given area |PARAMETER23=


|r2= [[Array]]: [[Object]]s and/or [[Position]]s inside the marker area|RETURNVALUE2=
|r2= [[Array]]: [[Object]]s and/or [[Position]]s inside the marker area|RETURNVALUE2=
Line 42: Line 42:
|s3=positions '''inAreaArray''' location |SYNTAX3=
|s3=positions '''inAreaArray''' location |SYNTAX3=


|p41= positions: [[Array]] - [[Object]]s and/or [[Position]]s to check|PARAMETER1=
|p31= positions: [[Array]] - [[Object]]s and/or [[Position]]s to check|PARAMETER32=


|p42= location: [[Location]] - location with given area |PARAMETER2=
|p32= location: [[Location]] - location with given area |PARAMETER32=


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


|s4= positions '''inAreaArray''' [center, a, b, angle, isRectangle, c]|SYNTAX=
|s4= positions '''inAreaArray''' [center, a, b, angle, isRectangle, c]|SYNTAX=
|p61= positions: [[Array]] - [[Object]]s and/or [[Position]]s to check|PARAMETER1=
|p41= positions: [[Array]] - [[Object]]s and/or [[Position]]s to check|PARAMETER41=
|p62= [center, a, b, angle, isRectangle, c]: [[Array]]|PARAMETER2=
|p42= [center, a, b, angle, isRectangle, c]: [[Array]]|PARAMETER42=
|p63= center: [[Array]] - center of the area in format [[Position3D]], [[Position2D]] |PARAMETER2=
|p43= center: [[Array]] - center of the area in format [[Position3D]], [[Position2D]] |PARAMETER43=
|p64= a: [[Number]] - x axis (x / 2) |PARAMETER2=
|p44= a: [[Number]] - x axis (x / 2) |PARAMETER44=
|p65= b: [[Number]] - y axis (y / 2) |PARAMETER2=
|p45= b: [[Number]] - y axis (y / 2) |PARAMETER45=
|p66= angle (Optional): [[Number]] - rotation angle. Default: 0  |PARAMETER2=
|p46= angle (Optional): [[Number]] - rotation angle. Default: 0  |PARAMETER46=
|p67= isRectangle (Optional): [[Boolean]] - [[true]] if rectangle, [[false]] if ellipse. Default: [[false]]|PARAMETER2=
|p47= isRectangle (Optional): [[Boolean]] - [[true]] if rectangle, [[false]] if ellipse. Default: [[false]]|PARAMETER47=
|p68= c (Optional): [[Number]] - z axis (z / 2). Default: -1 (unlimited)|PARAMETER2=
|p48= c (Optional): [[Number]] - z axis (z / 2). Default: -1 (unlimited)|PARAMETER48=
|r4= [[Array]]: [[Object]]s and/or [[Position]]s inside the area |RETURNVALUE=
|r4= [[Array]]: [[Object]]s and/or [[Position]]s inside the area |RETURNVALUE=
____________________________________________________________________________________________
____________________________________________________________________________________________
Line 63: Line 63:
|x2= <code>[[allUnits]] [[inAreaArray]] marker_1;</code> |EXAMPLE2=
|x2= <code>[[allUnits]] [[inAreaArray]] marker_1;</code> |EXAMPLE2=
|x3= <code>[[allPlayers]] [[inAreaArray]] location_1;</code> |EXAMPLE3=
|x3= <code>[[allPlayers]] [[inAreaArray]] location_1;</code> |EXAMPLE3=
|x4= <code>[[allDead]] [[inAreaArray]] [<nowiki/>[100, 100, 0], 20, 30, 45, [[false]], 10];</code>|=
|x4= <code>[[allDead]] [[inAreaArray]] [<nowiki/>[100, 100, 0], 20, 30, 45, [[false]], 10];</code>|EXAMPLE4=
____________________________________________________________________________________________
____________________________________________________________________________________________



Revision as of 21:31, 24 September 2020

Hover & click on the images for description

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

Syntax 1

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

Syntax 2

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

Syntax 3

Syntax:
positions inAreaArray location
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 location area

Syntax 4

Syntax:
positions inAreaArray [center, a, b, angle, isRectangle, c]
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

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 inAreaArray "mymarker" select {_x isKindOf "StaticWeapon"} Will return only the statics inside the given marker