nearestObjects - Revision history

BrettMayson at 06:44, 2 January 2026

2026-01-02T06:44:39Z

← Older revision		Revision as of 08:44, 2 January 2026
Line 27:		Line 27:
	\|s1= [[nearestObjects]] [position, types, radius, 2Dmode]		\|s1= [[nearestObjects]] [position, types, radius, 2Dmode]

	\|p1= position: [[Object]] or ~~[[Array]] format~~ [[Position#PositionAGL\|PositionAGL]] or [[Position#Introduction\|Position2D]] - where to find objects, center position.		\|p1= position: [[Object]] or [[Position#PositionAGL\|PositionAGL]] or [[Position#Introduction\|Position2D]] - where to find objects, center position.

	\|p2= types: [[Array]] - list of class name of the objects to search for. Use an empty array <sqf inline>[]</sqf> to search for all classes.		\|p2= types: [[Array]] - list of class name of the objects to search for. Use an empty array <sqf inline>[]</sqf> to search for all classes.

BrettMayson at 06:36, 2 January 2026

2026-01-02T06:36:54Z

← Older revision		Revision as of 08:36, 2 January 2026
Line 27:		Line 27:
	\|s1= [[nearestObjects]] [position, types, radius, 2Dmode]		\|s1= [[nearestObjects]] [position, types, radius, 2Dmode]

	\|p1= position: [[Object]] or [[Array]] in format [[Position#PositionAGL\|PositionAGL]] or [[Position#Introduction\|Position2D]] - where to find objects, center position.		\|p1= position: [[Object]] or [[Array]] format [[Position#PositionAGL\|PositionAGL]] or [[Position#Introduction\|Position2D]] - where to find objects, center position.

	\|p2= types: [[Array]] - list of class name of the objects to search for. Use an empty array <sqf inline>[]</sqf> to search for all classes.		\|p2= types: [[Array]] - list of class name of the objects to search for. Use an empty array <sqf inline>[]</sqf> to search for all classes.

BrettMayson at 09:54, 1 January 2026

2026-01-01T09:54:47Z

← Older revision		Revision as of 11:54, 1 January 2026
Line 36:		Line 36:
	\|p5since= arma3 1.66		\|p5since= arma3 1.66

	\|r1= [[Array]] ~~- array~~ of ~~objects~~		\|r1= [[Array]] of [[Object]]s

	\|x1= <sqf>nearestObjects [player, ["Car", "Tank"], 200];</sqf>		\|x1= <sqf>nearestObjects [player, ["Car", "Tank"], 200];</sqf>

Lou Montana: Fix author

2024-05-04T22:13:41Z

Fix author

← Older revision		Revision as of 00:13, 5 May 2024
Line 83:		Line 83:

	{{Note		{{Note
	\|user= ~~AgentRev~~		\|user= AgentRev01
	\|timestamp= 20140322023800		\|timestamp= 20140322023800
	\|text= The distance from which an object is determined to be inside the radius is calculated from its model center (object modelToWorld [0,0,0]), and not the position returned by getPos/ATL/ASL. If an object is used as the origin from which to scan, distance is calculated from its model center as well.		\|text= The distance from which an object is determined to be inside the radius is calculated from its model center (object modelToWorld [0,0,0]), and not the position returned by getPos/ATL/ASL. If an object is used as the origin from which to scan, distance is calculated from its model center as well.

Lou Montana: Text replacement - "Killzone Kid" to "Killzone_Kid"

2024-03-12T12:48:31Z

Text replacement - "Killzone Kid" to "Killzone_Kid"

← Older revision		Revision as of 14:48, 12 March 2024
Line 89:		Line 89:

	{{Note		{{Note
	\|user= ~~Killzone Kid~~		\|user= Killzone_Kid
	\|timestamp= 20141026151500		\|timestamp= 20141026151500
	\|text= Return all trees in 100m radius around player:		\|text= Return all trees in 100m radius around player:
Line 109:		Line 109:

	{{Note		{{Note
	\|user= ~~Killzone Kid~~		\|user= Killzone_Kid
	\|timestamp= 20160108121400		\|timestamp= 20160108121400
	\|text= The first call to this command can take significantly longer than consecutive calls. But even after the objects in given radius were cached, the sorting this command performs could be quite expensive. For example to sort ~7000 object it might take up to 100ms. For performance reasons you can use [[nearObjects]] instead, which is basically the same command but without added sorting.		\|text= The first call to this command can take significantly longer than consecutive calls. But even after the objects in given radius were cached, the sorting this command performs could be quite expensive. For example to sort ~7000 object it might take up to 100ms. For performance reasons you can use [[nearObjects]] instead, which is basically the same command but without added sorting.
Line 126:		Line 126:

	{{Note		{{Note
	\|user= ~~Killzone Kid~~		\|user= Killzone_Kid
	\|timestamp= 20161031003200		\|timestamp= 20161031003200
	\|text= Since {{arma3}} v1.66 the default sorting is done according to 3D distance not [[distance2D]] as before. This is an attempt to correct some very old bug in implementation.		\|text= Since {{arma3}} v1.66 the default sorting is done according to 3D distance not [[distance2D]] as before. This is an attempt to correct some very old bug in implementation.
	}}		}}

Lou Montana: Text replacement - "er then " to "er than "

2023-12-11T09:33:16Z

Text replacement - "er then " to "er than "

← Older revision		Revision as of 11:33, 11 December 2023
Line 111:		Line 111:
	\|user= Killzone Kid		\|user= Killzone Kid
	\|timestamp= 20160108121400		\|timestamp= 20160108121400
	\|text= The first call to this command can take significantly longer ~~then~~ consecutive calls. But even after the objects in given radius were cached, the sorting this command performs could be quite expensive. For example to sort ~7000 object it might take up to 100ms. For performance reasons you can use [[nearObjects]] instead, which is basically the same command but without added sorting.		\|text= The first call to this command can take significantly longer than consecutive calls. But even after the objects in given radius were cached, the sorting this command performs could be quite expensive. For example to sort ~7000 object it might take up to 100ms. For performance reasons you can use [[nearObjects]] instead, which is basically the same command but without added sorting.
	}}		}}

Lou Montana: Text replacement - "(\|[pr][0-9]+ = [^- ]) - *W([a-z ])" to "$1 - w$2"

2023-11-08T15:35:13Z

Text replacement - "(\|[pr][0-9]+ *= *[^- ]*) *- *W([a-z ])" to "$1 - w$2"

← Older revision		Revision as of 17:35, 8 November 2023
Line 27:		Line 27:
	\|s1= [[nearestObjects]] [position, types, radius, 2Dmode]		\|s1= [[nearestObjects]] [position, types, radius, 2Dmode]

	\|p1= position: [[Object]] or [[Array]] in format [[Position#PositionAGL\|PositionAGL]] or [[Position#Introduction\|Position2D]] - ~~Where~~ to find objects, center position.		\|p1= position: [[Object]] or [[Array]] in format [[Position#PositionAGL\|PositionAGL]] or [[Position#Introduction\|Position2D]] - where to find objects, center position.

	\|p2= types: [[Array]] - list of class name of the objects to search for. Use an empty array <sqf inline>[]</sqf> to search for all classes.		\|p2= types: [[Array]] - list of class name of the objects to search for. Use an empty array <sqf inline>[]</sqf> to search for all classes.

Lou Montana: Text replacement - "(\|[pr][0-9]+ = [^- ]) - *R([a-z ])" to "$1 - r$2"

2023-11-08T14:47:18Z

Text replacement - "(\|[pr][0-9]+ *= *[^- ]*) *- *R([a-z ])" to "$1 - r$2"

← Older revision		Revision as of 16:47, 8 November 2023
Line 31:		Line 31:
	\|p2= types: [[Array]] - list of class name of the objects to search for. Use an empty array <sqf inline>[]</sqf> to search for all classes.		\|p2= types: [[Array]] - list of class name of the objects to search for. Use an empty array <sqf inline>[]</sqf> to search for all classes.

	\|p3= radius: [[Number]] - ~~Range~~ from center position to search for objects.		\|p3= radius: [[Number]] - range from center position to search for objects.

	\|p5= 2Dmode: [[Boolean]] - (Optional, default [[false]]) [[true]] for 2D distance, [[false]] for 3D distance		\|p5= 2Dmode: [[Boolean]] - (Optional, default [[false]]) [[true]] for 2D distance, [[false]] for 3D distance

Lou Montana: Text replacement - "(\|[pr][0-9]+ = [^- ]) - *L([a-z ])" to "$1 - l$2"

2023-11-08T14:38:17Z

Text replacement - "(\|[pr][0-9]+ *= *[^- ]*) *- *L([a-z ])" to "$1 - l$2"

← Older revision		Revision as of 16:38, 8 November 2023
Line 29:		Line 29:
	\|p1= position: [[Object]] or [[Array]] in format [[Position#PositionAGL\|PositionAGL]] or [[Position#Introduction\|Position2D]] - Where to find objects, center position.		\|p1= position: [[Object]] or [[Array]] in format [[Position#PositionAGL\|PositionAGL]] or [[Position#Introduction\|Position2D]] - Where to find objects, center position.

	\|p2= types: [[Array]] - ~~List~~ of class name of the objects to search for. Use an empty array <sqf inline>[]</sqf> to search for all classes.		\|p2= types: [[Array]] - list of class name of the objects to search for. Use an empty array <sqf inline>[]</sqf> to search for all classes.

	\|p3= radius: [[Number]] - Range from center position to search for objects.		\|p3= radius: [[Number]] - Range from center position to search for objects.

Killzone Kid at 10:34, 9 September 2022

2022-09-09T10:34:58Z

← Older revision		Revision as of 12:34, 9 September 2022
Line 23:		Line 23:
	{{Feature \| important \| This command matches objects using [[isKindOf]] comparison instead of direct class name [[==]] comparison. As a result, if a class type is a parent, the search will return all objects that inherit from the parent as well as parent itself. This command also only finds objects that are '''[[entities]]'''. If you are looking for non-entity objects, see [[nearObjects]], [[nearestObject]].}}		{{Feature \| important \| This command matches objects using [[isKindOf]] comparison instead of direct class name [[==]] comparison. As a result, if a class type is a parent, the search will return all objects that inherit from the parent as well as parent itself. This command also only finds objects that are '''[[entities]]'''. If you are looking for non-entity objects, see [[nearObjects]], [[nearestObject]].}}

	{{Feature \| warning \| Because of map object streaming, using [[nearestObjects]] or similar object finding commands over long distance from player camera may not find what you are looking for, as some objects might not exist at the time of command execution. }}		{{Feature \| warning \| Because of map object streaming, using [[nearestObjects]] or similar object finding commands over long distance from player camera may not find what you are looking for, as some objects might not exist at the time of command execution. Use [[nearestTerrainObjects]] instead. }}

	\|s1= [[nearestObjects]] [position, types, radius, 2Dmode]		\|s1= [[nearestObjects]] [position, types, radius, 2Dmode]