BIS fnc eventTimeline: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (page filled)
Line 1: Line 1:
{{Function|Comments=
{{Function


| arma3 |Game name=
|game1= arma3


|1.78|Game version=
|version1= 1.78
 
|eff= local


|gr1 = Timeline |GROUP1=
|gr1 = Timeline |GROUP1=
Line 9: Line 11:
|gr2 = Systems |GROUP2=
|gr2 = Systems |GROUP2=


<!---|arg= local |Multiplayer Arguments=--->
|descr= Universal system for playing sequential events defined by time. {{Informative|''codeInterrupt'' and ''codeEnd'' are [[call]]ed while the code in the timeline is [[spawn]]ed.}}
 
<!---|eff= local |Multiplayer Effects=--->


| <pre>/*
|s1= [timeline, index, music, codeInterrupt, codeEnd] [[call]] [[BIS_fnc_eventTimeline]]
Author: ZoZo, modified by Riccardo Argiolas


Description:
|p1= timeline: [[Array]] - Timeline in format [ [1.0, {code} ], [2.0, {code} ], [2.3, {code} ], [4.7, {code} ] ]
    Universal system for playing sequential events defined by time. Timeline (ARRAY) consists from events (ARRAY).
timeline = [event1, event2, ..., eventX];
event1 = [ time,1 code1 ];


Example: timeline1 = [ [1.0, {do something here} ], [1.5, {do something here} ], [3.2, {do something here} ] ];
|p2= index: [[Number]] - (Optional, default 0) Index of the vent to play
1st code is executed at 1.0sec after the start of the function, 2nd code is executed at 1.5sec after the start of the function and 3rd code is executed at 3.2sec after the start of the function


Parameters:
|p3= music: [[String]] - (Optional, default "") Music to be played which will provide the sync time for the timeline
Select 0 - 2D ARRAY : timeline in format [ [1.0, {code} ], [2.0, {code} ], [2.3, {code} ], [4.7, {code} ] ]
Select 1 - NUMBER: index of the event to play
Select 2 - STRING: music to be played which will provide the sync time for the timeline
Select 3 - (OPTIONAL) - CODE: code to be executed if the timeline is interrupted (missionNamespace setVariable ["BIS_fnc_eventTimeline_playing", FALSE])
Select 4 - (OPTIONAL) - CODE or ARRAY: code or array of codes to be executed once the timeline is finshed. The codes are CALLed one after the other.


Returns:
|p4= codeInterrupt: [[Code]] - (Optional, default<br>
{{Inline code|[[params]] ["_pointer", "_baseTime", "_evenTime"];}}<br>
{{Inline code|["Timeline interrupted while playing event nr.: %1 (%2)", _pointer, _baseTime + _eventTime] [[call]] [[BIS_fnc_logFormat]];}})<br>Code to be executed if the timeline is interrupted with
{{Inline code|[[missionNamespace]] [[setVariable]] ["BIS_fnc_eventTimeline_playing", [[false]]]}}


Examples:
|p5= codeEnd: [[Array]] or [[Code]] - (Optional, default [[nil]]) [[Code]] or [[Array]] of codes to be executed once the timeline is finished. The codes are [[call]]ed one after the other.
*/</pre>{{placeholder}}<!-- Remove this after fill-in --> |Description=


|[] call [[BIS_fnc_eventTimeline]]|Syntax=
|r1= [[Nothing]]


|p1= parameter: Datatype - (Optional, default defValue) description |Parameter 1=
|x1 =  
<code>[[private]] _timeline =
[
[0.0, { [[hint]] "Start of the Timeline" } ],
[1.0, { [[hint]] "Event 1" }    ],
[3.0, { [[hint]] "End of the timeline" }  ]
];


|Datatype - description|Return value=
[_timeline, 0, "", {[[hint]] "Interrupted"}, {[[hint]] "Timeline done"}] [[spawn]] [[BIS_fnc_eventTimeline]];</code>


|x1= <code></code>|Example 1=
|exec= spawn


|exec= call |Execution=
|seealso= [[BIS_fnc_animatedBriefing]]


| |See also=
}}
}}


Revision as of 11:55, 21 October 2020

Arma 3 logo black.png1.78
LELocal
Hover & click on the images for description

Description

Description:
Universal system for playing sequential events defined by time.
ⓘ
codeInterrupt and codeEnd are called while the code in the timeline is spawned.
Execution:
spawn
Groups:
TimelineSystems

Syntax

Syntax:
[timeline, index, music, codeInterrupt, codeEnd] call BIS_fnc_eventTimeline
Parameters:
timeline: Array - Timeline in format [ [1.0, {code} ], [2.0, {code} ], [2.3, {code} ], [4.7, {code} ] ]
index: Number - (Optional, default 0) Index of the vent to play
music: String - (Optional, default "") Music to be played which will provide the sync time for the timeline
codeInterrupt: Code - (Optional, default
params ["_pointer", "_baseTime", "_evenTime"];
["Timeline interrupted while playing event nr.: %1 (%2)", _pointer, _baseTime + _eventTime] call BIS_fnc_logFormat;)
Code to be executed if the timeline is interrupted with missionNamespace setVariable ["BIS_fnc_eventTimeline_playing", false]
codeEnd: Array or Code - (Optional, default nil) Code or Array of codes to be executed once the timeline is finished. The codes are called one after the other.
Return Value:
Nothing

Examples

Example 1:
private _timeline = [ [0.0, { hint "Start of the Timeline" } ], [1.0, { hint "Event 1" } ], [3.0, { hint "End of the timeline" } ] ]; [_timeline, 0, "", {hint "Interrupted"}, {hint "Timeline done"}] spawn BIS_fnc_eventTimeline;

Additional Information

See also:
BIS_fnc_animatedBriefing

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
Retrieved from "https://community.bistudio.com/wiki?title=BIS_fnc_eventTimeline&oldid=169112"