ACE3/addons/refuel/functions/fnc_setFuel.sqf

#include "..\script_component.hpp"
/*
 * Author: GitHawk
 * Set the remaining fuel amount.
 *
 * Arguments:
 * 0: Fuel Source <OBJECT>
 * 1: Amount (in liters)<NUMBER>
 *
 * Return Value:
 * None
 *
 * Example:
 * [fuelTruck, 42] call ace_refuel_fnc_setFuel
 *
 * Public: Yes
 */

params [["_source", objNull, [objNull]], ["_fuel", nil, [0]]];

// Ensure valid fuel quantity
if (isNull _source || {isNil "_fuel"}) exitWith {};

// Make sure this is actually a finite fuel source
private _capacity = [_source] call FUNC(getCapacity);
if (_capacity in [REFUEL_INFINITE_FUEL, REFUEL_DISABLED_FUEL]) exitWith {};

// Don't overfill or underfill tank
_source setVariable [QGVAR(currentFuelCargo), (_fuel min _capacity) max 0, true];
General - Relative `script_component.hpp` includes (#9378) Co-authored-by: PabstMirror <pabstmirror@gmail.com> 2023-09-12 18:58:10 +00:00			`#include "..\script_component.hpp"`
Initial draft 2015-08-13 17:33:55 +00:00			`/*`
			`* Author: GitHawk`
Cleanup and improvements 2015-08-20 20:10:26 +00:00			`* Set the remaining fuel amount.`
Initial draft 2015-08-13 17:33:55 +00:00			`*`
			`* Arguments:`
Add fast mouse actions to refuel, add refuel eden attributes (#5418) * Add fast mouse actions to refuel * nobody seen that * Add interaction condition and refuel on ladder * Add car hit, fix change weapon on uncon * Replace objNull with nil in setVar, unify var names * Delete ConnectNozzle functions Delete reset* functions * Add public function and eden attributes * Remove static actions from RHS compat * Remove statusEffect_set on respawn * Fix dual menu, add deprecating message * Optimize fnc_takeNozzle * Cleanup 2017-09-10 19:43:03 +00:00			`* 0: Fuel Source <OBJECT>`
Added dropping and progress bars 2015-08-21 20:43:45 +00:00			`* 1: Amount (in liters)<NUMBER>`
Initial draft 2015-08-13 17:33:55 +00:00			`*`
			`* Return Value:`
First batch of fixes 2015-08-14 01:18:54 +00:00			`* None`
Initial draft 2015-08-13 17:33:55 +00:00			`*`
			`* Example:`
Added dropping and progress bars 2015-08-21 20:43:45 +00:00			`* [fuelTruck, 42] call ace_refuel_fnc_setFuel`
Initial draft 2015-08-13 17:33:55 +00:00			`*`
Make setFuel and getFuel API 2016-02-26 09:50:02 +00:00			`* Public: Yes`
Initial draft 2015-08-13 17:33:55 +00:00			`*/`
Added nozzle Added code for nozzle object Params and private update 2016-02-02 14:03:06 +00:00
Add fast mouse actions to refuel, add refuel eden attributes (#5418) * Add fast mouse actions to refuel * nobody seen that * Add interaction condition and refuel on ladder * Add car hit, fix change weapon on uncon * Replace objNull with nil in setVar, unify var names * Delete ConnectNozzle functions Delete reset* functions * Add public function and eden attributes * Remove static actions from RHS compat * Remove statusEffect_set on respawn * Fix dual menu, add deprecating message * Optimize fnc_takeNozzle * Cleanup 2017-09-10 19:43:03 +00:00			`params [["_source", objNull, [objNull]], ["_fuel", nil, [0]]];`
Initial draft 2015-08-13 17:33:55 +00:00
Refuel - Added ability to refuel fuel sources (#8981) * Simplify main fuel loop * Remove unecessary action macro * Add container refueling * Fuel counter behaviour is now consistent for both limited and unlimited fuel sources * Update maxFuel and refuelContainer whenever fueling begins * Update maxFuel and refuelContainer whenever fueling begins * Prevent loading of fuel sources into cargo when they have a nozzle connected to them * Added action to check how much fuel is left in a jerry can * Prevent jerry cans from being picked up if they have a nozzle connected to them * Added function to check if a nozzle can be connected to an object * Prevent fuel sources which have their nozzle deployed from being loaded * Compute both tank volumes inside of refuel instead of durring turn on * Didn't mean to delete these * Allow for user defined fuel capacities * Handle more edge cases with infinite fuel sources * Refuel - Prevent fuel sources from being dragged while they're refueling other things * Refuel - Added flow rate multiplier for refueling fuel sources * Refuel - Use FUNC instead of DFUNC for nozzle actions * Refuel - getCapacity should return REFUEL_DISABLED_FUEL instead of 0 when argument is not a fuel source * Refuel - Correctly reset fuel counter when fueling a new target * Refuel - Implemented all suggested changes * Refuel - Added newlines to end of files * Refuel - Added missing newline at end of XEH_PREP * Only setFuel once per jerry can creation Co-authored-by: PabstMirror <pabstmirror@gmail.com> * Calling getFuel will initialize the fuel source * Refuel - Add newline to end of file --------- Co-authored-by: BaerMitUmlaut <baermitumlaut@users.noreply.github.com> Co-authored-by: PabstMirror <pabstmirror@gmail.com> 2023-02-17 02:06:11 +00:00			`// Ensure valid fuel quantity`
			`if (isNull _source \|\| {isNil "_fuel"}) exitWith {};`
Initial draft 2015-08-13 17:33:55 +00:00
Refuel - Added ability to refuel fuel sources (#8981) * Simplify main fuel loop * Remove unecessary action macro * Add container refueling * Fuel counter behaviour is now consistent for both limited and unlimited fuel sources * Update maxFuel and refuelContainer whenever fueling begins * Update maxFuel and refuelContainer whenever fueling begins * Prevent loading of fuel sources into cargo when they have a nozzle connected to them * Added action to check how much fuel is left in a jerry can * Prevent jerry cans from being picked up if they have a nozzle connected to them * Added function to check if a nozzle can be connected to an object * Prevent fuel sources which have their nozzle deployed from being loaded * Compute both tank volumes inside of refuel instead of durring turn on * Didn't mean to delete these * Allow for user defined fuel capacities * Handle more edge cases with infinite fuel sources * Refuel - Prevent fuel sources from being dragged while they're refueling other things * Refuel - Added flow rate multiplier for refueling fuel sources * Refuel - Use FUNC instead of DFUNC for nozzle actions * Refuel - getCapacity should return REFUEL_DISABLED_FUEL instead of 0 when argument is not a fuel source * Refuel - Correctly reset fuel counter when fueling a new target * Refuel - Implemented all suggested changes * Refuel - Added newlines to end of files * Refuel - Added missing newline at end of XEH_PREP * Only setFuel once per jerry can creation Co-authored-by: PabstMirror <pabstmirror@gmail.com> * Calling getFuel will initialize the fuel source * Refuel - Add newline to end of file --------- Co-authored-by: BaerMitUmlaut <baermitumlaut@users.noreply.github.com> Co-authored-by: PabstMirror <pabstmirror@gmail.com> 2023-02-17 02:06:11 +00:00			`// Make sure this is actually a finite fuel source`
			`private _capacity = [_source] call FUNC(getCapacity);`
			`if (_capacity in [REFUEL_INFINITE_FUEL, REFUEL_DISABLED_FUEL]) exitWith {};`

			`// Don't overfill or underfill tank`
			`_source setVariable [QGVAR(currentFuelCargo), (_fuel min _capacity) max 0, true];`