setTriggerArea: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(locality added)
(updated with height)
Line 9: Line 9:
____________________________________________________________________________________________
____________________________________________________________________________________________


| Defines the area controlled by the trigger.
| Defines the area monitored by the given trigger. The area could be either rectangular or elliptical. Since Arma 3 v1.59.135137 it is possible to define 3 dimensional area to monitor by specifying extra param for the area height (see pic).
 
<br><br>Just like with a and b dimensions, c dimension will alter area in opposite directions from the trigger position along z axis. Therefore if the trigger position is on the surface, half of the trigger area will be above the surface and half below. To place the whole area above the surface, adjust trigger position (move it up c meters). If c is not specified or <nowiki>&lt;=</nowiki> 0, the trigger area considered infinitely tall, like in old triggers. |= Description
The area is either rectangular or elliptical, the width is 2 * xrad, the height is 2 * yrad.
 
It is rotated angle degrees. |= Description
____________________________________________________________________________________________
____________________________________________________________________________________________


| trigger '''setTriggerArea''' [xrad, yrad, angle, rectangle] |= Syntax
| trigger '''setTriggerArea''' [a, b, angle, isRectangle, c] |= Syntax


|p1= trigger: [[Object]] |= Parameter 1
|p1= trigger: [[Object]] - object of the type "EmptyDetector"|= Parameter 1
|p2= [xrad, yrad, angle, rectangle]: [[Array]] |= Parameter 2
|p2= [a, b, angle, isRectangle, c]: [[Array]] |= Parameter 2
|p3= xrad: [[Number]] - horizontal(x) radius (or half the width of rectangle) |= Parameter 3
|p3= a: [[Number]] - trigger area X size / 2, in meters |= Parameter 3
|p4= yrad: [[Number]] - vertical(y) radius (or half the height of rectangle) |= Parameter 4
|p4= b: [[Number]] - trigger area Y size / 2, in meters |= Parameter 4
|p5= angle: [[Number]] - rotational in degrees |= Parameter 5
|p5= angle: [[Number]] - trigger area rotation in degrees |= Parameter 5
|p6= rectangle: [[Boolean]] - [[true]] if rectangle) |= Parameter 6
|p6= isRectangle: [[Boolean]] - [[true]] if rectangle) |= Parameter 6
|p7= c (Optional): [[Number]] - trigger area Z size / 2, in meters &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; (''Since Arma 3 v1.59.135137'') |= Parameter 7


| [[Nothing]] |= Return value
| [[Nothing]]
<br>[[Image:setTriggerArea.jpg|300px]] |= Return value
____________________________________________________________________________________________
____________________________________________________________________________________________
   
   
|x1= <code>_trigger setTriggerArea [100, 50, 45, [[false]] ]</code> |= Example 1
|x1= <code>_trigger [[setTriggerArea]] [100, 50, 45, [[false]]];</code> |= Example 1
|x2= Possible since Arma 3 v1.59.135137:<code>_trigger [[setTriggerArea]] [100, 50, 45, [[false]], 100];</code> |= Example 2
____________________________________________________________________________________________
____________________________________________________________________________________________


| [[triggerArea]], [[createTrigger]],[[setTriggerActivation]], [[setTriggerStatements]], [[setTriggerText]], [[setTriggerTimeout]], [[setTriggerType]]  |= See also
| [[triggerArea]], [[createTrigger]], [[setTriggerActivation]], [[setTriggerStatements]], [[setTriggerText]], [[setTriggerTimeout]], [[setTriggerType]], [[inArea]]  |= See also


}}
}}

Revision as of 21:44, 24 March 2016

-wrong parameter ("Arma") defined!-1.00
Hover & click on the images for description

Description

Description:
Defines the area monitored by the given trigger. The area could be either rectangular or elliptical. Since Arma 3 v1.59.135137 it is possible to define 3 dimensional area to monitor by specifying extra param for the area height (see pic).

Just like with a and b dimensions, c dimension will alter area in opposite directions from the trigger position along z axis. Therefore if the trigger position is on the surface, half of the trigger area will be above the surface and half below. To place the whole area above the surface, adjust trigger position (move it up c meters). If c is not specified or <= 0, the trigger area considered infinitely tall, like in old triggers.
Groups:
Uncategorised

Syntax

Syntax:
trigger setTriggerArea [a, b, angle, isRectangle, c]
Parameters:
trigger: Object - object of the type "EmptyDetector"
[a, b, angle, isRectangle, c]: Array
a: Number - trigger area X size / 2, in meters
b: Number - trigger area Y size / 2, in meters
angle: Number - trigger area rotation in degrees
isRectangle: Boolean - true if rectangle)
c (Optional): Number - trigger area Z size / 2, in meters         (Since Arma 3 v1.59.135137)
Return Value:
Nothing
setTriggerArea.jpg

Examples

Example 1:
_trigger setTriggerArea [100, 50, 45, false];
Example 2:
Possible since Arma 3 v1.59.135137:_trigger setTriggerArea [100, 50, 45, false, 100];

Additional Information

See also:
triggerAreacreateTriggersetTriggerActivationsetTriggerStatementssetTriggerTextsetTriggerTimeoutsetTriggerTypeinArea

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


Notes

Bottom Section