BIS fnc VRTimer: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Page filling)
m (Text replacement - " |s1=[" to " |s1= [")
 
(33 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Function|Comments=
{{RV|type=function
____________________________________________________________________________________________


| arma3 |Game name=
|game1= arma3
|version1= 1.00


|1.00|Game version=
|gr1= VR
____________________________________________________________________________________________


| Timer for VR and time trials. |Description=
|eff= local
____________________________________________________________________________________________


| ''colour'' call [[BIS_fnc_VRTimer]] |Syntax=
|descr= Timer for VR and time trials. The following [[missionNamespace]] variables can be used:
* {{hl|BIS_stopTimer}}: set to [[true]] to stop the timer. Once stopped, the function must be executed again to restart the timer
* {{hl|RscFiringDrillTime_current}}: fill with [[Structured Text]] to display text instead of timer (when timer is stopped)
* {{hl|RscFiringDrillTime_done}}: set to [[true]] to close the display. '''''Stop the timer first'''''


|p1= colour: [[String]] (Optional, default {{Inline code|(["IGUI", "WARNING_RGB"] [[call]] [[BIS_fnc_displayColorGet]]) [[call]] [[BIS_fnc_colorRGBtoHTML]]}}) timer colour in HTML format (#<span style{{=}}"color: red">RR</span><span style{{=}}"color: green">GG</span><span style{{=}}"color: blue">BB</span>) |Parameter 1=
|s1= [colour] spawn [[BIS_fnc_VRTimer]]


| [[Nothing]] |Return value=
|p1= colour: [[String]] (Optional, default <sqf inline>(["IGUI", "WARNING_RGB"] call BIS_fnc_displayColorGet) call BIS_fnc_colorRGBtoHTML</sqf>) timer colour in HTML format (#{{Color|red|RR}}{{Color|green|GG}}{{Color|blue|BB}})
____________________________________________________________________________________________


|x1= <code>[[call]] [[BIS_fnc_VRTimer]];</code> |Example 1=
|r1= [[Nothing]]


|x2= <code>"#025D00" [[call]] [[BIS_fnc_VRTimer]];</code> |Example 2=
|x1= <sqf>[] spawn BIS_fnc_VRTimer;</sqf>
____________________________________________________________________________________________


| [[BIS_fnc_displayColorGet]], [[BIS_fnc_colorRGBtoHTML]] |See also=
|x2= <sqf>"#025D00" spawn BIS_fnc_VRTimer;</sqf>
 
|x3= <sqf>["#025D00"] spawn BIS_fnc_VRTimer;</sqf>
 
|seealso= [[BIS_fnc_displayColorGet]] [[BIS_fnc_colorRGBtoHTML]]
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= Lou Montana
<!-- Note Section BEGIN -->
|timestamp= 20180604195000
|text= Here is a countdown, inspired by this function:
<sqf>
LM_fnc_timeoutCountdown = {


<!-- Note Section END -->
params [
</dl>
["_time", 30, [0]],
 
["_colour", "#FFFFFF", [""]]
<h3 style="display:none">Bottom Section</h3>
];
[[Category:Functions|{{uc:VRTimer}}]]
private _timeout = time + _time;
[[Category:Function Group: VR|{{uc:VRTimer}}]]
RscFiringDrillTime_done = false;
[[Category:{{Name|arma3}}: Functions|{{uc:VRTimer}}]]
1 cutRsc ["RscFiringDrillTime", "PLAIN"];
while { time < _timeout } do
{
private _remainingTime = _timeout - time;
private _timeFormat = [_remainingTime, "MM:SS.MS", true] call BIS_fnc_secondsToString;
private _text = format ["<t align='left' color='%1'><img image='%2' />%3:%4<t size='0.8'>.%5</t>",
_colour,
"A3\Modules_F_Beta\data\FiringDrills\timer_ca",
_timeFormat select 0,
_timeFormat select 1,
_timeFormat select 2
];
RscFiringDrillTime_current = parseText _text;
sleep 0.01;
};
private _timeFormat = [0, "MM:SS.MS", true] call BIS_fnc_secondsToString;
RscFiringDrillTime_current = parseText format ["<t align='left' color='%1'><img image='%2' />%3:%4<t size='0.8'>.%5</t>",
_colour,
"A3\Modules_F_Beta\data\FiringDrills\timer_ca",
_timeFormat select 0,
_timeFormat select 1,
_timeFormat select 2];
sleep 4;
RscFiringDrillTime_done = true;
};
</sqf>
and to use it:
<sqf>[10, "#FF5500"] spawn LM_fnc_timeoutCountdown;</sqf>
}}

Latest revision as of 23:11, 12 July 2022

Hover & click on the images for description

Description

Description:
Timer for VR and time trials. The following missionNamespace variables can be used:
  • BIS_stopTimer: set to true to stop the timer. Once stopped, the function must be executed again to restart the timer
  • RscFiringDrillTime_current: fill with Structured Text to display text instead of timer (when timer is stopped)
  • RscFiringDrillTime_done: set to true to close the display. Stop the timer first
Execution:
call
Groups:
VR

Syntax

Syntax:
[colour] spawn BIS_fnc_VRTimer
Parameters:
colour: String (Optional, default (["IGUI", "WARNING_RGB"] call BIS_fnc_displayColorGet) call BIS_fnc_colorRGBtoHTML) timer colour in HTML format (#RRGGBB)
Return Value:
Nothing

Examples

Example 1:
[] spawn BIS_fnc_VRTimer;
Example 2:
"#025D00" spawn BIS_fnc_VRTimer;
Example 3:
["#025D00"] spawn BIS_fnc_VRTimer;

Additional Information

See also:
BIS_fnc_displayColorGet BIS_fnc_colorRGBtoHTML

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
Lou Montana - c
Posted on Jun 04, 2018 - 19:50 (UTC)
Here is a countdown, inspired by this function:
LM_fnc_timeoutCountdown = { params [ ["_time", 30, [0]], ["_colour", "#FFFFFF", [""]] ]; private _timeout = time + _time; RscFiringDrillTime_done = false; 1 cutRsc ["RscFiringDrillTime", "PLAIN"]; while { time < _timeout } do { private _remainingTime = _timeout - time; private _timeFormat = [_remainingTime, "MM:SS.MS", true] call BIS_fnc_secondsToString; private _text = format ["<t align='left' color='%1'><img image='%2' />%3:%4<t size='0.8'>.%5</t>", _colour, "A3\Modules_F_Beta\data\FiringDrills\timer_ca", _timeFormat select 0, _timeFormat select 1, _timeFormat select 2 ]; RscFiringDrillTime_current = parseText _text; sleep 0.01; }; private _timeFormat = [0, "MM:SS.MS", true] call BIS_fnc_secondsToString; RscFiringDrillTime_current = parseText format ["<t align='left' color='%1'><img image='%2' />%3:%4<t size='0.8'>.%5</t>", _colour, "A3\Modules_F_Beta\data\FiringDrills\timer_ca", _timeFormat select 0, _timeFormat select 1, _timeFormat select 2]; sleep 4; RscFiringDrillTime_done = true; };
and to use it:
[10, "#FF5500"] spawn LM_fnc_timeoutCountdown;