awake

From Bohemia Interactive Community
Revision as of 11:40, 13 May 2022 by Killzone Kid (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Hover & click on the images for description

Description

Description:
Wakes up sleeping PhysX object or puts a PhysX object to sleep. In 2.10 this command can be used on corpses of type Man and has no effect on alive units. When unit gets killed it goes into ragdoll state for a short while, then the units get frozen and any simulation and collision is removed to save system resources. As a result, corpses do not react to their surrounding any more. Using this command will temporarily re-enable ragdoll state of a corpse to the same state it was when unit died. If this command is used in "enable/disable" sequence on a dead body, it gives the corpse a visible nudge (See example 3).
This command won't have lasting effect on vehicles as vehicles are actively simulated, but it works rather well on smaller PhysX enabled objects.
Groups:
Object Manipulation

Syntax

Syntax:
object awake awake
Parameters:
object: Object - PhysX object or dead unit
awake: Boolean - true to awake the object, false - to put it to sleep
Return Value:
Nothing

Examples

Example 1:
_object awake false;
Example 2:
Since 2.10:
_deadUnit awake true;
Example 3:
Make corpse react to explosion (since 2.10):
_deadUnit addEventHandler ["Explosion", { params ["_unit", "_damage"]; if (_damage < 0.01) exitWith {}; _unit awake true; _unit awake false; }];

Additional Information

See also:
isAwake 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