BIS fnc inTrigger: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
(formatted page and added example)
Line 8: Line 8:
____________________________________________________________________________________________
____________________________________________________________________________________________


| <pre>//
| Detects whether a position is within the trigger area of the given trigger. |= Description
/*
File: inTrigger.sqf
 
Description:
Detects whether is position within trigger area.
 
Parameter(s):
_this select 0: OBJECT or ARRAY - Trigger or trigger area
_this select 1: ARRAY or OBJECT - Position
_this select 2 (Optional): BOOL - true for scalar result (distance from border)
 
Returns:
Boolean (true when position is in area, false if not).
*/
</pre><small>''(Placeholder description extracted from the function header by [[BIS_fnc_exportFunctionsToWiki]])''</small> |= Description
____________________________________________________________________________________________
____________________________________________________________________________________________


| <!-- [] call [[BIS_fnc_inTrigger]]; --> |= Syntax
| [trigger, position, (isScalar)] call [[BIS_fnc_inTrigger]] |= Syntax
 
|p1= |= Parameter 1


| |= Return value
|p1= trigger: [[Object]] or [[Array]] - [[Triggers|Trigger]] or trigger area |=
|p2= position: [[Object]] or [[Array]] - reference object (e.g. player) or [[Position]] |=
|p3= isScalar (Optional): [[Boolean]] - true for scalar result [default: false] |=
| [[Boolean]] - true when position is in trigger area, false otherwise<br />
[[Number]] - distance from border if ''isScalar'' is true |= Return value
____________________________________________________________________________________________
____________________________________________________________________________________________


|x1= <code></code> |=  
|x1= <code>_trigger = [[createTrigger]] ["EmptyDetector", [[getPosATL]] [[player]]];
_trigger [[setTriggerArea]] [10, 10, 0, false];
_inTrigger = [_trigger, [[player]]] call [[BIS_fnc_inTrigger]]; //_inTrigger = true</code> |=  
____________________________________________________________________________________________
____________________________________________________________________________________________


| |= See also
| [[createTrigger]] [[createMarker]] [[setTriggerArea]] [[setMarkerSize]] [[triggerArea]] [[markerSize]] |= See also


}}
}}

Revision as of 16:43, 31 July 2015


Hover & click on the images for description

Description

Description:
Detects whether a position is within the trigger area of the given trigger.
Execution:
call
Groups:
Uncategorised

Syntax

Syntax:
[trigger, position, (isScalar)] call BIS_fnc_inTrigger
Parameters:
trigger: Object or Array - Trigger or trigger area
position: Object or Array - reference object (e.g. player) or Position
isScalar (Optional): Boolean - true for scalar result [default: false]
Return Value:
Boolean - true when position is in trigger area, false otherwise
Number - distance from border if isScalar is true

Examples

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

Additional Information

See also:
createTrigger createMarker setTriggerArea setMarkerSize triggerArea markerSize

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

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