targetsQuery: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "\| *((\[\[[a-zA-Z0-9_ |()]+\]\],? ?)+) * \}\}" to "|seealso= $1 }}") |
Lou Montana (talk | contribs) m (Text replacement - "(\|[pr][0-9]+ *= *[^- ]*) *- *T([a-z ])" to "$1 - t$2") |
||
| (28 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
{{RV|type=command | {{RV|type=command | ||
| arma2 | |game1= arma2 | ||
|version1= 1.00 | |||
|1.00 | |game2= arma2oa | ||
|version2= 1.50 | |||
|game3= tkoh | |||
|version3= 1.00 | |||
|game4= arma3 | |||
|version4= 0.50 | |||
|gr1= Object Detection | |gr1= Object Detection | ||
| 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. | |descr= 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. | ||
|s1= enquirer [[targetsQuery]] [targetIgnore, targetSide, targetType, targetPosition, targetMaxAge] | |||
| enquirer | |p1= enquirer: [[Object]] - for whom the query will be made | ||
| | |p2= targetIgnore: [[Object]] - target object to exclude from results. [[objNull]] - return every target | ||
| | |p3= targetSide: [[Side]] - desired side of the target. [[sideUnknown]] - any side | ||
|p4= targetType: [[String]] - desired target [[typeOf]]. "" - any type | |||
|p4 | |||
| [[Array]] - '''sorted''' array of returned targets in the following format: | |p5= targetPosition: [[Array]] - desired target position in format of [[Position#Introduction|Position2D]] or [[Position#Introduction|Position3D]] (only [x,y] is considered). Position tolerance is 200m from the actual position of the target. [] - any position | ||
|p6= targetMaxAge: [[Number]] - desired max age of the target. This will limit returned results to the targets younger than specified age. 0 - any age | |||
|r1= [[Array]] - '''sorted''' array of returned targets in the following format: | |||
<nowiki>[</nowiki>[accuracy, target, targetSide, targetType, targetPosition, targetAge],...] where: | <nowiki>[</nowiki>[accuracy, target, targetSide, targetType, targetPosition, targetAge],...] where: | ||
* accuracy: [[Number]] - a coefficient, which reflects how close the returned result to the query filter. Range: 0 - 1 (1 - best match) | * accuracy: [[Number]] - a coefficient, which reflects how close the returned result to the query filter. Range: 0 - 1 (1 - best match) | ||
| Line 30: | Line 40: | ||
* targetAge: [[Number]] - the actual target age in seconds (can be negative) | * targetAge: [[Number]] - the actual target age in seconds (can be negative) | ||
|x1= Return all known targets for player:< | |x1= Return all known targets for player: | ||
|x2= Prioritise all known OPFOR targets and return targets less than 10 seconds old:< | <sqf>_targets = player targetsQuery [objNull, sideUnknown, "", [], 0];</sqf> | ||
|x2= Prioritise all known OPFOR targets and return targets less than 10 seconds old: | |||
<sqf>_targets = player targetsQuery [objNull, east, "", [], 10];</sqf> | |||
|seealso= [[targetsAggregate]] | |seealso= [[targets]] [[nearTargets]] [[targetsAggregate]] [[targetKnowledge]] [[knowsAbout]] [[reveal]] [[forgetTarget]] [[setTargetAge]] [[getHideFrom]] | ||
}} | }} | ||
Latest revision as of 15:50, 8 November 2023
Description
- 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.
- Groups:
- Object Detection
Syntax
- 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: Array - desired target position in format of Position2D or Position3D (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
- Return Value:
- Array - sorted array of returned targets in the following format:
[[accuracy, target, targetSide, targetType, targetPosition, targetAge],...] where:
- accuracy: Number - a coefficient, which reflects how close the returned result to the query filter. Range: 0 - 1 (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:
- Example 2:
- Prioritise all known OPFOR targets and return targets less than 10 seconds old:
Additional Information
- See also:
- targets nearTargets targetsAggregate targetKnowledge knowsAbout reveal forgetTarget setTargetAge getHideFrom
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