targets: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - " \{\{GameCategory *\| *arma3 *\| *(New )?Scripting Commands\}\}" to "") |
Lou Montana (talk | contribs) (Add default values) |
||
(14 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
{{RV|type=command | {{RV|type=command | ||
| arma3 | |game1= arma3 | ||
|version1= 1.70 | |||
|1.70 | |||
|arg= global | |arg= global | ||
Line 9: | Line 8: | ||
|gr1= Object Detection | |gr1= Object Detection | ||
| | |descr= Retrieves list of given unit targets matching specified filter. If the filter is not specified, all targets are returned. | ||
{{Feature|informative|If a unit is provided, the unit itself will be excluded from results. If a group is provided, its units will be excluded (even if renegades).}} | |||
|s1= unitOrGroup [[targets]] [enemyOnly, maxDistance, sides, maxAge, alternateCenter] | |||
| | |p1= unitOrGroup: [[Object]] or {{GVI|arma3|2.12|size= 0.75}} [[Group]] - unit or group which target knowledge is retrieved | ||
| | |p2= enemyOnly: [[Boolean]] - (Optional, default [[false]]) [[true]] to include only enemy targets, [[false]] to include all targets | ||
|p3= | |p3= maxDistance: [[Number]] - (Optional, default -1) maximum '''2D''' distance based on target's expected position; use 0 to ignore the filter | ||
|p4= | |p4= sides: [[Array]] - (Optional, default {{hl|[]}}) array of accepted sides; use {{hl|[]}} to ignore the side filter | ||
|p5= | |p5= maxAge: [[Number]] - (Optional, default 0) max. target age, targets that are known to unit for longer than maxAge are ignored; use 0 to ignore the maxAge filter | ||
|p6= | |p6= alternateCenter: [[Array]] - (Optional, default ''unitOrGroup''<nowiki/>'s position) alternate (2D or 3D) position used for '''2D''' distance check | ||
| | |r1= [[Array]] - ''unitOrGroup''<nowiki/>'s targets matching the criteria | ||
| | |x1= <sqf>private _targets = _unit targets [false, 300, [east, sideEnemy]]; // all targets of east or renegade side in 300m</sqf> | ||
|x2= <sqf>private _targets = _unit targets [true, 300]; // enemy targets in 300m</sqf> | |||
|x2= < | |||
|x3= < | |x3= <sqf>private _targets = _unit targets []; // all targets</sqf> | ||
|seealso= [[nearTargets]] | |seealso= [[targetsQuery]] [[nearTargets]] [[targetsAggregate]] [[targetKnowledge]] [[knowsAbout]] [[reveal]] [[forgetTarget]] [[setTargetAge]] [[getHideFrom]] [[side]] | ||
}} | }} |
Latest revision as of 22:20, 30 March 2024
Description
- Description:
- Retrieves list of given unit targets matching specified filter. If the filter is not specified, all targets are returned.
- Groups:
- Object Detection
Syntax
- Syntax:
- unitOrGroup targets [enemyOnly, maxDistance, sides, maxAge, alternateCenter]
- Parameters:
- unitOrGroup: Object or 2.12 Group - unit or group which target knowledge is retrieved
- enemyOnly: Boolean - (Optional, default false) true to include only enemy targets, false to include all targets
- maxDistance: Number - (Optional, default -1) maximum 2D distance based on target's expected position; use 0 to ignore the filter
- sides: Array - (Optional, default []) array of accepted sides; use [] to ignore the side filter
- maxAge: Number - (Optional, default 0) max. target age, targets that are known to unit for longer than maxAge are ignored; use 0 to ignore the maxAge filter
- alternateCenter: Array - (Optional, default unitOrGroup's position) alternate (2D or 3D) position used for 2D distance check
- Return Value:
- Array - unitOrGroup's targets matching the criteria
Examples
- Example 1:
- Example 2:
- Example 3:
Additional Information
- See also:
- targetsQuery nearTargets targetsAggregate targetKnowledge knowsAbout reveal forgetTarget setTargetAge getHideFrom side
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