Difference between revisions of "onEachFrame"

From Bohemia Interactive Community
Jump to navigation Jump to search
(Merge infoboxes)
m (Text replacement - " \| *(game[0-9]|version[0-9]|gr[0-9]|serverExec|mp|pr|descr|s[0-9]|p[0-9]{1,3}|r[0-9]|x1?[0-9]|seealso) *= +" to " |$1= ")
 
(19 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Command|Comments=
+
{{RV|type=command
____________________________________________________________________________________________
 
  
| arma2oa |Game name=
+
|game1= arma2oa
 +
|version1= 1.63
  
|1.63|Game version=
+
|game2= tkoh
____________________________________________________________________________________________
+
|version2= 1.00
  
| Runs given statement every frame.
+
|game3= arma3
{{Feature arma3 |
+
|version3= 0.50
 +
 
 +
|gr1= Event Handlers
 +
 
 +
|descr= Runs given statement every frame.
 +
{{Feature|arma3 |
 
In order to keep compatibility between official and community content:
 
In order to keep compatibility between official and community content:
* Since {{arma3}} v1.57 a stackable version of this EH is available: [[Arma_3:_Event_Handlers/addMissionEventHandler#EachFrame|EachFrame Mission Event Handler]]
+
* Since {{arma3}} v1.57 a stackable version of this EH is available: [[Arma 3: Mission Event Handlers#EachFrame|EachFrame Mission Event Handler]]
* Before that, the scripted version of the event handler should be used instead (using [[BIS_fnc_addStackedEventHandler]] and [[BIS_fnc_removeStackedEventHandler]]).}} |DESCRIPTION=
+
* Before that, the scripted version of the event handler should be used instead (using [[BIS_fnc_addStackedEventHandler]] and [[BIS_fnc_removeStackedEventHandler]]).}}
____________________________________________________________________________________________
 
 
 
| [[onEachFrame]] statement |SYNTAX=
 
  
|p1= statement: [[String]] or [[Code]] |PARAMETER1=
+
|s1= [[onEachFrame]] statement
  
| [[Nothing]] |RETURNVALUE=
+
|p1= statement: [[String]] or [[Code]]
  
| [[diag_frameNo]], [[diag_fps]] |SEEALSO=
+
|r1= [[Nothing]]
____________________________________________________________________________________________
 
  
|x1= <code>[[onEachFrame]] { [[hintSilent]] [[str]] [[position]] [[player]]}; {{cc|Hints position every frame}}</code> |EXAMPLE1=
+
|x1= <code>[[onEachFrame]] { [[hintSilent]] [[str]] [[position]] [[player]]}; {{cc|Hints position every frame}}</code>
  
 
|x2= Private variables defined outside of the [[onEachFrame]] scope are not inherited:
 
|x2= Private variables defined outside of the [[onEachFrame]] scope are not inherited:
Line 30: Line 31:
 
[[onEachFrame]] { [[hintSilent]] [[str]] [_myvar, myvar]; };
 
[[onEachFrame]] { [[hintSilent]] [[str]] [_myvar, myvar]; };
 
{{cc|Result: [any,"bill"]}}</code>
 
{{cc|Result: [any,"bill"]}}</code>
|EXAMPLE2=
 
  
 
|x3= Only one [[onEachFrame]] loop can exist at any time:
 
|x3= Only one [[onEachFrame]] loop can exist at any time:
Line 37: Line 37:
 
{{cc|Result: "second", "second", "second"...}}</code>
 
{{cc|Result: "second", "second", "second"...}}</code>
  
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. |EXAMPLE3=
+
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.
 
|x4= Script suspension is not permitted within [[onEachFrame]] scope:
 
|x4= Script suspension is not permitted within [[onEachFrame]] scope:
 
<code>{{cc|Will throw an error}}
 
<code>{{cc|Will throw an error}}
[[onEachFrame]] { [[sleep]] 1; };</code> |EXAMPLE4=
+
[[onEachFrame]] { [[sleep]] 1; };</code>
  
|x5= <code>[[onEachFrame]] {}; {{cc|Reset event}}</code> |EXAMPLE5=
+
|x5= <code>[[onEachFrame]] {}; {{cc|Reset event}}</code>
 +
 
 +
|seealso= [[diag_frameNo]], [[diag_fps]]
 
}}
 
}}
 
<h3 style="display:none">Notes</h3>
 
<dl class="command_description">
 
<!-- Note Section BEGIN -->
 
 
<!-- Note Section END -->
 
</dl>
 
<h3 style="display:none">Bottom Section</h3>
 
 
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
 

Latest revision as of 23:17, 19 June 2021

Hover & click on the images for description

Description

Description:
Runs given statement every frame.
Arma 3
In order to keep compatibility between official and community content:
Groups:
Event Handlers

Syntax

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

Examples

Example 1:
onEachFrame { hintSilent str position player}; // Hints position every frame
Example 2:
Private variables defined outside of the 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"... 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: // Will throw an error onEachFrame { sleep 1; };
Example 5:
onEachFrame {}; // Reset event

Additional Information

See also:
diag_frameNodiag_fps

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