Common - Added CBA_fnc_execAfterNFrames from ZEN (#1584)

* Added n frame delay

* Revert "Added n frame delay"

This reverts commit 50df691.

* Added function from ZEN

* Update addons/common/fnc_execAfterNFrames.sqf

Co-authored-by: PabstMirror <pabstmirror@gmail.com>

* Update fnc_execNextFrame.sqf

---------

Co-authored-by: PabstMirror <pabstmirror@gmail.com>

addons/common/CfgFunctions.hpp

@@ -131,6 +131,7 @@ class CfgFunctions {
             PATHTO_FNC(directCall);
             PATHTO_FNC(objectRandom);
             PATHTO_FNC(execNextFrame);
+            PATHTO_FNC(execAfterNFrames);
             PATHTO_FNC(waitAndExecute);
             PATHTO_FNC(waitUntilAndExecute);
             PATHTO_FNC(compileFinal);

addons/common/fnc_execAfterNFrames.sqf

@@ -0,0 +1,35 @@
+#include "script_component.hpp"
+/* ----------------------------------------------------------------------------
+Function: CBA_fnc_execAfterNFrames
+
+Description:
+    Executes the given code after the specified number of frames.
+
+Parameters:
+    _function - The function to run. <CODE>
+    _args     - Parameters passed to the function executing. This will be the same array every execution. (optional, default: []) <ANY>
+    _frames   - The amount of frames the execution of the function should be delayed by. (optional, default: 0) <NUMBER>
+
+Returns:
+    Nothing Useful
+
+Examples:
+    (begin example)
+        [{hint "Done!"}, [], 5] call cba_fnc_execAfterNFrames;
+    (end)
+
+Author:
+    mharis001, donated from ZEN
+---------------------------------------------------------------------------- */
+
+if (canSuspend) exitWith {
+    [CBA_fnc_execAfterNFrames, _this] call CBA_fnc_directCall;
+};
+
+params [["_function", {}, [{}]], ["_args", []], ["_frames", 0, [0]]];
+
+if (_frames > 0) exitWith {
+    [CBA_fnc_execAfterNFrames, [_function, _args, _frames - 1]] call CBA_fnc_execNextFrame;
+};
+
+_args call _function;

addons/common/fnc_execNextFrame.sqf

@@ -7,10 +7,10 @@ Description:
 
 Parameters:
     _function - The function to run. <CODE>
-    _args     - Parameters passed to the function executing. This will be the same array every execution. [optional] <ANY>
+    _args     - Parameters passed to the function executing. This will be the same array every execution. (optional, default: []) <ANY>
 
 Returns:
-    Nothing
+    Nothing Useful
 
 Examples:
     (begin example)