isAwake: Difference between revisions

Latest revision as of 01:01, 4 April 2024

Hover & click on the images for description

Description

Description:

Returns resting state of a PhysX (EPE) object. Some EPE objects are deliberately put to sleep by the engine to save resources. This command returns true when object is simulating and false when it is put to sleep. With units of type Man the behaviour is slightly different. As units never get put to sleep, the command outputs ragdoll state of a unit instead. There are 6 states for the output of the command:

EPE object is simulating - true
EPE object is put to sleep - false
Unit is alive, ragdoll is active - false
Unit is alive, ragdoll is NOT active - true
2.10 Unit is NOT alive, ragdoll is active - true
2.10 Unit is NOT alive, ragdoll is NOT active - false

Groups:

Object Manipulation

Syntax

Syntax:: isAwake object
Parameters:: object: Object - PhysX object or unit
Return Value:: Boolean - see description

Examples

Example 1:: private _isAwake = isAwake _object;
Example 2:: 2.10 Here is a simple formula to return ragdoll state of a unit:
private _unitIsInRagdoll = alive _unit != isAwake _unit;

Additional Information

See also:: awake addTorque addForce vectorModelToWorld vectorModelToWorldVisual selectionPosition

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 3: / Line 3: @@
 |game1= arma3
 |version1= 2.08
-|branch= dev
 |arg= global
@@ Line 10: / Line 9: @@
 |gr1= Object Manipulation
-|descr= Wakes up sleeping PhysX object or puts a PhysX object to sleep.
+|descr= Returns resting state of a PhysX (EPE) object. Some EPE objects are deliberately put to sleep by the engine to save resources.
-{{Feature | Informative | This command won't have lasing effect on vehicles as vehicles are actively simulated, but it works rather well on smaller PhysX enabled objects}}
+This command returns [[true]] when object is simulating and [[false]] when it is put to sleep. With units of type {{hl|Man}} the behaviour is slightly different.
-|s1= object [[awake]] awake
+As units never get put to sleep, the command outputs ragdoll state of a unit instead. There are 6 states for the output of the command:
+* EPE object is simulating - [[true]]
+* EPE object is put to sleep - [[false]]
+* Unit is [[alive]], ragdoll is active - [[false]]
+* Unit is [[alive]], ragdoll is NOT active - [[true]]
+* {{GVI|arma3|2.10|size= 0.75}} Unit is NOT [[alive]], ragdoll is active - [[true]]
+* {{GVI|arma3|2.10|size= 0.75}} Unit is NOT [[alive]], ragdoll is NOT active - [[false]]
-|p1= object: [[Object]] - PhysX object
+|s1= [[isAwake]] object
-|p2= awake: [[Boolean]] - [[true]] to awake the object, [[false]] - to put to sleep
+|p1= object: [[Object]] - PhysX object or unit
-|r1= [[Nothing]]
+|r1= [[Boolean]] - see description
-|x1= <code>_object [[awake]] [[false]];</code>
+|x1= <sqf>private _isAwake = isAwake _object;</sqf>
-|seealso= [[isAwake]] [[addTorque]] [[addForce]] [[vectorModelToWorld]] [[vectorModelToWorldVisual]] [[selectionPosition]]
+|x2= {{GVI|arma3|2.10|size= 0.75}} Here is a simple formula to return ragdoll state of a unit:
+<sqf>private _unitIsInRagdoll = alive _unit != isAwake _unit;</sqf>
+|seealso= [[awake]] [[addTorque]] [[addForce]] [[vectorModelToWorld]] [[vectorModelToWorldVisual]] [[selectionPosition]]
 }}