nearestObjects: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Parameter fixing)
Line 29: Line 29:
____________________________________________________________________________________________
____________________________________________________________________________________________


| [[Array]] <nowiki>=</nowiki> '''nearestObjects''' position
| objects <nowiki>=</nowiki> '''nearestObjects''' [position, types, radius];


|p1= position: [[Array]] - see Description for Details. |=Parameter 1
|p1= position: [[Array]] or [[Object]] - Where to find objects, center position. |=Parameter 1
|p2= types: [[Array]] - List of class name of the objects to search for. |=Parameter 2
|p3= radius: [[Number]] - Range from center position to search for objects. |=Parameter 3


| [[Array]] |= Return value
| [[Array]] |= Return value

Revision as of 11:12, 10 August 2010

-wrong parameter ("Arma") defined!-1.00
Hover & click on the images for description

Description

Description:
Returns a list of nearest objects of the given types to the given position or object, within the specified distance. position can use the format: [[x,y,z], ["ClassName",...], radius] or [object, ["ClassName",...], radius] To use it without any ClassName filter: [object or position, [], radius]. A list of ClassName types (Tanks eg) can be found in CfgVehicles If more than one object is found they will be ordered according to their distance (i.e. the closest one will be first in the array).
Groups:
Uncategorised

Syntax

Syntax:
objects = nearestObjects [position, types, radius];
Parameters:
position: Array or Object - Where to find objects, center position.
types: Array - List of class name of the objects to search for.
radius: Number - Range from center position to search for objects.
Return Value:
Array

Examples

Example 1:
nearestObjects [player, ["Car","Tank"], 200]
Example 2:
nearestObjects [player, ["house"], 200]
Example 3:
nearestObjects [[2716,2949,0], ["Car","Truck"], 100]

Additional Information

See also:
nearestObjectnearObjects

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

Notes

Posted on unknown
Vigilante
To get a list with alive targets for various situations use this construct: _nearestTargets = nearestObjects [_submunScanPos, ["VBS2_TANK","TANK"], _scanArea]; _validNearestTargets = []; {if (alive _x) then {_validNearestTargets set [(count _validNearestTargets),_x];};} foreach _nearestTargets; results in _validNearestTargets being filled with targets == alive .. (you could use other conditions there, of course!) -- Vigilante
Posted on 10. Aug. 2010
Rübe
Passing an empty array to define the types will also return objects with no class at all (such as trees, bushes, stones, ...). Example: _objects = nearestObjects [_position, [], _radius]; Passing the array ["All"] is not the same and will only return objects that have some sort of class.

Bottom Section