triggerArea: Difference between revisions

Latest revision as of 10:03, 2 January 2026

1.00

Hover & click on the images for description

Description

Description:: Returns currently monitored trigger area. Since Arma 3 v1.60, the command returns 3rd dimension for the monitored area. If height is not set, the value for it would be -1.
⚠
The trigger could be local or remote but the result returned by this command will be for the trigger area set up locally on the client that executed the command. See createTrigger for more info.
Groups:: Triggers

Syntax

Syntax:

triggerArea trigger

Parameters:

trigger: Object

Return Value:

Array with [a, b, angle, isRectangle, c]

a: Number - trigger area X size / 2
b: Number - trigger area Y size / 2
angle: Number in range 0..360
isRectangle: Boolean
c: Number - trigger area Z size / 2 (since Arma 3 v1.60)

Examples

Example 1:: _area = triggerArea sensor1; // result is [200, 120, 45, false, -1];

Additional Information

See also:: setTriggerArea inArea inAreaArray

Notes

: Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord.
Only post proven facts here! Add Note

@@ Line 1: / Line 1: @@
-{{Command|= Comments
+{{RV|type=command
-____________________________________________________________________________________________
-| arma2 |= Game name
+|game1= arma2
+|version1= 1.00
-|1.00|Game version=
+|game2= arma2oa
-|arg= global|Multiplayer Arguments=
+|version2= 1.50
-|eff= local |Multiplayer Effects=
-____________________________________________________________________________________________
-| Returns currently monitored trigger area. The trigger could be local or remote but the result returned by this command will be for the trigger condition set up locally on the client that executed the command. See [[createTrigger]] for more info.
+|game3= tkoh
+|version3= 1.00
-<br><br>'''NOTE''': Since Arma 3 v1.59.135137, [[triggerArea]] returns 3rd dimension for the monitored area. If height is not set, the value for it would be -1;
+|game4= arma3
- |DESCRIPTION=
+|version4= 0.50
-____________________________________________________________________________________________
-| '''triggerArea''' trigger |SYNTAX=
+|arg= global
-|p1= trigger: [[Object]] |PARAMETER1=
+|gr1= Triggers
-|p2= |PARAMETER2=
+|descr= Returns currently monitored trigger area. Since Arma 3 v1.60, the command returns 3rd dimension for the monitored area. If height is not set, the value for it would be -1.
+{{Feature | important | The trigger could be [[Multiplayer Scripting#Locality|local]] or remote but the result returned by this command will be for the trigger area set up locally on the client that executed the command. See [[createTrigger]] for more info.}}
-|p3= |PARAMETER3=
+|s1= [[triggerArea]] trigger
-| [[Array]] in format [a, b, angle, isRectangle, c], where:
+|p1= trigger: [[Object]]
-* a - trigger area X size / 2
-* b - trigger area Y size / 2
-* angle
-* isRectangle
-* c - trigger area Z size / 2 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(''since Arma 3 v1.59.135137'')|RETURNVALUE=
-|x1= <code>_area = [[triggerArea]] sensor1; // result is [200, 120, 45, false]</code>|EXAMPLE1=
+|r1= [[Array]] with [a, b, angle, isRectangle, c]
-|x2= Since Arma 3 v1.59.135137:<code>_area = [[triggerArea]] sensor1; // result is [200, 120, 45, false, -1];</code>|EXAMPLE2=
+* a: [[Number]] - trigger area X size / 2
-____________________________________________________________________________________________
+* b: [[Number]] - trigger area Y size / 2
+* angle: [[Number]] in range 0..360
+* isRectangle: [[Boolean]]
+* c: [[Number]] - trigger area Z size / 2 (since {{arma3}} v1.60)
-| [[setTriggerArea]], [[inArea]], [[inAreaArray]]|SEEALSO=
+|x1= <sqf>_area = triggerArea sensor1; // result is [200, 120, 45, false, -1];</sqf>
-|  |MPBEHAVIOUR=
+|seealso= [[setTriggerArea]] [[inArea]] [[inAreaArray]]
-____________________________________________________________________________________________
 }}
-<h3 style='display:none'>Notes</h3>
-<dl class='command_description'>
-<!-- Note Section BEGIN -->
-<!-- Note Section END -->
-</dl>
-<h3 style='display:none'>Bottom Section</h3>
-[[Category:ArmA 2: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
-[[Category:Command_Group:_Activators|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]