BIS fnc unitPlaySimple: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (1 revision)
m (pf)
Line 1: Line 1:
{{Function|Comments=
____________________________________________________________________________________________


{{Function|= Comments
| arma2oa |Game name=
 
|1.00|Game version=
____________________________________________________________________________________________
____________________________________________________________________________________________


| arma2oa |= Game name
| Plays back input movement data on input unit. Simplified. |Description=
____________________________________________________________________________________________


|1.00|= Game version
| [unit, data, varDone, stateIngnore, debug, sleep, skipTime] call [[BIS_fnc_UnitPlaySimple]] |Syntax=
____________________________________________________________________________________________


| <pre>
/*
File: fn_UnitPlaySimple.sqf


Description:
|p1= unit: [[Object]] - Unit to play movement data on |Parameter 1=
Plays back input movement data on input unit. Simplified.


Parameters:
|p2= data: [[Array]] - Movement data to use |Parameter 2=
Unit - Unit to play movement data on
Data - Movement data to use
OPT:[Object, Variable] - OPTIONAL: Variable to set on specified Object once playback has finished
OPT:IgnoreDisabled - OPTIONAL: Whether to ignore if the Unit is dead and/or cannot move
OPT:Debug - OPTIONAL: Whether to give debug information on played frames per second
OPT:Sleep - OPTIONAL: Time to Sleep between frames. This is if you want to be recording another unit
  and playing back movement data on another as well. Limit is 0-1 seconds.
OPT:SkipTime - OPTIONAL: Amount of time to skip at the start of playback. For example if you wish to
  play the data from halfway instead of the start.


Examples (used in a script):
|p3= varDone: [[Array]] - (Optional, default []) Variable to set on specified Object once playback has finished in format:
a) _capturedData = [[0,[8208.26,1953.13,296.04],67]];
*0: [[Object]] - Target object
[BIS_Vehicle, _capturedData, [BIS_Object, "DoneRecording"], true, false, 0.2, 5] spawn BIS_fnc_UnitPlay;
*1: [[String]] - Variable name|Parameter 3=
Which would play back the captured data in the _capturedData array (containing only one frame in this example)
onto a unit named BIS_Vehicle. Playback will play even if the unit is dead or disabled. Debug information would
not show and playing back would update once every 0.2 seconds. Once the playback finished, an object named
BIS_Object would have a variable called "DoneRecording" set to TRUE. Playback would skip the first 5 seconds
of data.
b) _capturedData = [[0,[8208.26,1953.13,296.04],67]];
[BIS_Vehicle, _capturedData, [], false, true] spawn BIS_fnc_UnitPlay;
Which would play back the captured data in the _capturedData array (containing only one frame in this example)
onto a unit named BIS_Vehicle. Playback will play only while the unit is alive and can move. Debug information
would show.
c) _capturedData = [[0,[8208.26,1953.13,296.04],67]];
[BIS_Vehicle, _capturedData] spawn BIS_fnc_UnitPlay;
Which would play back the captured data in the _capturedData array (containing only one frame in this example)
onto a unit named BIS_Vehicle.
Note that in a very large captured sequence, it is a better idea to preprocess the data prior to mission start, or
a short freeze would occur as it reads the data. For example using the following in the mission's init:
UnitData = compile preprocessFile "PlayBackUnit.sqf";


..And then later start the sequence like this:
|p4= stateIgnore: [[Boolean]] - (Optional, default [[false]]) Whether to ignore if the Unit is dead and/or cannot move |Parameter 4=
// Start the sequence
_result = [] call UnitData;
*/


</pre><small>''(Placeholder description extracted from the function header by [[BIS_fnc_exportFunctionsToWiki]])''</small> |= Description
|p5= debug: [[Boolean]] - (Optional, default [[false]] Whether to give debug information on played frames per second |Parameter 5=
____________________________________________________________________________________________


| <!-- [] call [[BIS_fnc_UnitPlaySimple]]; --> |= Syntax
|p6= sleep: [[Number]] - (Optional, default 0) Time to Sleep between frames. This is if you want to be recording another unit and playing back movement data on another as well. Limit is 0-1 seconds. |Parameter 6=


|p1= |= Parameter 1
|p7= skipTime: [[Number]] - (Optional, default 0) Amount of time to skip at the start of playback. For example if you wish to play the data from halfway instead of the start. |Parameter 7=


| |= Return value
| [[Script]] - Script handle |Return value=
____________________________________________________________________________________________
____________________________________________________________________________________________


|x1= <code></code> |=  
|x1= <code>_capturedData = [[0,[8208.26,1953.13,296.04],67]];
[BIS_Vehicle, _capturedData, [BIS_Object, "DoneRecording"], [[true]], [[false]], 0.2, 5] [[spawn]] [[BIS_fnc_UnitPlaySimple]];</code> |Example 1=
____________________________________________________________________________________________
____________________________________________________________________________________________


| |= See also
| [[BIS_fnc_UnitCaptureFiring]], [[BIS_fnc_UnitCaptureSimple]], [[BIS_fnc_UnitPlayFiring]], [[BIS_fnc_UnitPlay]] |See also=
 
}}
}}


Revision as of 13:19, 11 June 2018

A2 OA Logo.png1.00
Hover & click on the images for description

Description

Description:
Plays back input movement data on input unit. Simplified.
Execution:
call
Groups:
Uncategorised

Syntax

Syntax:
[unit, data, varDone, stateIngnore, debug, sleep, skipTime] call BIS_fnc_UnitPlaySimple
Parameters:
unit: Object - Unit to play movement data on
data: Array - Movement data to use
varDone: Array - (Optional, default []) Variable to set on specified Object once playback has finished in format:
stateIgnore: Boolean - (Optional, default false) Whether to ignore if the Unit is dead and/or cannot move
debug: Boolean - (Optional, default false Whether to give debug information on played frames per second
sleep: Number - (Optional, default 0) Time to Sleep between frames. This is if you want to be recording another unit and playing back movement data on another as well. Limit is 0-1 seconds.
skipTime: Number - (Optional, default 0) Amount of time to skip at the start of playback. For example if you wish to play the data from halfway instead of the start.
Return Value:
Script - Script handle

Examples

Example 1:
_capturedData = [[0,[8208.26,1953.13,296.04],67]]; [BIS_Vehicle, _capturedData, [BIS_Object, "DoneRecording"], true, false, 0.2, 5] spawn BIS_fnc_UnitPlaySimple;

Additional Information

See also:
BIS_fnc_UnitCaptureFiringBIS_fnc_UnitCaptureSimpleBIS_fnc_UnitPlayFiringBIS_fnc_UnitPlay

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

Notes

Bottom Section

Retrieved from "https://community.bistudio.com/wiki?title=BIS_fnc_unitPlaySimple&oldid=108301"