lineIntersectsSurfaces: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (Some wiki formatting)
(76 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma3dev |= Game name
|game1= arma3
|1.49|= Game version
|version1= 1.50
|arg= global|= Arguments in MP
|arg= global
____________________________________________________________________________________________


| 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
|gr1= Math - Geometry
____________________________________________________________________________________________


| '''lineIntersectsSurfaces''' [begPosASL, endPosASL, ignoreObj1, ignoreObj2, sortMode, maxResults] |= Syntax
|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.
|p1= [begPosASL, endPosASL, ignoreObj1, ignoreObj2, sortMode, maxResults]: [[Array]]|= Parameter 0
{{Feature|important|
|p2= begPosASL: [[PositionASL]] - virtual line start |= Parameter 1
* 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.
|p3= endPosASL: [[PositionASL]] - virtual line end |= Parameter 2
* only a single LOD is checked for intersection. LOD2 will only be checked if LOD1 is unavailable.
|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
|s1= [[lineIntersectsSurfaces]] [begPosASL, endPosASL, ignoreObj1, ignoreObj2, sortMode, maxResults, LOD1, LOD2, returnUnique]
|p7= maxResults (Optional): [[Number]] - Max results to return. -1 to return every result. Default: 1|= Parameter 6
 
|p1= begPosASL: [[PositionASL]] - virtual line start


| [[Array]] of intersections in format <nowiki>[</nowiki>[intersectPosASL, surfaceNormal, intersectObj, parentObject],...] where:
|p2= endPosASL: [[PositionASL]] - virtual line end
* intersectPosASL - the actual position where line intersects 1st surface
 
|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"
* "VIEW"
* "GEOM"
* "IFIRE" - ("I" stands for Indirect, ''almost'' identical to "FIRE")
* "NONE"
* {{GVI|arma3|2.02|size=0.8}} "PHYSX" - PhysX geometry LOD
|p7since= arma3 1.52
 
|p8= LOD2: [[String]] - (Optional, default "FIRE") secondary [[LOD]] to look for intersection. See ''LOD1'' for possible values
|p8since= arma3 1.52
 
|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
 
|r1= [[Array]] of intersections in format [<nowiki/>[intersectPosASL, surfaceNormal, intersectObj, parentObject], ...] where:
* intersectPosASL - the actual position where line intersects surface
* [[surfaceNormal]] - a normal to the intersected surface  
* [[surfaceNormal]] - a normal to the intersected surface  
* intersectObject - the object the surface belongs to (could be proxy object)
* 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)|= Return value
* parentObject - the object proxy object belongs to (not always the same as intersect object) - [[objNull]] if terrain
____________________________________________________________________________________________
 
|x1= <code>_intersections = [[lineIntersectsSurfaces]] <nowiki>[</nowiki>[[eyePos]] [[player]], [[aimPos]] chopper, [[player]], chopper, [[true]], -1];</code> |= Example 1
|x1= <code>_intersections = [[lineIntersectsSurfaces]] [<nowiki/>[[eyePos]] [[player]], [[aimPos]] chopper, [[player]], chopper, [[true]], -1];</code>


|x2= <code>arrow = "Sign_Arrow_F" [[createVehicle]] [0,0,0];
|x2= <code>arrow = "Sign_Arrow_F" [[createVehicle]] [0,0,0];
[[onEachFrame]] {
[[onEachFrame]] {
_ins = [[lineIntersectsSurfaces]] [
_ins = [[lineIntersectsSurfaces]] [
[[ATLToASL]] [[positionCameraToWorld]] [0,0,0],  
[[AGLToASL]] [[positionCameraToWorld]] [0,0,0],  
[[ATLToASL]] [[positionCameraToWorld]] [0,0,1000],  
[[AGLToASL]] [[positionCameraToWorld]] [0,0,1000],  
[[player]]
[[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> |= Example 2
};</code>
____________________________________________________________________________________________


| [[lineIntersectsWith]], [[lineIntersectsObjs]], [[terrainIntersect]], [[terrainIntersectASL]], [[lineIntersects]], [[intersect]] |= See also
|x3= This should detect glass windows and wire fences (since Arma v1.52): <code>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;
};</code>


|seealso= [[lineIntersectsWith]], [[lineIntersectsObjs]], [[terrainIntersect]], [[terrainIntersectASL]], [[terrainIntersectAtASL]], [[lineIntersects]], [[intersect]], [[cursorObject]], [[cursorTarget]], [[checkVisibility]]
}}
}}


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


<h3 style="display:none">Bottom Section</h3>
<dt></dt>
<dd class="notedate">Posted on August 27, 2015 - 12:44 (UTC)</dd>
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
<dd class="note">
Fast check if the player is in a house:<code>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) };</code>
</dd>


[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
<dt></dt>
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
<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;


You can combine with intersect command to find selection names on intersected objects (in this example priority is geom >> ifire >> fire >> view):
_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:
<code>[[private]] _weaponHolder = [[createVehicle]] ["groundWeaponHolder", _pos, [], 0, "CAN_COLLIDE"];
[_weaponHolder, _pos] [[call]] MGI_fnc_setPosAGLS;
Then fill your weapon holder.
</code>
</dd>


<nowiki>arrow = "Sign_Arrow_F" createVehicle [0,0,0];
</dl>
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);
_intDist = (_ins select 0 select 0) distance (ATLToASL positionCameraToWorld [0,0,0]);
_sel = "";
_dist = 10000;
{
_ins2 = [_ins select 0 select 3,_x] intersect [
positionCameraToWorld [0,0,0],
positionCameraToWorld [0,0,_intDist + 0.1]
];
 
{
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 ["nearest selection: %1",_sel];
};
["sample_id","onEachFrame","testFunc"] call BIS_fnc_addStackedEventHandler;

Revision as of 01:50, 11 August 2021

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.
Groups:
Math - Geometry

Syntax

Syntax:
lineIntersectsSurfaces [begPosASL, endPosASL, ignoreObj1, ignoreObj2, sortMode, maxResults, LOD1, LOD2, returnUnique]
Parameters:
begPosASL: PositionASL - virtual line start
endPosASL: 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
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], ...] where:
  • 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

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 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; };

Additional Information

See also:
lineIntersectsWithlineIntersectsObjsterrainIntersectterrainIntersectASLterrainIntersectAtASLlineIntersectsintersectcursorObjectcursorTargetcheckVisibility

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


Posted on August 27, 2015 - 12:44 (UTC)
Killzone Kid
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) };
Posted on January 30, 2016 - 20:10 (UTC)
Pierre MGI
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.
Retrieved from "https://community.bistudio.com/wiki?title=lineIntersectsSurfaces&oldid=292878"