damage: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " <h3 style="display:none">Notes</h3> <dl class="command_description"> <!-- Note Section BEGIN --> <!-- Note Section END --> </dl> " to "")
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...)
Line 1: Line 1:
{{Command|Comments=
{{Command


| ofp |Game name=
| ofp


|1.5|Game version=
|1.5


|arg= global |Multiplayer Arguments=
|arg= global


|gr1= Object Manipulation |GROUP1=
|gr1= Object Manipulation


| Return the damage value of an object. |DESCRIPTION=
| Return the damage value of an object.


| [[damage]] object |SYNTAX=
| [[damage]] object


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


| [[Number]] - the returned number in range (healthy) 0..1 (dead). |RETURNVALUE=
| [[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> |EXAMPLE1=
|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]] {
|x2= <code>[[if]] (([[damage]] [[player]]) [[a_greater_b|>]] 0.1) [[then]] {
     [[player]] [[groupChat]] "I'm hurt! Medic!";
     [[player]] [[groupChat]] "I'm hurt! Medic!";
};</code> |EXAMPLE2=
};</code>
|x3= <code>[[private]] _health = (1 - [[damage]] [[player]]) * 100; {{cc|Health in % from 0 to 100}}</code> |EXAMPLE3=
|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]] |SEEALSO=
| [[setDamage]], [[setHit]], [[getHit]], [[getHitIndex]], [[setHitIndex]], [[getHitPointDamage]], [[setHitPointDamage]], [[Arma 3: Event Handlers#HandleDamage|"HandleDamage" Event Handler]]
}}
}}


Revision as of 01:28, 18 January 2021

Logo A0.png1.5
GAGlobal
Hover & click on the images for description

Description

Description:
Return the damage value of an object.
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:
setDamagesetHitgetHitgetHitIndexsetHitIndexgetHitPointDamagesetHitPointDamage"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

Bottom Section

Posted on February 13, 2015 - 20:20 (UTC)
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.
Retrieved from "https://community.bistudio.com/wiki?title=damage&oldid=204468"