---
name: "cutFadeOut"
type: command
status: ok
groups: ["GUI Control"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/cutFadeOut
revid: 369415
updated: 2024-09-03T18:46:04Z
---

# cutFadeOut

*Command · GUI Control · Arma 3 v0.50 · introduced in Armed Assault v1.05*

## Description

Terminates the effect in the given layer by fading it out according to the given duration. If named layer is used and it doesn't exist, it will be allocated. For title layer see [titleFadeOut](../commands/titleFadeOut.md).

> [!NOTE]
> **Arma 3:** For greater efficiency and ease of moddability, it is recommended to use named layers.

## Syntax

### Syntax 1

```sqf
layer cutFadeOut duration
```

**Parameters:**

- `layer`: [Number](../topics/Number.md)
- `duration`: [Number](../topics/Number.md)

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

### Syntax 2

*since arma3 1.58*

```sqf
layerName cutFadeOut duration
```

**Parameters:**

- `layerName`: [String](../topics/String.md) - effect layer name. Layer names are CaSe SeNsItIvE
- `duration`: [Number](../topics/Number.md) - fade out time

**Returns:** [Number](../topics/Number.md) - number of the corresponding layer

## Examples

### Example 1

```sqf
0 cutFadeOut 2;
```

### Example 2

```sqf
private _layer = "layer1" cutFadeOut 2;
```

## See also

[allCutLayers](../commands/allCutLayers.md) · [cutText](../commands/cutText.md) · [cutRsc](../commands/cutRsc.md) · [cutObj](../commands/cutObj.md) · [allActiveTitleEffects](../commands/allActiveTitleEffects.md) · [activeTitleEffectParams](../commands/activeTitleEffectParams.md)

<sub>Source: [BI Community Wiki — cutFadeOut](https://community.bistudio.com/wiki/cutFadeOut) (revision 369415).</sub>