---
name: "BIS_fnc_sceneSetPosFormation"
type: function
status: ok
groups: ["Scenes"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_sceneSetPosFormation
revid: 348694
updated: 2023-11-08T14:29:24Z
---

# BIS_fnc_sceneSetPosFormation

*Function · Scenes · Arma 3 v0.50 · introduced in Arma 2 v1.00*

Locality: executed with **spawn**

## Description

Adjusts units into a pre-determined formation, using a few variables. Part of S.C.E.N.E.S function group.

## Syntax

```sqf
param spawn BIS_fnc_sceneSetPosFormation
```

**Parameters:**

- [Array](../topics/Array.md) - array of units involved
- [Object](../topics/Object.md) - scene initiator
- [Object](../topics/Object.md) - talking partner of scene initiator
- [String](../topics/String.md) - formation in which to place units. Possible values: "LINE", "CIRCLE", "HALFCIRCLE
- [Number](../topics/Number.md) - true / false in format [Number](../topics/Number.md) (0 = false, 1 = true), determines debug mode (showing markers).
- [Number](../topics/Number.md) - (Optional, default 0) - determines angle offset

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

## Examples

### Example 1

```sqf
[units group player, bluforCommander, player, "HALFCIRCLE", 0] spawn BIS_fnc_sceneSetPosFormation;
```

<sub>Source: [BI Community Wiki — BIS fnc sceneSetPosFormation](https://community.bistudio.com/wiki/BIS_fnc_sceneSetPosFormation) (revision 348694).</sub>