ACE3/addons/common/functions/fnc_doAnimation.sqf

/*
 * Author: commy2
 *
 * Execute an animation. This is used to not break things like the unconsciousness animation.
 *
 * Argument:
 * 0: Unit (Object)
 * 1: Animation (String)
 * 2: Priority of the animation. (Number, optional default: 0)
 *     0: PlayMove
 *     1: PlayMoveNow
 *     2: SwitchMove (no transitional animation, doesn't overwrite priority 1)
 *
 * Return value:
 * Nothing
 */
#include "script_component.hpp"

private ["_force"];

PARAMS_3(_unit,_animation,_priority);
_force = False;

// no animation given
if (isNil "_animation") exitWith {
    ACE_LOGERROR_1("No animation specified in %1.",_fnc_scriptNameParent);
};

if (isNil "_priority") then {
    _priority = 0;
};
if (count _this > 3) then {
    _force = _this select 3;
};

// don't overwrite more important animations
if (_unit getVariable ["ACE_isUnconscious", false] && {(_animation != "Unconscious")} && {!_force}) exitWith {};

// don't go unconscious if the unit isn't unconscious
if (_animation == "Unconscious" && {!((_unit getVariable ["ACE_isUnconscious", false]) || (_unit getVariable ["ACE_isDead", false]))}) exitWith {};

// switchMove "" no longer works in dev 1.37
if (_animation == "") then {
    _animation = [_unit] call FUNC(getDefaultAnim);
};

switch (_priority) do {
    case 0 : {
        if (_unit == vehicle _unit) then {
            [_unit, format ["{_this playMove '%1'}", _animation], _unit] call FUNC(execRemoteFnc);
        } else {
            // Execute on all machines. PlayMove and PlayMoveNow are bugged: They have no global effects when executed on remote machines inside vehicles.
            [_unit, format ["{_this playMove '%1'}", _animation]] call FUNC(execRemoteFnc);
        };
    };
    case 1 : {
        if (_unit == vehicle _unit) then {
            [_unit, format ["{_this playMoveNow '%1'}", _animation], _unit] call FUNC(execRemoteFnc);
        } else {
          // Execute on all machines. PlayMove and PlayMoveNow are bugged: They have no global effects when executed on remote machines inside vehicles.
            [_unit, format ["{_this playMoveNow '%1'}", _animation]] call FUNC(execRemoteFnc);
        };
    };
    case 2 : {
        // Execute on all machines. SwitchMove has local effects.
        [_unit, format ["{_this switchMove '%1'}", _animation]] call FUNC(execRemoteFnc);
    };
    default {};
};

["Anim", [_priority, _animation]] call FUNC(log);