triggerArea: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Take[ _]On[ _]Helicopters(\|.*)?\]\]" to "{{GameCategory|tkoh|Scripting Commands}}")
m (Text replacement - "\|x([0-9])= *<code>([^<]*)<\/code>" to "|x$1= <sqf>$2</sqf>")
 
(26 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma2 |Game name=
|game1= arma2
|version1= 1.00


|1.00|Game version=
|game2= arma2oa
|version2= 1.50


|arg= global|Multiplayer Arguments=
|game3= tkoh
|version3= 1.00


|gr1= Triggers |GROUP1=
|game4= arma3
____________________________________________________________________________________________
|version4= 0.50


| Returns currently monitored trigger area. Since Arma 3 v1.59.135137, the command returns 3rd dimension for the monitored area. If height is not set, the value for it would be -1.
|arg= global
{{Important | 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.}} |DESCRIPTION=
____________________________________________________________________________________________


| '''triggerArea''' trigger |SYNTAX=
|gr1= Triggers


|p1= trigger: [[Object]] |PARAMETER1=
|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.}}


| [[Array]] in format [a, b, angle, isRectangle, c], where:
|s1= [[triggerArea]] trigger
 
|p1= trigger: [[Object]]
 
|r1= [[Array]] in format [a, b, angle, isRectangle, c], where:
* a - trigger area X size / 2
* a - trigger area X size / 2
* b - trigger area Y size / 2
* b - trigger area Y size / 2
* angle
* angle
* isRectangle
* isRectangle
* c - trigger area Z size / 2 {{since|arma3|1.59.135137|y}} |RETURNVALUE=
* c - trigger area Z size / 2 (since {{arma3}} v1.60)


|x1= <code>_area = [[triggerArea]] sensor1; {{cc|result is [200, 120, 45, false, -1];}}</code> |EXAMPLE1=
|x1= <sqf>_area = triggerArea sensor1; // result is [200, 120, 45, false, -1];</sqf>
____________________________________________________________________________________________


| [[setTriggerArea]], [[inArea]], [[inAreaArray]]|SEEALSO=
|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>
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}

Latest revision as of 10:25, 13 May 2022

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 in format [a, b, angle, isRectangle, c], where:
  • a - trigger area X size / 2
  • b - trigger area Y size / 2
  • angle
  • isRectangle
  • c - 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 or on the Forums.
Only post proven facts here! Add Note