BIS fnc setVehicleMass: Difference between revisions

Revision as of 14:06, 25 February 2021

Hover & click on the images for description

Description:: Set mass relative to the default vehicle mass (default mass being vehicle mass on first execution of this function).
Execution:: call
Groups:: Object Manipulation

Syntax:

[vehicle, animationInformation, massDifference] call BIS_fnc_setVehicleMass

Parameters:

vehicle: Object

animationInformation: Boolean or Array - (Optional, default [])

Boolean - true to take current animations mass in consideration, false to set "raw" mass
Array - animation sources and phases to format ["animationSource1", 1, "animationSource2", 0, ...]

massDifference: Number - (Optional, default 0) value to add to the mass (can be negative)

Return Value:

Boolean - success state

Example 1:: // default behaviour, change the mass according to the current phase of the animation sources result = [this] call BIS_fnc_setVehicleMass; result = [this, [], 0] call BIS_fnc_setVehicleMass;
Example 2:: // doesn't care about the current phase of animations, it will change the mass for the given sources result = [this, ["source1", 1, "source2", 0]] call BIS_fnc_initVehicle;
Example 3:: // will do the same as the first example, then subtract 150 to the mass result = [this, [], -150] call BIS_fnc_initVehicle;

: 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 26: / Line 26: @@
 |x1= <code>{{cc|default behaviour, change the mass according to the current phase of the animation sources}}
-result = [<nowiki/>[[this]]]        [[call]] [[BIS_fnc_setVehicleMass]];
+result = [<nowiki/>[[Magic Variables#this_2|this]]]        [[call]] [[BIS_fnc_setVehicleMass]];
-result = [<nowiki/>[[this]], [], 0] [[call]] [[BIS_fnc_setVehicleMass]];</code>
+result = [<nowiki/>[[Magic Variables#this_2|this]], [], 0] [[call]] [[BIS_fnc_setVehicleMass]];</code>
 |x2= <code>{{cc|doesn't care about the current phase of animations, it will change the mass for the given sources}}
-result = [<nowiki/>[[this]], ["source1", 1, "source2", 0]] [[call]] [[BIS_fnc_initVehicle]];</code>
+result = [<nowiki/>[[Magic Variables#this_2|this]], ["source1", 1, "source2", 0]] [[call]] [[BIS_fnc_initVehicle]];</code>
 |x3= <code>{{cc|will do the same as the first example, then subtract 150 to the mass}}
-result = [<nowiki/>[[this]], [], -150] [[call]] [[BIS_fnc_initVehicle]];</code>
+result = [<nowiki/>[[Magic Variables#this_2|this]], [], -150] [[call]] [[BIS_fnc_initVehicle]];</code>
 |seealso= [[setMass]], [[setCenterOfMass]]
 }}