View source for lineIntersectsSurfaces

{{Command|= Comments
____________________________________________________________________________________________

| arma3dev |= Game name
|1.49|= Game version
|arg= global|= Arguments in MP
____________________________________________________________________________________________

| Returns list of intersections with surfaces from ''begPosASL'' to ''endPosASL''. If there is ground intersection, it is also included. Works on units. Works underwater. Doesn't return intersection with sea surface. Hardcoded max distance: 5000m.|= Description
____________________________________________________________________________________________

| '''lineIntersectsSurfaces''' [begPosASL, endPosASL, ignoreObj1, ignoreObj2, sortMode, maxResults] |= Syntax
|p1= [begPosASL, endPosASL, ignoreObj1, ignoreObj2, sortMode, maxResults]: [[Array]]|= Parameter 0
|p2= begPosASL: [[PositionASL]] - virtual line start |= Parameter 1
|p3= endPosASL: [[PositionASL]] - virtual line end |= Parameter 2
|p4= ignoreObj1 (Optional): [[Object]] - first object to ignore or [[objNull]]: Default: [[objNull]]|=Parameter 3
|p5= ignoreObj2 (Optional): [[Object]] - second object to ignore or [[objNull]]: Default: [[objNull]] |= Parameter 4
|p6= sortMode (Optional): [[Boolean]] - [[true]]: closest to furthest, [[false]]: furthest to closest. Default: [[true]]  |= Parameter 5
|p7= maxResults (Optional): [[Number]] - Max results to return. -1 to return every result. Default: 1|= Parameter 6

| [[Array]] of intersections in format <nowiki>[</nowiki>[intersectPosASL, surfaceNormal, intersectObj, parentObject],...] where:
* intersectPosASL - the actual position where line intersects 1st surface
* [[surfaceNormal]] - a normal to the intersected surface 
* intersectObject - the object the surface belongs to (could be proxy object)
* parentObject - the object proxy object belongs to (not always the same as intersect object)|= Return value
____________________________________________________________________________________________
|x1= <code>_intersections = [[lineIntersectsSurfaces]] <nowiki>[</nowiki>[[eyePos]] [[player]], [[aimPos]] chopper, [[player]], chopper, [[true]], -1];</code> |= Example 1

|x2= <code>arrow = "Sign_Arrow_F" [[createVehicle]] [0,0,0];
[[onEachFrame]] {
	_ins = [[lineIntersectsSurfaces]] [
		[[ATLToASL]] [[positionCameraToWorld]] [0,0,0], 
		[[ATLToASL]] [[positionCameraToWorld]] [0,0,1000], 
		[[player]]
	];
	[[if]] ([[count]] _ins == 0) [[exitWith]] {arrow [[setPosASL]] [0,0,0]};
	arrow [[setPosASL]] (_ins [[select]] 0 [[select]] 0); 
	arrow [[setVectorUp]] (_ins [[select]] 0 [[select]] 1);
	[[hintSilent]] [[str]] _ins;
};</code> |= Example 2
____________________________________________________________________________________________

| [[lineIntersectsWith]], [[lineIntersectsObjs]], [[terrainIntersect]], [[terrainIntersectASL]], [[lineIntersects]], [[intersect]] |= See also

}}

<h3 style="display:none">Notes</h3>
<dl class="command_description">
</dl>

<h3 style="display:none">Bottom Section</h3>

[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

You can combine with intersect command to find selection names on intersected objects (in this example priority is geom >> ifire >> fire >> view):

 <nowiki>arrow = "Sign_Arrow_F" createVehicle [0,0,0];
testFunc = {
	_ins = lineIntersectsSurfaces [
		ATLToASL positionCameraToWorld [0,0,0],
		ATLToASL positionCameraToWorld [0,0,1000],
		player
	];
	if (count _ins == 0) exitWith {
		arrow setPosASL [0,0,0]
	};
	arrow setPosASL (_ins select 0 select 0);
	arrow setVectorUp (_ins select 0 select 1);
	_sel = "";
	_dist = 10000;
	{
		_ins2 = [_ins select 0 select 3,_x] intersect [
			positionCameraToWorld [0,0,0],
			positionCameraToWorld [0,0,1000]
		];

		{
			if (_x select 1 < _dist) then {
				_dist = _x select 1;
				_sel = _x select 0
			};
		} forEach _ins2;
		if (_sel != "") exitWith {};
	} forEach ["geom","ifire","fire","view"];

	hintsilent format ["selection: %1",_sel];
};
["sample_id","onEachFrame","testFunc"] call BIS_fnc_addStackedEventHandler;