isGamePaused: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (updated version to 1.96)
m (Text replacement - ";[ ]+ " to "; ")
(20 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma3dev |Game name=
|game1= arma3
|1.96|Game version=
|version1= 1.96


____________________________________________________________________________________________
|gr1= System


| Returns [[true]] if the game simulation is paused due to some system event like a dialog or pause menu or when user has Alt+Tab-ed (except when -nopause start up param is used). Relevant to SP, in MP simulation does not get paused.
|descr= Returns the state of game simulation. Simulation can get paused by pressing {{KeyboardShortcut|ALT|TAB}} or a system dialog opening (e.g. {{KeyboardShortcut|ESC}} menu). Simulation will not get paused if <tt>-noPause</tt> [[Arma 3: Startup Parameters|startup parameter]] is used.
<br><br>{{Informative | [[onEachFrame]] event and <tt>"EachFrame"</tt> event handler continue to execute when the simulation is paused, which could result in undesired backlog. Use [[isGamePaused]] to skip loop if needed. }} |DESCRIPTION=
{{Feature|Informative|[[onEachFrame]] event and <tt>"EachFrame"</tt> event handler continue to execute when the simulation is paused, which could result in undesired backlog. Use [[isGamePaused]] to skip loop if needed.}}
____________________________________________________________________________________________


| '''isGamePaused'''  |SYNTAX=
|mp= In multiplayer the simulation will not get paused and this command will always return [[false]].


| [[Boolean]] |RETURNVALUE=  
|s1= [[isGamePaused]]
 
|r1= [[Boolean]] - Returns [[true]] if game simulation is paused, [[false]] if not


|x1= <code>[[onEachFrame]]  
|x1= <code>[[onEachFrame]]  
{
{
[[if]] ([[isGamePaused]]) [[exitWith]] {};  
[[if]] ([[isGamePaused]]) [[exitWith]] {};
//... do stuff
{{cc|...do stuff}}
};</code>|EXAMPLE1=
};</code>
____________________________________________________________________________________________


| [[isGameFocused]], [[isUIContext]], [[canSuspend]], [[isRemoteExecuted]], [[isRemoteExecutedJIP]], [[serverCommand]] |SEEALSO=
|seealso= [[isGameFocused]]
 
|  |MPBEHAVIOUR=
____________________________________________________________________________________________
}}
}}
<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:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Revision as of 01:55, 8 August 2021

Hover & click on the images for description

Description

Description:
Returns the state of game simulation. Simulation can get paused by pressing ALT + ↹ Tab or a system dialog opening (e.g. ESC menu). Simulation will not get paused if -noPause startup parameter is used.
onEachFrame event and "EachFrame" event handler continue to execute when the simulation is paused, which could result in undesired backlog. Use isGamePaused to skip loop if needed.
Multiplayer:
In multiplayer the simulation will not get paused and this command will always return false.
Groups:
System

Syntax

Syntax:
isGamePaused
Return Value:
Boolean - Returns true if game simulation is paused, false if not

Examples

Example 1:
onEachFrame { if (isGamePaused) exitWith {}; // ...do stuff };

Additional Information

See also:
isGameFocused

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