onEachFrame: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
mNo edit summary
Line 53: Line 53:
<!-- Note Section END -->
<!-- Note Section END -->
</dl>
</dl>
<h3 style="display:none">Bottom Section</h3>
[[Category:ArmA 2 OA: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
<!-- CONTINUE Notes -->
<!-- CONTINUE Notes -->
<dl class="command_description">
<dl class="command_description">
Line 67: Line 59:
<dd class="note">
<dd class="note">
If you need a stackable [[onEachFrame]] event, use mission event handler "Draw3D":
If you need a stackable [[onEachFrame]] event, use mission event handler "Draw3D":
</code>[[addMissionEventHandler]] ["Draw3D", {...code to run each frame...}];</code>
<code>[[addMissionEventHandler]] ["Draw3D", {...code to run each frame...}];</code>
</dd>
</dd>
</dl>
</dl>
<!-- DISCONTINUE Notes -->
<!-- DISCONTINUE Notes -->
<h3 style="display:none">Bottom Section</h3>
[[Category:ArmA 2 OA: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Revision as of 16:23, 28 August 2014

Hover & click on the images for description

Description

Description:
Statement is run every frame.
Arma 3
In order to keep compatability between official and community content the functions BIS_fnc_addStackedEventHandler and BIS_fnc_removeStackedEventHandler should be used instead.
Groups:
Uncategorised

Syntax

Syntax:
onEachFrame statement
Parameters:
statement: Code
Return Value:
Nothing

Examples

Example 1:
onEachFrame { hintSilent str position player; }; //Hints position every frame
Example 2:
Private variables defined outside of onEachFrame scope are not inherited: _myvar = "bob"; myvar = "bill"; onEachFrame { hintSilent str [_myvar, myvar] }; //Result: [any,"bill"]
Example 3:
Only one onEachFrame loop can exist at any time: onEachFrame { player sideChat "first"; }; onEachFrame { player sideChat "second"; }; //Result: "second","second","second"..."second" Note how "first" never gets shown even though it precedes "second". This is because script thread is executing within the same frame and first onEachFrame is overwritten before it has a chance to execute its statement.
Example 4:
Script suspension is not permitted within onEachFrame scope: onEachFrame { sleep 1 }; //ERROR!!!

Additional Information

See also:
See also needed

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

Notes

Posted on 21 Dec, 2012
neokika
onEachFrame {}; //Reset event
Posted on August 28, 2014 - 15:21 (UTC)
Killzone Kid
If you need a stackable onEachFrame event, use mission event handler "Draw3D": addMissionEventHandler ["Draw3D", {...code to run each frame...}];

Bottom Section