incapacitatedState: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|= Comments" to "|Comments=")
m (Text replacement - ">Posted on December ([0-9]{2})[ a-zA-Z]*, ([0-9]{4})" to ">Posted on $2-12-$1")
 
(38 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma3 |Game name=
|game1= arma3
|version1= 1.00


|1.00|= Game version
|gr1= Object Manipulation
____________________________________________________________________________________________


| Returns the incapacitated state of the given unit. |DESCRIPTION=
|descr= Returns the incapacitated sub-state of the given unit, when the [[lifeState]] of the unit is "INCAPACITATED". Could be one of:
____________________________________________________________________________________________
* "UNCONSCIOUS"
* "MOVING"
* "SHOOTING"


| '''incapacitatedState''' person |SYNTAX=
|s1= [[incapacitatedState]] person


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


| [[String]] |RETURNVALUE=
|r1= [[String]] - incapacitated sub-state (see description) or empty string ""


|x1= <sqf>_result = incapacitatedState player;</sqf>


|x1= <code>_result = incapacitatedState player;</code> |EXAMPLE1=
|seealso= [[setUnconscious]] [[lifeState]]
 
____________________________________________________________________________________________
 
|  |SEEALSO=
 
|  |MPBEHAVIOUR=
____________________________________________________________________________________________
}}
}}


<h3 style='display:none'>Notes</h3>
<dl class="command_description">
<dl class='command_description'>
<!-- Note Section BEGIN -->


<!-- Note Section END -->
<dt></dt>
</dl>
<dd class="notedate">Posted on 2018-07-18 - 02:53 (UTC)</dd>
 
<h3 style='display:none'>Bottom Section</h3>
[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on July 18, 2018 - 02:53 (UTC)</dd>
<dt class="note">[[User:HazJ|HazJ]]</dt>
<dt class="note">[[User:HazJ|HazJ]]</dt>
<dd class="note">
<dd class="note">
This command returns "SHOOTING" (intentional behaviour?) when checking a unit's state while they are unconscious. Tested with BIS revive. I recommend just using the lifeState command instead.
This command returns "SHOOTING" (intentional behaviour?) when checking a unit's state while they are unconscious. Tested with BIS revive. I recommend just using the lifeState command instead.
</dd>
</dd>
<dt><dt>
<dd class="notedate">Posted on 2019-12-29 - 21:13 (UTC)</dd>
<dt class="note">[[User:Tankbuster|Tankbuster]]</dt>
<dd class="note">
Returns
"UNCONSCIOUS" when awaiting revive.
"" when alive or when awaiting respawn. This means that when a unit dies instantly, ie through drowning, this command will return empty string throughout. As Haz says above, it sometimes show "SHOOTING" when the player is unconscious for reasons that are not clear.
</dd>
</dl>
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 23:13, 13 May 2023

Hover & click on the images for description

Description

Description:
Returns the incapacitated sub-state of the given unit, when the lifeState of the unit is "INCAPACITATED". Could be one of:
  • "UNCONSCIOUS"
  • "MOVING"
  • "SHOOTING"
Groups:
Object Manipulation

Syntax

Syntax:
incapacitatedState person
Parameters:
person: Object
Return Value:
String - incapacitated sub-state (see description) or empty string ""

Examples

Example 1:
_result = incapacitatedState player;

Additional Information

See also:
setUnconscious lifeState

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 2018-07-18 - 02:53 (UTC)
HazJ
This command returns "SHOOTING" (intentional behaviour?) when checking a unit's state while they are unconscious. Tested with BIS revive. I recommend just using the lifeState command instead.
Posted on 2019-12-29 - 21:13 (UTC)
Tankbuster
Returns "UNCONSCIOUS" when awaiting revive. "" when alive or when awaiting respawn. This means that when a unit dies instantly, ie through drowning, this command will return empty string throughout. As Haz says above, it sometimes show "SHOOTING" when the player is unconscious for reasons that are not clear.