BIS fnc inTrigger: Difference between revisions

Revision as of 16:56, 12 June 2021

Game1 needed - Version1 needed

Hover & click on the images for description

Description:: This article is a Stub. You can help BI Community Wiki by expanding it.
Description needed
Execution:: call
Groups:: Object Manipulation

Syntax:: [area, position, returnDistance, includeFloorCeiling] call BIS_fnc_inTrigger
Parameters:: area: Object - trigger, String - marker, Location - location or Array - in format [center, distance] or [center, [a, b, angle, rect]] or [center, [a, b, angle, rect, height]]
: position: Object or Array - Position to check (e.g. player) or Position
: returnDistance (Optional): Boolean - true to return distance to nearest edge of trigger area. Default: false
: includeFloorCeiling (Optional): Boolean - true to include trigger area floor and ceiling in calculation when calculating distance to nearest edge. Default: false
Return Value:: Return value needed

Example 1:: _trigger = createTrigger ["EmptyDetector", getPosATL player]; _trigger setTriggerArea [10, 10, 0, false]; _inTrigger = [_trigger, player] call BIS_fnc_inTrigger; //_inTrigger = true

See also:: createTrigger createMarker setTriggerArea setMarkerSize triggerArea markerSize inArea inAreaArray BIS_fnc_getArea

: 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

: Posted on May 6, 2015 - 19:34 (UTC)
Killzone Kid: Works with markers too: inMarker = ["markername", _position] call BIS_fnc_inTrigger;

: Posted on October 4, 2015 - 11:22 (UTC)
Larrow: Also works with [ pos, radius ] [ [position, radius], player ] call BIS_fnc_inTrigger

@@ Line 17: / Line 17: @@
 | Detects whether position is within area (Since Arma 3 v1.57 an engine solution is available [[inArea]]) '''or''' calculates distance to the nearest edge of trigger area by using optional params.
-| [area, position, returnDistance, includeFloorCeiling] call [[BIS_fnc_inTrigger]]
+|s1=[area, position, returnDistance, includeFloorCeiling] call [[BIS_fnc_inTrigger]]
 |p1= area: [[Object]] - trigger, [[String]] - marker, [[Location]] - location or [[Array]] - in format [center, distance] or [center, [a, b, angle, rect]] or [center, [a, b, angle, rect, height]]