BIS fnc countdown: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " <h3 style="display:none">Notes</h3> <dl class="command_description"> <!-- Note Section BEGIN --> <!-- Note Section END --> </dl>" to "")
m (Text replacement - " *\| *([Cc]omments|COMMENTS|[Gg]ame [Nn]ame|Game [Vv]ersion|Game Version \(number surrounded by NO SPACES\)|Multiplayer Arguments \("local" or "global"\)|Multiplayer Effects \("local" or "global"\)|Multiplayer Execution \("server" o...)
Line 1: Line 1:
{{Function|Comments=
{{Function


| arma3 |Game name=
| arma3


|1.02|Game version=
|1.02


|gr1 = Missions |GROUP1=
|gr1 = Missions


| Triggers a countdown. {{Informative| The '''initial''' countdown can be accessed via [[missionNamespace]] variable '''bis_fnc_countdown_time'''.<br>The initial value is either ''[[serverTime]] (if set globally) or  [[time]] (if set locally) + timeInSeconds''. To return the left-over time see '''example 4'''}}|DESCRIPTION=
| Triggers a countdown. {{Informative| The '''initial''' countdown can be accessed via [[missionNamespace]] variable '''bis_fnc_countdown_time'''.<br>The initial value is either ''[[serverTime]] (if set globally) or  [[time]] (if set locally) + timeInSeconds''. To return the left-over time see '''example 4'''}}


| [timeInSeconds,global] [[call]] '''BIS_fnc_countdown''' |SYNTAX=
| [timeInSeconds,global] [[call]] '''BIS_fnc_countdown'''


|p1= timeInSeconds - Can be:<br>
|p1= timeInSeconds - Can be:<br>
Line 17: Line 17:
* 0 to return the left-over time
* 0 to return the left-over time
[[Boolean]]:
[[Boolean]]:
* [[true]] to find out if countdown is active and if there is left-over time |PARAMETER1=
* [[true]] to find out if countdown is active and if there is left-over time
|p2= global - [[Boolean]]: True to set it globally (Optional) Default: [[true]] |PARAMETER2=
|p2= global - [[Boolean]]: True to set it globally (Optional) Default: [[true]]
|[[Number]]:  
|[[Number]]:  
* If set locally: [[time]] + timeInSeconds (Example 1)<br>
* If set locally: [[time]] + timeInSeconds (Example 1)<br>
Line 25: Line 25:
* Return left-over time (Example 4)
* Return left-over time (Example 4)
[[Boolean]]:<br>
[[Boolean]]:<br>
Returns [[true]] when countdown is > 0 else [[false]] (Example 5) |RETURNVALUE=
Returns [[true]] when countdown is > 0 else [[false]] (Example 5)


|x1= <code>_initialCountDown = [50,[[false]]] [[call]] '''BIS_fnc_countDown''';{{cc|Sets countdown to 50 seconds where function is executed}}</code> |EXAMPLE1=
|x1= <code>_initialCountDown = [50,[[false]]] [[call]] '''BIS_fnc_countDown''';{{cc|Sets countdown to 50 seconds where function is executed}}</code>
|x2= <code>_initialCountDown = [50] [[call]] '''BIS_fnc_countDown''';{{cc|Sets countdown to 50 seconds globally}}</code> |EXAMPLE2=
|x2= <code>_initialCountDown = [50] [[call]] '''BIS_fnc_countDown''';{{cc|Sets countdown to 50 seconds globally}}</code>
|x3= <code>[-1] [[call]] [[BIS_fnc_countdown]]; {{cc|Sets ''bis_fnc_countdown_time'' to [[nil]]}}</code> |EXAMPLE3=
|x3= <code>[-1] [[call]] [[BIS_fnc_countdown]]; {{cc|Sets ''bis_fnc_countdown_time'' to [[nil]]}}</code>
|x4= <code>_timeLeft = [0] [[call]] [[BIS_fnc_countdown]]; {{cc|Returns the left over-time}}</code> |EXAMPLE4=
|x4= <code>_timeLeft = [0] [[call]] [[BIS_fnc_countdown]]; {{cc|Returns the left over-time}}</code>
|x5= <code>_isTimeLeft = <noWiki>[</noWiki>[[true]]] [[call]] [[BIS_fnc_countdown]]; {{cc|Returns [[true]] if countdown is greater 0}}</code> |EXAMPLE5=
|x5= <code>_isTimeLeft = <noWiki>[</noWiki>[[true]]] [[call]] [[BIS_fnc_countdown]]; {{cc|Returns [[true]] if countdown is greater 0}}</code>






||SEEALSO=
|





Revision as of 23:37, 17 January 2021

Hover & click on the images for description

Description

Description:
Triggers a countdown.
The initial countdown can be accessed via missionNamespace variable bis_fnc_countdown_time.
The initial value is either serverTime (if set globally) or time (if set locally) + timeInSeconds. To return the left-over time see example 4
Execution:
call
Groups:
Missions

Syntax

Syntax:
[timeInSeconds,global] call BIS_fnc_countdown
Parameters:
timeInSeconds - Can be:
Number:
  • Any number to set the length of the countdown in seconds
  • -1 to set the countdown to nil
  • 0 to return the left-over time
Boolean:
  • true to find out if countdown is active and if there is left-over time
global - Boolean: True to set it globally (Optional) Default: true
Return Value:
Number:
  • If set locally: time + timeInSeconds (Example 1)
  • If set globally serverTime + timeInSeconds (Example 2)
  • Returns -1 if countdown is set to nil (Example 3)
  • Return left-over time (Example 4)
Boolean:
Returns true when countdown is > 0 else false (Example 5)

Examples

Example 1:
_initialCountDown = [50,false] call BIS_fnc_countDown;// Sets countdown to 50 seconds where function is executed
Example 2:
_initialCountDown = [50] call BIS_fnc_countDown;// Sets countdown to 50 seconds globally
Example 3:
[-1] call BIS_fnc_countdown; // Sets bis_fnc_countdown_time to nil
Example 4:
_timeLeft = [0] call BIS_fnc_countdown; // Returns the left over-time
Example 5:
_isTimeLeft = [true] call BIS_fnc_countdown; // Returns true if countdown is greater 0

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


Bottom Section