lineIntersects: Difference between revisions

Revision as of 08:47, 2 January 2026

Hover & click on the images for description

Description:

Checks for object intersection with a virtual line between two positions. Since

2.20, there is an alternative syntax that does multiple checks in parallel, faster than multiple calls.

ⓘ

Groups:

Math - Geometry

Syntax:: lineIntersects [begPos, endPos, objIgnore1, objIgnore2]
Parameters:: begPos: PositionASL
: endPos: PositionASL
: objIgnore1: Object - (Optional, default objNull) object to ignore. When testing intersections from an object/unit/vehicle, pass that object here to prevent intersections inside of the object
: objIgnore2: Object - (Optional, default objNull) another object to ignore. When testing intersections of a line between two objects, pass the second object here to prevent intersections inside of it being reported
Return Value:: Boolean - true if an intersection happens with an object (not with terrain)

Syntax:

lineIntersects [[element1, element2, ...]]

Parameters:

elementN: Array format [begPos, endPos, objIgnore1, objIgnore2]:

begPos: PositionASL
endPos: PositionASL
objIgnore1: Object - (Optional, default objNull) object to ignore. When testing intersections from an object/unit/vehicle, pass that object here to prevent intersections inside of the object
objIgnore2: Object - (Optional, default objNull) another object to ignore. When testing intersections of a line between two objects, pass the second object here to prevent intersections inside of it being reported

Return Value:

Array format [result1, result2, ...] - true if an intersection happens with an object (not with terrain) for the Nth element

Example 1:: private _hasStraightLineToChopper = lineIntersects [eyePos player, aimPos chopper, player, chopper];
Example 2:: Alternative syntax to check intersections in parallel:
private _enemies = units opfor; private _enemyDataArray = _enemies apply { [eyePos player, aimPos _x, player, _x] }; private _result = lineIntersects [_enemyDataArray];

See also:: lineIntersectsSurfaces lineIntersectsObjs lineIntersectsWith terrainIntersect terrainIntersectASL terrainIntersectAtASL intersect cursorObject cursorTarget checkVisibility

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

Posted on May 31, 2012 - 10:46 (UTC)

Please note the difference:

@@ Line 22: / Line 22: @@
 |s1= [[lineIntersects]] [begPos, endPos, objIgnore1, objIgnore2]
-|p1= begPos: [[Array]] format [[Position#PositionASL|PositionASL]]
+|p1= begPos: [[Position#PositionASL|PositionASL]]
-|p2= endPos: [[Array]] format [[Position#PositionASL|PositionASL]]
+|p2= endPos: [[Position#PositionASL|PositionASL]]
 |p3= objIgnore1: [[Object]] - (Optional, default [[objNull]]) object to ignore. When testing intersections from an object/unit/vehicle, pass that object here to prevent intersections inside of the object
@@ Line 37: / Line 37: @@
 |p21= elementN: [[Array]] format [begPos, endPos, objIgnore1, objIgnore2]:
-* begPos: [[Array]] format [[Position#PositionASL|PositionASL]]
+* begPos: [[Position#PositionASL|PositionASL]]
-* endPos: [[Array]] format [[Position#PositionASL|PositionASL]]
+* endPos: [[Position#PositionASL|PositionASL]]
 * objIgnore1: [[Object]] - (Optional, default [[objNull]]) object to ignore. When testing intersections from an object/unit/vehicle, pass that object here to prevent intersections inside of the object
 * objIgnore2: [[Object]] - (Optional, default [[objNull]]) another object to ignore. When testing intersections of a line between two objects, pass the second object here to prevent intersections inside of it being reported