Common - Add CBA_fnc_execAfterNFrames from ZEN

[johnb432]

When merged this pull request will:

• Adds an extra parameter to CBA_fnc_execNextFrame a new function CBA_fnc_execAfterNFrames that allows you to specify by how many frames you want the execution of the passed code to be delayed by. Closes [Feature Request]: Add an extra parameter to CBA_fnc_execNextFrame for settable frame delay #1578.

For robustness' sake I left the existing code of CBA_fnc_execNextFrame alone, which means if the delay is 1 frame, then it uses the old code.

During testing I noticed there is a bug, where if you call the function in a certain manner, it (EDIT: it = CBA_fnc_execNextFrame) will add an extra frame of waiting. This also happens in the current steam release however, so I'm not sure if it's worth trying to fix.
Here's the code I used to test this part specifically:

private _delay = 1;

for "_index" from 1 to 10000 do {
    [{
        // If expected result, don't print result
        if (diag_frameno == ((_this select 0) + (_this select 1))) exitWith {};

        systemChat format ["%1, %2", diag_frameno, _this select 0];
    }, [diag_frameno, _delay], _delay] call CBA_fnc_execNextFrame;
	
    uiSleep 0.00005;
};

[PabstMirror]

imho this func has fairly rare use and I'd prefer not adding any additional overhead to the eachFrame block
maybe we could just borrow
https://github.com/zen-mod/ZEN/blob/master/addons/common/functions/fnc_execAfterNFrames.sqf

[johnb432]

imho this func has fairly rare use and I'd prefer not adding any additional overhead to the eachFrame block maybe we could just borrow https://github.com/zen-mod/ZEN/blob/master/addons/common/functions/fnc_execAfterNFrames.sqf

I could rewrite it in that format, however how would it work with the licensing/crediting?

[mharis001]

I could rewrite it in that format, however how would it work with the licensing/crediting?

ZEN license (GPLv3) is compatible with CBA (GPLv2). In either case, feel free to borrow and adapt as needed.

[johnb432]

I could rewrite it in that format, however how would it work with the licensing/crediting?

ZEN license (GPLv3) is compatible with CBA (GPLv2). In either case, feel free to borrow and adapt as needed.

Thank you very much.

[johnb432]

Ported the code from ZEN directly over.

[veteran29]

LGTM