doSuppressiveFire: Difference between revisions

Latest revision as of 15:23, 8 November 2023

Hover & click on the images for description

Description

Description:

Orders the given unit or a group of units to suppress the given position or target (without radio messages, see commandSuppressiveFire is you need messages).

When an Array of units is passed as param, only units from the same Group as the first unit in array are considered.
The unit (units) starts firing at the given target or position random amount of shots (exact formula unknown, but seems to depend on amount of ammo unit has) after which it stops.
currentCommand shows "Suppress" and there is no way of stopping unit before it completes random amount of rounds.
If position is passed as target param, it stays fixed.
If object is passed as target param, it depends on what kind of object. If it is considered a proper target by the unit, it is tracked by the unit dynamically. If it is not, the position gets obtained via getPosWorld, which could be different from PositionASL of the object, and it is fixed even if the target is able to change position later.

Groups:

Unit Control

Syntax

Syntax:: unit doSuppressiveFire target
Parameters:: unit: Object or Array - a single unit or array of units
: target: Object or Array - actual target or position of the target in format PositionASL
Return Value:: Nothing

Examples

Example 1:: _soldier doSuppressiveFire [1869.508,5760.962,0.000];
Example 2:: units player doSuppressiveFire cursorTarget;

Additional Information

See also:: suppressFor fire doFire commandFire canFire fireAtTarget forceWeaponFire commandArtilleryFire commandSuppressiveFire doArtilleryFire isManualFire

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

@@ Line 1: / Line 1: @@
-{{Command|= Comments
+{{RV|type=command
-____________________________________________________________________________________________
-| arma3 |= Game name
+|game1= arma3
-|1.60|= Game version
+|version1= 1.60
-|arg= local |= Arguments in MP
-|eff= local |= Effects in MP
-____________________________________________________________________________________________
-| Orders the given unit to suppress a given position or target (without radio messages). The unit starts firing at the given position random amount of shots (to be determined) after which it stops. [[currentCommand]] shows <tt>"Suppress"</tt> and there is no way of stopping unit before it completes random amount of rounds. The position at which unit fires is fixed. When object is passed as position, the position is obtained via [[getPosWorld]] and could be different from [[PositionASL]] of the object. |DESCRIPTION=
+|arg= local
-____________________________________________________________________________________________
-| unitName '''doSuppressiveFire''' target |SYNTAX=
+|eff= global
-|p1= unitName: [[Object]]|PARAMETER1=
+|gr1= Unit Control
-|p2= target: [[Object]] or [[Array]] in format [[PositionASL]]. In case of [[Object]], [[getPosWorld]] of the object is used |PARAMETER2=
+|descr= Orders the given unit or a group of units to suppress the given position or target (without radio messages, see [[commandSuppressiveFire]] is you need messages).
+* When an [[Array]] of units is passed as param, only units from the same [[Group]] as the first unit in array are considered.
+* The unit (units) starts firing at the given target or position random amount of shots (exact formula unknown, but seems to depend on amount of ammo unit has) after which it stops.
+* [[currentCommand]] shows {{hl|"Suppress"}} and there is no way of stopping unit before it completes random amount of rounds.
+* If position is passed as target param, it stays fixed.
+* If object is passed as target param, it depends on what kind of object. If it is considered a proper target by the unit, it is tracked by the unit dynamically. If it is not, the position gets obtained via [[getPosWorld]], which could be different from [[Position#PositionASL|PositionASL]] of the object, and it is fixed even if the target is able to change position later.
-| [[Nothing]] |RETURNVALUE=
+|s1= unit [[doSuppressiveFire]]  target
-____________________________________________________________________________________________
-|x1= <code>_soldier [[doSuppressiveFire]] [1869.508,5760.962,0.000]
-</code> |EXAMPLE1=
-|x2= <code>_soldier [[doSuppressiveFire]] [[cursorTarget]]
-</code> |EXAMPLE2=
-____________________________________________________________________________________________
-|[[suppressFor]], [[fire]], [[doFire]], [[commandFire]], [[canFire]], [[fireAtTarget]], [[forceWeaponFire]], [[commandArtilleryFire]], [[commandSuppressiveFire]], [[doArtilleryFire]], [[isManualFire]] |SEEALSO=
+|p1= unit: [[Object]] or [[Array]] - a single unit or array of units
-}}
+|p2= target: [[Object]] or [[Array]] - actual target or position of the target in format [[Position#PositionASL|PositionASL]]
-<h3 style="display:none">Notes</h3>
+|r1= [[Nothing]]
-<dl class="command_description">
-<!-- Note Section BEGIN -->
-<!-- Note Section END -->
+|x1= <sqf>_soldier doSuppressiveFire [1869.508,5760.962,0.000];</sqf>
-</dl>
-<h3 style="display:none">Bottom Section</h3>
+|x2= <sqf>units player doSuppressiveFire cursorTarget;</sqf>
-[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
+|seealso= [[suppressFor]] [[fire]] [[doFire]] [[commandFire]] [[canFire]] [[fireAtTarget]] [[forceWeaponFire]] [[commandArtilleryFire]] [[commandSuppressiveFire]] [[doArtilleryFire]] [[isManualFire]]
+}}
-<!-- CONTINUE Notes -->
-<dl class="command_description">
-<dd class="notedate">Posted on October 8, 2016 - 16:19 (UTC)</dd>
-<dt class="note">[[User:Fett Li|Fett Li]]</dt>
-<dd class="note">
-Command expects position as second argument in format ASL in A3 1.64.138497.
-</dd>
-</dl>
-<!-- DISCONTINUE Notes -->