canFire: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Text replacement - "<sqf>([^↵][^\/]*↵[^\/]*)<\/sqf>" to "<sqf> $1 </sqf>")
 
(83 intermediate revisions by 16 users not shown)
Line 1: Line 1:
[[Category:Scripting Commands|C]]
{{RV|type=command
[[Category:Scripting Commands OFP 1.97|C]]
[[Category:Scripting Commands OFP 1.46|C]]
[[Category:Scripting Commands ArmA|C]]


back to [[Scripting_Reference#C|COMREF]]
|game1= ofp
|version1= 1.00


<h2 style="color:#000066"> '''canFire ''vehicle'''''</h2>
|game2= ofpe
|version2= 1.00


|game3= arma1
|version3= 1.00


'''Operand types:'''
|game4= arma2
|version4= 1.00


'''vehicle:''' [[Object]]
|game5= arma2oa
|version5= 1.50


'''Type of returned value:'''
|game6= tkoh
|version6= 1.00


[[Boolean]]
|game7= arma3
|version7= 0.50


'''Description:'''
|arg= global


Check if given '''vehicle''' is able to fire.
|gr1= Weapons


Does not check for ammo, only for damage.
|descr= Returns [[true]] if the given vehicle is still able to fire. For the command to return [[true]], vehicle must be alive, have weapon operator and the weapon cannot be damaged &ge; 0.9 but can be empty due to running out of ammo. If mission starts with vehicle having no ammo or [[setVehicleAmmo]] 0 command is executed on the vehicle, then [[canFire]] will always report [[false]] for it.


|s1= [[canFire]] unitName


'''Example:'''
|p1= unitName: [[Object]]


? '''canFire''' ([[vehicle]] [[player]]) : [[goto]] "target"
|r1= [[Boolean]] - [[true]] if able to fire
 
|x1= <sqf>
if (not canFire _tank) then
{
player sideChat "Tank disabled!";
};
</sqf>
 
|seealso= [[canMove]] [[canStand]] [[fire]] [[doFire]] [[commandFire]] [[fireAtTarget]] [[forceWeaponFire]] [[commandArtilleryFire]] [[commandSuppressiveFire]] [[doArtilleryFire]] [[doSuppressiveFire]] [[isManualFire]]
}}
 
<dl class="command_description">
 
<dt></dt>
<dd class="notedate">Posted on 07:16, 20 January 2007 (CEST)</dd>
<dt class="note">[[User:Bdfy|Bdfy]]</dt>
<dd class="note">
true even if unit is out of ammo. Only false if gun is damaged.
<dt><dt>
<dd class="notedate">Posted on 05:20, 24 August 2008 (CEST)</dd>
<dt class="note">[[User:Canukausiuka|Canukausiuka]]</dt>
<dd class="note">
False if there is no gunner in the vehicle, regardless of damage level.
<dt><dt>
<dd class="notedate">Posted on 07:20, 23 April 2018 (UTC)</dd>
<dt class="note">[[User:Pierre MGI|Pierre MGI]]</dt>
<dd class="note">
This command seems to have evolved. Returns "true" (on Hunter, Ifrit) even if Gun's damage is set to 1 and turret also, as far there is a gunner. The only way to obtain a canFire  "false"  is to make the crew disembark (2 burned tires for example). Then no matter the gun state, if the gunner disembarks without order, the vehicle can't fire. In this case: can't move >> can't fire.
NB: if you jump into a hunter HMG after having [[setHitPointDamage]](d) "hitTurret" and "hitGun"  to 1, the turret can't rotate any more, the gun is pitched down but you can fire (trigger) to the ground. Difficult to check the behavior for each vehicles.</dl>

Latest revision as of 11:28, 3 September 2024

Hover & click on the images for description

Description

Description:
Returns true if the given vehicle is still able to fire. For the command to return true, vehicle must be alive, have weapon operator and the weapon cannot be damaged ≥ 0.9 but can be empty due to running out of ammo. If mission starts with vehicle having no ammo or setVehicleAmmo 0 command is executed on the vehicle, then canFire will always report false for it.
Groups:
Weapons

Syntax

Syntax:
canFire unitName
Parameters:
unitName: Object
Return Value:
Boolean - true if able to fire

Examples

Example 1:
if (not canFire _tank) then { player sideChat "Tank disabled!"; };

Additional Information

See also:
canMove canStand fire doFire commandFire fireAtTarget forceWeaponFire commandArtilleryFire commandSuppressiveFire doArtilleryFire doSuppressiveFire 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
Posted on 07:16, 20 January 2007 (CEST)
Bdfy
true even if unit is out of ammo. Only false if gun is damaged.
Posted on 05:20, 24 August 2008 (CEST)
Canukausiuka
False if there is no gunner in the vehicle, regardless of damage level.
Posted on 07:20, 23 April 2018 (UTC)
Pierre MGI
This command seems to have evolved. Returns "true" (on Hunter, Ifrit) even if Gun's damage is set to 1 and turret also, as far there is a gunner. The only way to obtain a canFire "false" is to make the crew disembark (2 burned tires for example). Then no matter the gun state, if the gunner disembarks without order, the vehicle can't fire. In this case: can't move >> can't fire. NB: if you jump into a hunter HMG after having setHitPointDamage(d) "hitTurret" and "hitGun" to 1, the turret can't rotate any more, the gun is pitched down but you can fire (trigger) to the ground. Difficult to check the behavior for each vehicles.