add createPerFrameHandlerObject

[commy2]

When merged this pull request will:

• Reimplements CBA_fnc_createPerFrameHandlerObject (formerly known as cba_common_fnc_addPerFrameHandlerLogic)

Someone in the ACE public chat asked what happened to this. I guess this was meant to be API after all, so now I feel bad for nuking it. Should've been better documented though tbqh.

old one:
https://github.com/sickboy/cba/blob/542e28c71165864a32211a347a72b206d91ef882/addons/common/init_perFrameHandler.sqf#L58

Since this was removed before 2.4 I also took the opportunity to make some tweaks:

• Use a location instead of an object for minimal overhead.
• Switched around _args and _delay parameter to make it consistent with addPerFrameHandler
• The start code now also gets the logic as argument instead of the passed arguments directly. This makes it consistent with all the other called functions.
• And obviously removed _common_ from the function name.
• private keyword, pushBack etc. etc.

[thojkooi]

I think the name addPerFrameHandlerLogic is strange and doesn't properly say what the function does. I'm not sure exactly what a better name should be yet.

[commy2]

createPerFrameHandlerLogic ?

[thojkooi]

It's the logic bit that makes it not fit, I think. Though create is indeed better.

[commy2]

Hmm. Other suggestion: createPerFrameHandlerObject. Although Logic is the term for dummy objects that do magical script things in Arma. (e.g. class Logic;)

[commy2]

I'm thinking about using these for my port of ACE2 fire propagation.

[thojkooi]

It is, but I see no reason to indicate we use logic objects in the function name. I will think of some suggestions for a better name.

[commy2]

The logic is a fundamental part of this though. It is the return value and the only passed argument in the called functions (aside from the _private functions).

[Killswitch00]

Object? Entity? Thing? Manager? Agent? (perhaps not, since the concept of "agents" exist in the game).

Executor? Invoker? Worker?

(Logic seems fine though)

[commy2]

Object would perfectly describe the character of this being. But the problem is that the game already has as data type and this is actually a ...

[Killswitch00]

Runner?
Task?
Job?

[thojkooi]

Object is the best of those so far. But you could also just leave it out and use createPerFrameHandler.

Logic might be confused with some kind of internal function that handles the per frame handler logic.

[Killswitch00]

How about a remote/destroy/delete function as well?

[Killswitch00]

exit if true

[Killswitch00]

Looks about done now.