BIS fnc countdown: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "True" to "true")
m (Some wiki formatting)
 
(22 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Function|Comments=
{{RV|type=function
____________________________________________________________________________________________


| arma3 |Game name=
|game1= arma3
|version1= 1.02


|1.02|Game version=
|gr1= Missions


|gr1 = Missions |GROUP1=
|descr= Triggers a countdown.
___________________________________________________________________________________________
{{Feature|informative|
The '''initial''' countdown can be accessed ''via'' [[missionNamespace]]'s variable '''BIS_fnc_countdown_time'''.<br>
The initial value is either <sqf inline>serverTime + timeInSeconds</sqf> (if set globally) or <sqf inline>time + timeInSeconds</sqf> (if set locally).
To return the left-over time see {{Link|#Example 4}}.
}}


| 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=
|s1= [timeInSeconds, global] call [[BIS_fnc_countdown]]
____________________________________________________________________________________________


| [timeInSeconds,global] [[call]] '''BIS_fnc_countdown''' |SYNTAX=
|p1= 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


|p1= timeInSeconds - Can be:<br>
|p2= global - [[Boolean]]: True to set it globally (Optional) Default: [[true]]
[[Number]]:<br>
* 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 |PARAMETER1=
|p2= global - [[Boolean]]: True to set it globally (Optional) Default: [[true]] |PARAMETER2=
|[[Number]]:
* If set locally: [[time]] + timeInSeconds (Example 1)<br>
* If set globally [[serverTime]] + timeInSeconds (Example 2)
* Returns -1 if countdown is set to [[nil]] (Example 3)
* Return left-over time (Example 4)
[[Boolean]]:<br>
Returns [[true]] when countdown is > 0 else [[false]] (Example 5) |RETURNVALUE=
____________________________________________________________________________________________


|x1= <code>_initialCountDown = [50,[[false]]] [[call]] '''BIS_fnc_countDown''';{{cc|Sets countdown to 50 seconds where function is executed}}</code> |EXAMPLE1=
|r1= <nowiki/>
|x2= <code>_initialCountDown = [50] [[call]] '''BIS_fnc_countDown''';{{cc|Sets countdown to 50 seconds globally}}</code> |EXAMPLE2=
* [[Number]]:
|x3= <code>[-1] [[call]] [[BIS_fnc_countdown]]; {{cc|Sets ''bis_fnc_countdown_time'' to [[nil]]}}</code> |EXAMPLE3=
** If set locally: [[time]] + timeInSeconds (see {{Link|#Example 1}})
|x4= <code>_timeLeft = [0] [[call]] [[BIS_fnc_countdown]]; {{cc|Returns the left over-time}}</code> |EXAMPLE4=
** If set globally [[serverTime]] + timeInSeconds (see {{Link|#Example 2}})
|x5= <code>_isTimeLeft = <noWiki>[</noWiki>[[true]]] [[call]] [[BIS_fnc_countdown]]; {{cc|Returns [[true]] if countdown is greater 0}}</code> |EXAMPLE5=
** Returns -1 if countdown is set to [[nil]] (see {{Link|#Example 3}})
** Return left-over time (see {{Link|#Example 4}})
* [[Boolean]]: returns [[true]] when countdown is > 0 else [[false]] (see {{Link|#Example 5}})


|x1= <sqf>private _initialCountdown = [50,false] call BIS_fnc_countdown; // sets countdown to 50 seconds where function is executed</sqf>


____________________________________________________________________________________________
|x2= <sqf>private _initialCountdown = [50] call BIS_fnc_countdown; // sets countdown to 50 seconds globally</sqf>


||SEEALSO=
|x3= <sqf>[-1] call BIS_fnc_countdown; // sets BIS_fnc_countdown_time to nil</sqf>


|x4= <sqf>private _timeLeft = [0] call BIS_fnc_countdown; // returns the left over-time</sqf>


|x5= <sqf>private _isTimeLeft = [true] call BIS_fnc_countdown; // returns true if countdown is greater than 0</sqf>
|seealso= [[BIS_fnc_VRTimer]]
}}
}}
<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:Functions|{{uc:countdown}}]]
[[Category:{{Name|arma3}}: Functions|{{uc:countdown}}]]

Latest revision as of 20:54, 28 January 2023

Hover & click on the images for description

Description

Description:
Triggers a countdown.
The initial countdown can be accessed via missionNamespace's variable BIS_fnc_countdown_time.

The initial value is either serverTime + timeInSeconds (if set globally) or time + timeInSeconds (if set locally).

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:

Examples

Example 1:
private _initialCountdown = [50,false] call BIS_fnc_countdown; // sets countdown to 50 seconds where function is executed
Example 2:
private _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:
private _timeLeft = [0] call BIS_fnc_countdown; // returns the left over-time
Example 5:
private _isTimeLeft = [true] call BIS_fnc_countdown; // returns true if countdown is greater than 0

Additional Information

See also:
BIS_fnc_VRTimer

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