targetsQuery

Arma 3 v0.50
First in Arma 2 v1.00

Command · Markdown · JSON · original wiki page

Description

Returns sorted array of targets, known to the enquirer (including own troops), where the accuracy coefficient reflects how close the result matches the query. This command could be CPU intensive.

Syntax

enquirer targetsQuery [targetIgnore, targetSide, targetType, targetPosition, targetMaxAge]

Parameters:

enquirer: Object - for whom the query will be made
targetIgnore: Object - target object to exclude from results. objNull - return every target
targetSide: Side - desired side of the target. sideUnknown - any side
targetType: String - desired target typeOf. "" - any type
targetPosition: Position2D or Position3D - desired target position (only [x,y] is considered). Position tolerance is 200m from the actual position of the target. [] - any position
targetMaxAge: Number - desired max age of the target. This will limit returned results to the targets younger than specified age. 0 - any age

Returns: Array of Arrays with [accuracy, target, targetSide, targetType, targetPosition, targetAge]

accuracy: Number in range 0..1 - a coefficient, which reflects how close the returned result to the query filter. (1 - best match)
target: Object - the actual target object
targetSide: Side - side of the target
targetType: String - target typeOf
targetPosition: Array - [x,y] of the target
targetAge: Number - the actual target age in seconds (can be negative)

Examples

Example 1

Return all known targets for player:

_targets = player targetsQuery [objNull, sideUnknown, "", [], 0];

Example 2

Prioritise all known OPFOR targets and return targets less than 10 seconds old:

_targets = player targetsQuery [objNull, east, "", [], 10];