---
name: "BIS_fnc_timeline_init"
type: function
status: ok
groups: ["Timeline"]
arma3_since: "1.76"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_timeline_init
revid: 348102
updated: 2023-11-08T11:31:57Z
---

# BIS_fnc_timeline_init

*Function · Timeline · Arma 3 v1.76*

## Description

Initialized a timeline.

## Syntax

```sqf
[timeline, initPosition, length, playRate, loop] call BIS_fnc_timeline_init
```

**Parameters:**

- `timeline`: [Object](../topics/Object.md) - the timeline object
- `initPosition`: [Number](../topics/Number.md) - (Optional, default `_timeline getVariable ["Pos", 0.0]`) initial position
- `length`: [Number](../topics/Number.md) - (Optional, default 	`_timeline getVariable ["Length", 10.0]`) length
- `playRate`: [Number](../topics/Number.md) - (Optional, default `_timeline getVariable ["PlayRate", 1.0]`) play rate
- `loop`: [Boolean](../topics/Boolean.md) - (Optional, default `_timeline getVariable ["Loop", false]`) [true](../commands/true.md) - loop enabled, [false](../commands/false.md) - loop disabled
- `reverse`: [Boolean](../topics/Boolean.md) - (Optional, default `_timeline getVariable ["Reverse", false]`) [true](../commands/true.md) - reverse, [false](../commands/false.md) - Do not reverse
- `playOnStart`: [Boolean](../topics/Boolean.md) - (Optional, default `_timeline getVariable ["PlayFromStart", false]`) [true](../commands/true.md) - play at scenario start, [false](../commands/false.md) - Do not play at scenario start
- `destroyWhenFinished`: [Boolean](../topics/Boolean.md) - (Optional, default `_timeline getVariable ["DestroyWhenFinished", false]`) [true](../commands/true.md) - Destroy when done, [false](../commands/false.md) - Do not destroy when done

**Returns:** [Nothing](../topics/Nothing.md)

## Examples

### Example 1

```sqf
[timeline] call BIS_fnc_timeline_init;
```

## See also

[BIS_fnc_timeline_deleted](../functions/BIS_fnc_timeline_deleted.md) · [BIS_fnc_timeline_cleanup](../functions/BIS_fnc_timeline_cleanup.md) · [BIS_fnc_timeline_finish](../functions/BIS_fnc_timeline_finish.md)

<sub>Source: [BI Community Wiki — BIS fnc timeline init](https://community.bistudio.com/wiki/BIS_fnc_timeline_init) (revision 348102).</sub>