lineIntersectsSurfaces: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\| *arma3 * * *\| *([0-2]\.[0-9]{2}) * " to "|game1= arma3 |version1= $1 ")
(Add alternative syntax for running multiple intersections in parallel. Minor typo corrections. Reordered see also commands to be grouped and consistent across lineIntersects pages)
 
(75 intermediate revisions by 6 users not shown)
Line 7: Line 7:
|gr1= Math - Geometry
|gr1= Math - Geometry


|descr= 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. By default, for speed purposes, command will return only 1st intersection with unique objects. Since Arma 3 v1.70, this could be tweaked with an optional param.  
|descr= Returns a list of intersections with surfaces and ground from ''begPosASL'' to ''endPosASL''. Doesn't return intersection with sea surface. Works underwater, unlike [[lineIntersects]]. Hardcoded max distance: 5000m.
{{Feature | Informative | If ''begPosASL'' is under the ground and ''endPosASL'' is above it, the command will only return intersection with the ground, this is engine limitation and none of the intersectXXX commands will work when initiated from under the ground.}}
{{Feature|important|
Since Arma v1.52 it is possible to indicate primary and secondary [[LOD]] to look for intersection. Available options are:
* if ''begPosASL'' is under the ground and ''endPosASL'' is above it, the command will only return intersection with the ground, this is an engine limitation and none of the intersectXXX commands will work when initiated from under the ground.
* only a single LOD is checked for intersection. LOD2 will only be checked if LOD1 is unavailable.
}}
Since {{GVI|arma3|2.20|size= 0.75}}, there is an alternative syntax that does multiple checks at once, faster than multiple calls.
 
|s1= [[lineIntersectsSurfaces]] [begPosASL, endPosASL, ignoreObj1, ignoreObj2, sortMode, maxResults, LOD1, LOD2, returnUnique]
 
|p1= begPosASL: [[Array]] format [[Position#PositionASL|PositionASL]] - virtual line start
 
|p2= endPosASL: [[Array]] format [[Position#PositionASL|PositionASL]] - virtual line end
 
|p3= ignoreObj1: [[Object]] - (Optional, default [[objNull]]) first object to ignore
 
|p4= ignoreObj2: [[Object]] - (Optional, default [[objNull]]) second object to ignore
 
|p5= sortMode: [[Boolean]] -  (Optional, default [[true]]) [[true]]: closest to furthest, [[false]]: furthest to closest
 
|p6= maxResults: [[Number]] - (Optional, default 1) max results to return. -1 to return every result
 
|p7= LOD1: [[String]] - (Optional, default "VIEW") primary [[LOD]] to look for intersection. Can be one of:
* "FIRE"
* "FIRE"
* "VIEW"
* "VIEW"
* "GEOM"
* "GEOM"
* "IFIRE" - ("I" stands for Indirect, practically the same as FIRE)
* "IFIRE" - ("I" stands for Indirect, ''almost'' identical to "FIRE")
* "NONE"
* "NONE"
* "PHYSX" - PhysX geometry LOD (since Arma 3 v2.01.146666)
* {{GVI|arma3|2.02|size= 0.75}} "PHYSX" - PhysX geometry LOD
* {{GVI|arma3|2.08|size= 0.75}} "ROADWAY" - only works from the top
|p7since= arma3 1.52


Default [[LOD]]s are "VIEW" and "FIRE"
|p8= LOD2: [[String]] - (Optional, default "FIRE") secondary [[LOD]] to look for intersection. See ''LOD1'' for possible values
{{Feature | important | Only a single LOD is checked for intersection. LOD1 is Primary LOD and will be checked first. LOD2 is Secondary LOD. If LOD1 is not possible to check, LOD2 will be used.}}
|p8since= arma3 1.52


|s1= '''lineIntersectsSurfaces''' [begPosASL, endPosASL, ignoreObj1, ignoreObj2, sortMode, maxResults, LOD1, LOD2, returnUnique]
|p9= returnUnique: [[Boolean]] - (Optional, default [[true]]) when [[false]], all intersections in the same object are included, otherwise only the first one
|p9since= arma3 1.70


|p1= [begPosASL, endPosASL, ignoreObj1, ignoreObj2, sortMode, maxResults, LOD1, LOD2]: [[Array]]
|r1= [[Array]] of intersections in format [<nowiki/>[intersectPosASL, surfaceNormal, intersectObj, parentObject, selectionNames, pathToBisurf], ...] where:
|p2= begPosASL: [[PositionASL]] - virtual line start
* intersectPosASL: [[PositionASL]] - the actual position where line intersects surface
* [[surfaceNormal]]: [[Vector]] - a normal to the intersected surface
* intersectObject: [[Object]] - the object the surface belongs to (could be proxy object) - [[objNull]] if terrain
* parentObject: [[Object]] - the object proxy object belongs to (not always the same as intersect object) - [[objNull]] if terrain
* {{GVI|arma3|2.10|size= 0.75}} [[selectionNames]]: [[Array]] of [[String]]s - Names of the intersected selections (bones). Returns {{hl|[]}} if there is no intersection with a selection.
* {{GVI|arma3|2.10|size= 0.75}} pathToBisurf: [[String]] - path to intersected surface properties (.bisurf) file. Returns {{hl|""}} if surface has no special properties. Terrain surface properties begin with {{hl|#}}, and the surface properties are defined in {{hl|CfgSurfaces}}. For example, if it returns {{hl|#GdtVRsurface01}}, properties are defined in: <sqf inline>configFile >> "CfgSurfaces" >> "GdtVRsurface01"</sqf>


|p3= endPosASL: [[PositionASL]] - virtual line end
|s2= [[lineIntersectsSurfaces]] [element1, element2, ...]
|p4= ignoreObj1 (Optional): [[Object]] - first object to ignore or [[objNull]]: Default: [[objNull]]
|p5= ignoreObj2 (Optional): [[Object]] - second object to ignore or [[objNull]]: Default: [[objNull]]
|p6= sortMode (Optional): [[Boolean]] - [[true]]: closest to furthest, [[false]]: furthest to closest. Default: [[true]]
|p7= maxResults (Optional): [[Number]] - Max results to return. -1 to return every result. Default: 1
|p8= LOD1 (Optional): [[String]] (added in v1.52) - Primary [[LOD]] to look for intersection. Default: "VIEW"
|p9= LOD2 (Optional): [[String]] (added in v1.52) - Secondary [[LOD]] to look for intersection. Default: "FIRE"
|p10= returnUnique (Optional): [[Boolean]] (added in v1.70) - When [[false]], all intersections in the same object are included not just the 1st one. Default: [[true]]


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


|x2= <code>arrow = "Sign_Arrow_F" [[createVehicle]] [0,0,0];
|p21= elementN: [[Array]] format [begPosASL, endPosASL, ignoreObj1, ignoreObj2, sortMode, maxResults, LOD1, LOD2, returnUnique]
[[onEachFrame]] {
* begPosASL: [[Array]] format [[Position#PositionASL|PositionASL]] - virtual line start
_ins = [[lineIntersectsSurfaces]] [
* endPosASL: [[Array]] format [[Position#PositionASL|PositionASL]] - virtual line end
[[AGLToASL]] [[positionCameraToWorld]] [0,0,0],  
* ignoreObj1: [[Object]] - (Optional, default [[objNull]]) first object to ignore
[[AGLToASL]] [[positionCameraToWorld]] [0,0,1000],  
* ignoreObj2: [[Object]] - (Optional, default [[objNull]]) second object to ignore
[[player]]
* sortMode: [[Boolean]] -  (Optional, default [[true]]) [[true]]: closest to furthest, [[false]]: furthest to closest
* maxResults: [[Number]] - (Optional, default 1) max results to return. -1 to return every result
* LOD1: [[String]] - (Optional, default "VIEW") primary [[LOD]] to look for intersection. Can be one of:
** "FIRE"
** "VIEW"
** "GEOM"
** "IFIRE" - ("I" stands for Indirect, ''almost'' identical to "FIRE")
** "NONE"
** "PHYSX" - PhysX geometry LOD
** "ROADWAY" - only works from the top
* LOD2: [[String]] - (Optional, default "FIRE") secondary [[LOD]] to look for intersection. See ''LOD1'' for possible values
* returnUnique: [[Boolean]] - (Optional, default [[true]]) when [[false]], all intersections in the same object are included, otherwise only the first one
 
|r2= [[Array]] format [result1, result2, ...] - each result is an [[Array]] of intersections in format [<nowiki/>[intersectPosASL, surfaceNormal, intersectObj, parentObject, selectionNames, pathToBisurf], ...]
* intersectPosASL: [[PositionASL]] - the actual position where line intersects surface
* [[surfaceNormal]]: [[Vector]] - a normal to the intersected surface
* intersectObject: [[Object]] - the object the surface belongs to (could be proxy object) - [[objNull]] if terrain
* parentObject: [[Object]] - the object proxy object belongs to (not always the same as intersect object) - [[objNull]] if terrain
* [[selectionNames]]: [[Array]] of [[String]]s - Names of the intersected selections (bones). Returns {{hl|[]}} if there is no intersection with a selection.
* pathToBisurf: [[String]] - path to intersected surface properties (.bisurf) file. Returns {{hl|""}} if surface has no special properties. Terrain surface properties begin with {{hl|#}}, and the surface properties are defined in {{hl|CfgSurfaces}}. For example, if it returns {{hl|#GdtVRsurface01}}, properties are defined in: <sqf inline>configFile >> "CfgSurfaces" >> "GdtVRsurface01"</sqf>
 
|x1= <sqf>_intersections = lineIntersectsSurfaces [eyePos player, aimPos chopper, player, chopper, true, -1];</sqf>
 
|x2= <sqf>
arrow = "Sign_Arrow_F" createVehicle [0,0,0];
onEachFrame {
_ins = lineIntersectsSurfaces [
AGLToASL positionCameraToWorld [0,0,0],  
AGLToASL positionCameraToWorld [0,0,1000],  
player
];
];
[[if]] ([[count]] _ins == 0) [[exitWith]] {arrow [[setPosASL]] [0,0,0]};
if (count _ins == 0) exitWith { arrow setPosASL [0,0,0] };
arrow [[setPosASL]] (_ins [[select]] 0 [[select]] 0);  
arrow setPosASL (_ins select 0 select 0);
arrow [[setVectorUp]] (_ins [[select]] 0 [[select]] 1);
arrow setVectorUp (_ins select 0 select 1);
[[hintSilent]] [[str]] _ins;
hintSilent str _ins;
};</code>
};
</sqf>


|x3= This should detect glass windows and wire fences (since Arma v1.52): <code>wirefence = "Land_New_WiredFence_5m_F" [[createVehicle]] [[position]] [[player]];
|x3= This should detect glass windows and wire fences (since {{arma3}} v1.52):
arrow = "Sign_Arrow_F" [[createVehicle]] [0,0,0];
<sqf>
[[onEachFrame]] {
wirefence = "Land_New_WiredFence_5m_F" createVehicle position player;
_ins = [[lineIntersectsSurfaces]] [
arrow = "Sign_Arrow_F" createVehicle [0,0,0];
[[AGLToASL]] [[positionCameraToWorld]] [0,0,0],  
onEachFrame {
[[AGLToASL]] [[positionCameraToWorld]] [0,0,1000],  
_ins = lineIntersectsSurfaces [
[[player]],
AGLToASL positionCameraToWorld [0,0,0],  
[[objNull]],
AGLToASL positionCameraToWorld [0,0,1000],  
[[true]],
player,
objNull,
true,
1,
1,
"GEOM",
"GEOM",
"NONE"
"NONE"
];
];
[[if]] ([[count]] _ins == 0) [[exitWith]] {arrow [[setPosASL]] [0,0,0]};
if (count _ins == 0) exitWith { arrow setPosASL [0,0,0] };
arrow [[setPosASL]] (_ins [[select]] 0 [[select]] 0);  
arrow setPosASL (_ins select 0 select 0);
arrow [[setVectorUp]] (_ins [[select]] 0 [[select]] 1);
arrow setVectorUp (_ins select 0 select 1);
[[hintSilent]] [[str]] _ins;
hintSilent str _ins;
};</code>
};
</sqf>


|seealso= [[lineIntersectsWith]], [[lineIntersectsObjs]], [[terrainIntersect]], [[terrainIntersectASL]], [[terrainIntersectAtASL]], [[lineIntersects]], [[intersect]], [[cursorObject]], [[cursorTarget]], [[checkVisibility]]
|x4= Alternative syntax to check intersections in parallel. Will draw a redline to the first intersecting object between the player and unit:
<sqf>
private _handle = addMissionEventHandler ["Draw3D", {
private _enemies = units opfor;
private _enemyDataArray = _enemies apply { [eyePos player, eyePos _x, player, _x] };
private _intersections = lineIntersectsSurfaces [_enemyDataArray];
{
// No intersections found, draw green '+' icon at unit
if (_x isEqualTo []) then {
drawIcon3D [
"\a3\ui_f\data\gui\cfg\cursors\add_gs.paa",
[0, 1, 0, 1],
ASLToAGL (eyePos (_enemies#_forEachIndex)),
0.5, 0.5, 0,
str (_enemies#_forEachIndex)
];
} else {
private _firstIntersection = _x#0;
// Draw red line and '+' icon to first intersecting object
drawIcon3D [
"\a3\ui_f\data\gui\cfg\cursors\add_gs.paa",
[1, 0, 0, 1],
ASLToAGL (_firstIntersection#0),
0.5, 0.5, 0,
str (_enemies#_forEachIndex) + "- Blocked by " + str (_firstIntersection#2)
];
drawLine3D [
ASLToAGL (eyePos player),
ASLToAGL (_firstIntersection#0),
[1, 0, 0, 1],
5
];
};
} forEach _intersections;
}];
</sqf>
 
|seealso= [[lineIntersectsObjs]] [[lineIntersectsWith]] [[lineIntersects]] [[terrainIntersectASL]] [[terrainIntersectAtASL]] [[terrainIntersect]] [[intersect]] [[cursorObject]] [[cursorTarget]] [[checkVisibility]]
}}
}}


{{Note
|user= Killzone_Kid
|timestamp= 20150827124400
|text= Fast check if the player is in a house:
<sqf>
KK_fnc_inHouse = {
lineIntersectsSurfaces [
getPosWorld _this,
getPosWorld _this vectorAdd [0, 0, 50],
_this, objNull, true, 1, "GEOM", "NONE"
] select 0 params ["","","","_house"];
if (_house isKindOf "House") exitWith { true };
false
};
onEachFrame { hintSilent str (player call KK_fnc_inHouse) };
</sqf>
}}


<dl class="command_description">
{{Note
|user= Pierre MGI
|timestamp= 20160130201000
|text= This command is useful to place weaponholder (and then spawned weapons) on floor of houses, correcting  the spawn position (can_collide) to intersect with floor:
<sqf>
MGI_fnc_setPosAGLS = {
params ["_obj", "_pos"];
_wh_pos = getPosASL _obj;


<dt></dt>
_pos set [2, (ATLToASL _pos select 2) - 10];
<dd class="notedate">Posted on August 27, 2015 - 12:44 (UTC)</dd>
_ins = lineIntersectsSurfaces [_wh_pos, _pos,_obj, objNull, true, 1, "VIEW", "FIRE"];
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
_surface_distance = if (count _ins > 0) then [{ (_ins select 0 select 0) distance _wh_pos }, { 0 }];
<dd class="note">
_wh_pos set [2, (getPosASL _obj select 2) - (_surface_distance)];
Fast check if object is in a house:<code>KK_fnc_inHouse = {
_weaponholder setPosASL _wh_pos;
[[lineIntersectsSurfaces]] [
[[getPosWorld]] _this,  
[[getPosWorld]] _this [[vectorAdd]] [0, 0, 50],  
_this, [[objNull]], [[true]], 1, "GEOM", "NONE"
] [[select]] 0 [[params]] ["","","","_house"];
[[if]] (_house [[isKindOf]] "House") [[exitWith]] {[[true]]};
[[false]]
};
};
[[onEachFrame]] {[[hintSilent]] [[str]] ([[player]] [[call]] KK_fnc_inHouse)};</code>
</sqf>
</dd>
<dt></dt>
<dd class="notedate">Posted on January 30, 2016 - 20:10 (UTC)</dd>
<dt class="note">[[User:Pierre MGI|Pierre MGI]]</dt>
<dd class="note">
This command is useful to place weaponholder (and then spawned weapons) on floor of houses, correcting  the spawn position (can_collide) to intersect with floor:
<code>MGI_fnc_setPosAGLS = {
  [[params]] ["_obj", "_pos"];
  _wh_pos = [[getPosASL]] _obj;
 
  _pos [[set]] [2, ([[ATLtoASL]] _pos [[select]] 2)-10];
_ins = [[lineIntersectsSurfaces]] [_wh_pos, _pos,_obj,[[objNull]], [[true]],1,"VIEW","FIRE"];
_surface_distance = [[if]] ([[count]] _ins > 0) [[then]] [{(_ins [[select]] 0 [[select]] 0) [[distance]] _wh_pos},{0}];
_wh_pos [[set]] [2, ([[getPosASL]] _obj [[select]] 2) - (_surface_distance)];
_weaponholder [[setPosASL]] _wh_pos;
};
</code>
After the position (_pos) obtained in BIS_fnc_buidingPositions array:
After the position (_pos) obtained in BIS_fnc_buidingPositions array:
<code>_weaponholder = [[createVehicle]] ["groundWeaponHolder", _pos, [], 0, "CAN_COLLIDE"];
<sqf>
[_weaponholder,_pos] [[call]] MGI_fnc_setPosAGLS;
private _weaponHolder = createVehicle ["groundWeaponHolder", _pos, [], 0, "CAN_COLLIDE"];
[_weaponHolder, _pos] call MGI_fnc_setPosAGLS;
</sqf>
Then fill your weapon holder.
Then fill your weapon holder.
</code>
}}
</dd>


</dl>
{{Note
|user= Tankbuster
|timestamp= 20240106154115
|text= Note that dome_big and dome_small objects have glass roof panels which this function can't see if it intersects those windows
}}

Latest revision as of 04:30, 1 December 2024

Arma 3 logo black.png1.50
GAGlobal
Hover & click on the images for description

Description

Description:
Returns a list of intersections with surfaces and ground from begPosASL to endPosASL. Doesn't return intersection with sea surface. Works underwater, unlike lineIntersects. Hardcoded max distance: 5000m.
⚠
  • if begPosASL is under the ground and endPosASL is above it, the command will only return intersection with the ground, this is an engine limitation and none of the intersectXXX commands will work when initiated from under the ground.
  • only a single LOD is checked for intersection. LOD2 will only be checked if LOD1 is unavailable.
Since Arma 3 logo black.png2.20, there is an alternative syntax that does multiple checks at once, faster than multiple calls.
Groups:
Math - Geometry

Syntax

Syntax:
lineIntersectsSurfaces [begPosASL, endPosASL, ignoreObj1, ignoreObj2, sortMode, maxResults, LOD1, LOD2, returnUnique]
Parameters:
begPosASL: Array format PositionASL - virtual line start
endPosASL: Array format PositionASL - virtual line end
ignoreObj1: Object - (Optional, default objNull) first object to ignore
ignoreObj2: Object - (Optional, default objNull) second object to ignore
sortMode: Boolean - (Optional, default true) true: closest to furthest, false: furthest to closest
maxResults: Number - (Optional, default 1) max results to return. -1 to return every result
since Arma 3 logo black.png1.52
LOD1: String - (Optional, default "VIEW") primary LOD to look for intersection. Can be one of:
  • "FIRE"
  • "VIEW"
  • "GEOM"
  • "IFIRE" - ("I" stands for Indirect, almost identical to "FIRE")
  • "NONE"
  • Arma 3 logo black.png2.02 "PHYSX" - PhysX geometry LOD
  • Arma 3 logo black.png2.08 "ROADWAY" - only works from the top
since Arma 3 logo black.png1.52
LOD2: String - (Optional, default "FIRE") secondary LOD to look for intersection. See LOD1 for possible values
since Arma 3 logo black.png1.70
returnUnique: Boolean - (Optional, default true) when false, all intersections in the same object are included, otherwise only the first one
Return Value:
Array of intersections in format [[intersectPosASL, surfaceNormal, intersectObj, parentObject, selectionNames, pathToBisurf], ...] where:
  • intersectPosASL: PositionASL - the actual position where line intersects surface
  • surfaceNormal: Vector - a normal to the intersected surface
  • intersectObject: Object - the object the surface belongs to (could be proxy object) - objNull if terrain
  • parentObject: Object - the object proxy object belongs to (not always the same as intersect object) - objNull if terrain
  • Arma 3 logo black.png2.10 selectionNames: Array of Strings - Names of the intersected selections (bones). Returns [] if there is no intersection with a selection.
  • Arma 3 logo black.png2.10 pathToBisurf: String - path to intersected surface properties (.bisurf) file. Returns "" if surface has no special properties. Terrain surface properties begin with #, and the surface properties are defined in CfgSurfaces. For example, if it returns #GdtVRsurface01, properties are defined in: configFile >> "CfgSurfaces" >> "GdtVRsurface01"

Alternative Syntax

Syntax:
lineIntersectsSurfaces [element1, element2, ...]
Parameters:
elementN: Array format [begPosASL, endPosASL, ignoreObj1, ignoreObj2, sortMode, maxResults, LOD1, LOD2, returnUnique]
  • begPosASL: Array format PositionASL - virtual line start
  • endPosASL: Array format PositionASL - virtual line end
  • ignoreObj1: Object - (Optional, default objNull) first object to ignore
  • ignoreObj2: Object - (Optional, default objNull) second object to ignore
  • sortMode: Boolean - (Optional, default true) true: closest to furthest, false: furthest to closest
  • maxResults: Number - (Optional, default 1) max results to return. -1 to return every result
  • LOD1: String - (Optional, default "VIEW") primary LOD to look for intersection. Can be one of:
    • "FIRE"
    • "VIEW"
    • "GEOM"
    • "IFIRE" - ("I" stands for Indirect, almost identical to "FIRE")
    • "NONE"
    • "PHYSX" - PhysX geometry LOD
    • "ROADWAY" - only works from the top
  • LOD2: String - (Optional, default "FIRE") secondary LOD to look for intersection. See LOD1 for possible values
  • returnUnique: Boolean - (Optional, default true) when false, all intersections in the same object are included, otherwise only the first one
Return Value:
Array format [result1, result2, ...] - each result is an Array of intersections in format [[intersectPosASL, surfaceNormal, intersectObj, parentObject, selectionNames, pathToBisurf], ...]
  • intersectPosASL: PositionASL - the actual position where line intersects surface
  • surfaceNormal: Vector - a normal to the intersected surface
  • intersectObject: Object - the object the surface belongs to (could be proxy object) - objNull if terrain
  • parentObject: Object - the object proxy object belongs to (not always the same as intersect object) - objNull if terrain
  • selectionNames: Array of Strings - Names of the intersected selections (bones). Returns [] if there is no intersection with a selection.
  • pathToBisurf: String - path to intersected surface properties (.bisurf) file. Returns "" if surface has no special properties. Terrain surface properties begin with #, and the surface properties are defined in CfgSurfaces. For example, if it returns #GdtVRsurface01, properties are defined in: configFile >> "CfgSurfaces" >> "GdtVRsurface01"

Examples

Example 1:
_intersections = lineIntersectsSurfaces [eyePos player, aimPos chopper, player, chopper, true, -1];
Example 2:
arrow = "Sign_Arrow_F" createVehicle [0,0,0]; onEachFrame { _ins = lineIntersectsSurfaces [ AGLToASL positionCameraToWorld [0,0,0], AGLToASL 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; };
Example 3:
This should detect glass windows and wire fences (since Arma 3 v1.52):
wirefence = "Land_New_WiredFence_5m_F" createVehicle position player; arrow = "Sign_Arrow_F" createVehicle [0,0,0]; onEachFrame { _ins = lineIntersectsSurfaces [ AGLToASL positionCameraToWorld [0,0,0], AGLToASL positionCameraToWorld [0,0,1000], player, objNull, true, 1, "GEOM", "NONE" ]; 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; };
Example 4:
Alternative syntax to check intersections in parallel. Will draw a redline to the first intersecting object between the player and unit:
private _handle = addMissionEventHandler ["Draw3D", { private _enemies = units opfor; private _enemyDataArray = _enemies apply { [eyePos player, eyePos _x, player, _x] }; private _intersections = lineIntersectsSurfaces [_enemyDataArray]; { // No intersections found, draw green '+' icon at unit if (_x isEqualTo []) then { drawIcon3D [ "\a3\ui_f\data\gui\cfg\cursors\add_gs.paa", [0, 1, 0, 1], ASLToAGL (eyePos (_enemies#_forEachIndex)), 0.5, 0.5, 0, str (_enemies#_forEachIndex) ]; } else { private _firstIntersection = _x#0; // Draw red line and '+' icon to first intersecting object drawIcon3D [ "\a3\ui_f\data\gui\cfg\cursors\add_gs.paa", [1, 0, 0, 1], ASLToAGL (_firstIntersection#0), 0.5, 0.5, 0, str (_enemies#_forEachIndex) + "- Blocked by " + str (_firstIntersection#2) ]; drawLine3D [ ASLToAGL (eyePos player), ASLToAGL (_firstIntersection#0), [1, 0, 0, 1], 5 ]; }; } forEach _intersections; }];

Additional Information

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

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
Killzone_Kid - c
Posted on Aug 27, 2015 - 12:44 (UTC)
Fast check if the player is in a house:
KK_fnc_inHouse = { lineIntersectsSurfaces [ getPosWorld _this, getPosWorld _this vectorAdd [0, 0, 50], _this, objNull, true, 1, "GEOM", "NONE" ] select 0 params ["","","","_house"]; if (_house isKindOf "House") exitWith { true }; false }; onEachFrame { hintSilent str (player call KK_fnc_inHouse) };
Pierre MGI - c
Posted on Jan 30, 2016 - 20:10 (UTC)
This command is useful to place weaponholder (and then spawned weapons) on floor of houses, correcting the spawn position (can_collide) to intersect with floor:
MGI_fnc_setPosAGLS = { params ["_obj", "_pos"]; _wh_pos = getPosASL _obj; _pos set [2, (ATLToASL _pos select 2) - 10]; _ins = lineIntersectsSurfaces [_wh_pos, _pos,_obj, objNull, true, 1, "VIEW", "FIRE"]; _surface_distance = if (count _ins > 0) then [{ (_ins select 0 select 0) distance _wh_pos }, { 0 }]; _wh_pos set [2, (getPosASL _obj select 2) - (_surface_distance)]; _weaponholder setPosASL _wh_pos; };
After the position (_pos) obtained in BIS_fnc_buidingPositions array:
private _weaponHolder = createVehicle ["groundWeaponHolder", _pos, [], 0, "CAN_COLLIDE"]; [_weaponHolder, _pos] call MGI_fnc_setPosAGLS;
Then fill your weapon holder.
Tankbuster - c
Posted on Jan 06, 2024 - 15:41 (UTC)
Note that dome_big and dome_small objects have glass roof panels which this function can't see if it intersects those windows
Retrieved from "https://community.bistudio.com/wiki?title=lineIntersectsSurfaces&oldid=370338"