lineIntersectsObjs: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Arma[ _]3(\|.*)\]\]" to "{{GameCategory|arma3|Scripting Commands}}")
m (Text replacement - "_{10,} " to "")
Line 1: Line 1:
{{Command|Comments=
{{Command|Comments=
____________________________________________________________________________________________


| arma3 |Game name=
| arma3 |Game name=
Line 7: Line 6:


|gr1= Math - Geometry |GROUP1=
|gr1= Math - Geometry |GROUP1=
____________________________________________________________________________________________


| Returns list of objects intersected by given line from ''begPos'' to ''endPos''. |DESCRIPTION=
| Returns list of objects intersected by given line from ''begPos'' to ''endPos''. |DESCRIPTION=
____________________________________________________________________________________________


| '''lineIntersectsObjs''' [begPos, endPos, withObj, ignoreObj, sortByDistance, flags] |SYNTAX=
| '''lineIntersectsObjs''' [begPos, endPos, withObj, ignoreObj, sortByDistance, flags] |SYNTAX=
Line 29: Line 26:


| [[Array]] of [[Object|Objects]] - intersecting objects |RETURNVALUE=
| [[Array]] of [[Object|Objects]] - intersecting objects |RETURNVALUE=
____________________________________________________________________________________________
|x1= <code>Sto = [];
|x1= <code>Sto = [];
Fn = {
Fn = {
Line 46: Line 42:
["sample_id","onEachFrame","Fn"] [[call]] [[BIS_fnc_addStackedEventHandler]];
["sample_id","onEachFrame","Fn"] [[call]] [[BIS_fnc_addStackedEventHandler]];
//Example display objects' array in the middle of the screen sorted by 6 flags</code>|EXAMPLE1=  
//Example display objects' array in the middle of the screen sorted by 6 flags</code>|EXAMPLE1=  
____________________________________________________________________________________________


| [[lineIntersectsSurfaces]], [[lineIntersectsWith]], [[terrainIntersect]], [[terrainIntersectASL]], [[terrainIntersectAtASL]], [[lineIntersects]], [[intersect]], [[cursorObject]], [[cursorTarget]], [[checkVisibility]] |SEEALSO=
| [[lineIntersectsSurfaces]], [[lineIntersectsWith]], [[terrainIntersect]], [[terrainIntersectASL]], [[terrainIntersectAtASL]], [[lineIntersects]], [[intersect]], [[cursorObject]], [[cursorTarget]], [[checkVisibility]] |SEEALSO=

Revision as of 02:51, 17 January 2021

Hover & click on the images for description

Description

Description:
Returns list of objects intersected by given line from begPos to endPos.
Groups:
Math - Geometry

Syntax

Syntax:
lineIntersectsObjs [begPos, endPos, withObj, ignoreObj, sortByDistance, flags]
Parameters:
begPos: PositionASL - virtual line start
endPos: PositionASL - virtual line end
withObj: Object
ignoreObj: Object
sortByDistance: Boolean - true: furthest object first, closest object last; false: unsorted
flags: Number
1 - CF_ONLY_WATER
2 - CF_NEAREST_CONTACT
4 - CF_ONLY_STATIC
8 - CF_ONLY_DYNAMIC
16 - CF_FIRST_CONTACT
32 - CF_ALL_OBJECTS (Usable only with CF_FIRST_CONTACT and it will check one contact per object)
Flags can be combined: 2 + 4 = 6 is CF_NEAREST_OBJECT + CF_ONLY_STATIC
Return Value:
Array of Objects - intersecting objects

Examples

Example 1:
Sto = []; Fn = { { Sto set [_foreachindex,lineIntersectsObjs [(eyePos player),(ATLtoASL screenToWorld [0.5,0.5]),objNull,objNull,false,_x]]; } forEach [1,2,4,8,16,32]; hintSilent format [" ONLY_WATER: %1, NEAREST_CONTACT: %2, ONLY_STATIC: %3, ONLY_DYNAMIC: %4, FIRST_CONTACT: %5, ALL_OBJECTS: %6", Sto select 0,Sto select 1,Sto select 2,Sto select 3,Sto select 4,Sto select 5]; }; ["sample_id","onEachFrame","Fn"] call BIS_fnc_addStackedEventHandler; //Example display objects' array in the middle of the screen sorted by 6 flags

Additional Information

See also:
lineIntersectsSurfaceslineIntersectsWithterrainIntersectterrainIntersectASLterrainIntersectAtASLlineIntersectsintersectcursorObjectcursorTargetcheckVisibility

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


Bottom Section

Posted on March 29, 2016 - 05:07 (UTC)
AgentRev
Distance sorting is relative to object model center, and not intersect position.