BIS_fnc_getIntersectionsUnderCursor

Description

Returns intersections under cursor. For more information see lineIntersectsSurfaces.

Syntax

[screenX, screenY, ignoreObj1, ignoreObj2, sortMode, maxResults, LOD1, LOD2] call BIS_fnc_getIntersectionsUnderCursor

Parameters:

• screenX: Number - (Optional, default 0) cursor's X position - see screenToWorld

• screenY: Number - (Optional, default 0) cursor's Y position - see screenToWorld

• 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"
  • Arma 3 v2.02 "PHYSX" - PhysX geometry LOD
  • Arma 3 v2.08 "ROADWAY" - only works from the top (since arma3 1.52)

• LOD2: String - (Optional, default "FIRE") secondary LOD to look for intersection. See LOD1 for possible values (since arma3 1.52)

Returns: 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 v2.10 selectionNames: Array of Strings - Names of the intersected selections (bones). Returns [] if there is no intersection with a selection.
• Arma 3 v2.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"

Examples

Example 1

[0.5, 0.5, player, objNull, true, "VIEW"] call BIS_fnc_getIntersectionsUnderCursor;

See also

lineIntersectsSurfaces