API - Add Function to set Channels on all Radios a Player is carrying

[mrschick]

When merged this pull request will:

• Add an API function setupRadios that allows easy setup of channels on all radios a unit is carrying;

As per the function's description, it would allow setting the channels on all radios a unit has via a single function invocation in its init field (only if restricted to run locally via if (this isEqualTo player) then {}; or similar) or initPlayerLocal.sqf:

_success = [ ["ACRE_PRC343", [2,3]], ["ACRE_PRC152", 3], ["ACRE_PRC77", [31,15]] ] call acre_api_fnc_setupRadios;
// Will set PRC343 to Ch2 Blk3, PRC152 to Ch3 and PRC77 to 31.15 MHz

_success = [ ["ACRE_PRC343", 6], ["ACRE_PRC152", 2], ["ACRE_PRC152", 3] ] call acre_api_fnc_setupRadios;
// Will set PRC343 to Ch6 Blk1, the first PRC152 to Ch2 and the second PRC152 to Ch3

_success = [ ["ACRE_SEM52SL", 8], ["ACRE_SEM70", [34,075]] ] call acre_api_fnc_setupRadios;
// Will set SEM52SL to Ch8 and SEM70 to 34.075 MHz

To-Do:

• API Function;
• Compatibility with PRC-343 channels and blocks;
• Compatibility with PRC-148/152/117F and BF-888S single channels;
• Compatibility with PRC-77 MHz.KHz frequency setting;
• Compatibility with SEM52SL presets and SEM70 frequencies;
• Documentation;
• Add radio setup to 3DEN Object Attributes;
• Compatibility with the WIP Wireless Set No38 frequency settings Better handled after PR is merged;

[mrschick]

I believe this is good to go now.

[Mike-MF]

Needs to be updated from master to test.

[mrschick]

Needs to be updated from master to test.

Done.

[mrschick]

Fat-fingered my mouse and closed this by accident...

[Timi007]

Great PR! I have some improvements to the German translation.

[Mike-MF]

Got around to testing this.
Using this in initPlayerLocal.sqf
_success = [ ["ACRE_PRC343", [2,3]], ["ACRE_PRC152", 3], ["ACRE_PRC77", [31,15]] ] call acre_api_fnc_setupRadios;

On a unit with those 3 radios added to a backpack via Ace arsenal always comes back false.

15:17:50 [ACRE] (api) WARNING: Attempted to import radio setup [["ACRE_PRC343",[2,3]],["ACRE_PRC152",3],["ACRE_PRC77",[31,15]]], aborting due to no radios carried

But, if you run it in debug after loading in, it works just fine.

[mrschick]

It's probably because it doesn't wait for [] call acre_api_fnc_isInitialized to be true and ends up running before radios are initialized, I always added a waitUntil before the function call when using it in initPlayerLocal.sqf.
But for usability it would be better to let the function use a waitUntilAndExecute internally, like the Rack API does.

[mrschick]

This should do it.