damage: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " *\| *([Cc]omments|COMMENTS|Game|[Gg]ame [Nn]ame|Game [Vv]ersion|Game Version \(number surrounded by NO SPACES\)|Multiplayer Arguments( \("local" or "global"\))?|Effects|Multiplayer Effects( \("local" or "global"\))?|Multiplayer Exe...)
m (Text replacement - "\]\] +\[\[" to "]] [[")
 
(40 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Command
{{RV|type=command


| ofp
|game1= ofp


|1.5
|version1=
 
|game2= arma1
|version2= 1.00
 
|game3= arma2
|version3= 1.00
 
|game4= arma2oa
|version4= 1.50
 
|game5= tkoh
|version5= 1.00
 
|game6= arma3
|version6= 0.50


|arg= global
|arg= global
Line 9: Line 24:
|gr1= Object Manipulation
|gr1= Object Manipulation


| Return the damage value of an object.
|descr= Return the damage value of an object.
 
|alias= [[getDammage|getDammage<sup>sic</sup>]] <!-- cannot use {{sic}} here (counts it as alias link) -->


| [[damage]] object
|s1= [[damage]] object


|p1= object: [[Object]]
|p1= object: [[Object]]


| [[Number]] - the returned number in range (healthy) 0..1 (dead).
|r1= [[Number]] - the returned number in range (healthy) 0..1 (dead).
 
|x1= <code>[[?]] (([[damage]] [[player]]) [[a_greater_b|>]] 0.1) : [[player]] [[groupChat]] "I'm hurt! Medic!"</code>
|x2= <code>[[if]] (([[damage]] [[player]]) [[a_greater_b|>]] 0.1) [[then]] {
    [[player]] [[groupChat]] "I'm hurt! Medic!";
};</code>
|x3= <code>[[private]] _health = (1 - [[damage]] [[player]]) * 100; {{cc|Health in % from 0 to 100}}</code>


| [[setDamage]], [[setHit]], [[getHit]], [[getHitIndex]], [[setHitIndex]], [[getHitPointDamage]], [[setHitPointDamage]], [[Arma 3: Event Handlers#HandleDamage|"HandleDamage" Event Handler]]
|x1= <sqs>? damage player > 0.1 : player groupChat "I'm hurt! Medic!"</sqs>
}}


<h3 style="display:none">Bottom Section</h3>
|x2= <sqf>
if (damage player > 0.1) then
{
player groupChat "I'm hurt! Medic!";
};
</sqf>


[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
|x3= <sqf>private _health = (1 - damage player) * 100; // health in % from 0 to 100</sqf>
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
{{GameCategory|arma1|Scripting Commands}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}


<!-- CONTINUE Notes -->
|seealso= [[setDamage]] [[setHit]] [[getHit]] [[getHitIndex]] [[setHitIndex]] [[getHitPointDamage]] [[setHitPointDamage]] [[waterDamaged]] [[Arma 3: Event Handlers#HandleDamage|"HandleDamage" Event Handler]]
<dl class="command_description">
}}
<dd class="notedate">Posted on February 13, 2015 - 20:20 (UTC)</dd>
 
<dt class="note">[[User:Pierre MGI|Pierre MGI]]</dt>
{{Note
<dd class="note">
|user= Pierre MGI
The returned value depends on the couple target/ammo fired. This value has no correlation with the sum of all hitpoints damage status and the effective status of the object. Firing bullets on cars often lead to weird results. For example: [[damage]] returns zero while a Hunter is fired at will with an .50 HMG! Hunter can be almost destroyed with zero damage for this function. If you script, use instead the [[getHitPointDamage]] command.
|timestamp= 20150213202000
</dd>
|text= The returned value depends on the couple target/ammo fired. This value has no correlation with the sum of all hitpoints damage status and the effective status of the object.
</dl>
Firing bullets on cars often lead to weird results. For example: [[damage]] returns zero while a Hunter is fired at will with an .50 HMG! Hunter can be almost destroyed with zero damage for this function.
<!-- DISCONTINUE Notes -->
If you script, use instead the [[getHitPointDamage]] command.
}}

Latest revision as of 11:44, 5 May 2024

Hover & click on the images for description

Description

Description:
Return the damage value of an object.
Alias:
getDammagesic
Groups:
Object Manipulation

Syntax

Syntax:
damage object
Parameters:
object: Object
Return Value:
Number - the returned number in range (healthy) 0..1 (dead).

Examples

Example 1:
? damage player > 0.1 : player groupChat "I'm hurt! Medic!"
Example 2:
if (damage player > 0.1) then { player groupChat "I'm hurt! Medic!"; };
Example 3:
private _health = (1 - damage player) * 100; // health in % from 0 to 100

Additional Information

See also:
setDamage setHit getHit getHitIndex setHitIndex getHitPointDamage setHitPointDamage waterDamaged "HandleDamage" Event Handler

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
Pierre MGI - c
Posted on Feb 13, 2015 - 20:20 (UTC)
The returned value depends on the couple target/ammo fired. This value has no correlation with the sum of all hitpoints damage status and the effective status of the object. Firing bullets on cars often lead to weird results. For example: damage returns zero while a Hunter is fired at will with an .50 HMG! Hunter can be almost destroyed with zero damage for this function. If you script, use instead the getHitPointDamage command.