---
name: "cutObj"
type: command
status: ok
groups: ["GUI Control"]
arma3_since: "0.50"
locality: {"argument": null, "effect": "local", "server_exec": false}
source: https://community.bistudio.com/wiki/cutObj
revid: 348145
updated: 2023-11-08T11:32:40Z
---

# cutObj

*Command · GUI Control · Arma 3 v0.50 · introduced in Operation Flashpoint v1.00*

Locality: effect **local**

## Description

Displays an object defined in the global config in `CfgTitles`.

> [!NOTE]
> **Arma 3:** For greater efficiency and ease of modability, it is recommended to use named layers with [#Syntax 3](../commands/cutObj.md#syntax-3).

## Syntax

### Syntax 1

```sqf
cutObj [class, type, speed, showInMap, drawOverHUD]
```

**Parameters:**

- `class`: [String](../topics/String.md) - the className of the object defined in `configFile >> "CfgTitles" >> class`
- `type`: [String](../topics/String.md) - one of "PLAIN", "PLAIN DOWN", "BLACK", "BLACK FADED", "BLACK OUT", "BLACK IN", "WHITE OUT" and "WHITE IN". See Title Effect Types for more information about these values
- `speed`: [Number](../topics/Number.md) - (Optional, default -1) time in seconds to fade in resource
- `showInMap`: [Boolean](../topics/Boolean.md) - (Optional, default [true](../commands/true.md)) [false](../commands/false.md) to hide the text when the map is opened
- `drawOverHUD`: [Boolean](../topics/Boolean.md) - (Optional, default [true](../commands/true.md)) [false](../commands/false.md) to show the object under in-game HUD *(since arma3 2.16)*

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

### Syntax 2

```sqf
layer cutObj [class, type, speed, showInMap, drawOverHUD]
```

**Parameters:**

- `layer`: [Number](../topics/Number.md) - layer number on which the effect is shown, where 0 is the back most. Layer number is rounded to the nearest integer and also cannot be negative. Layer 99.5 will be treated as layer 100
- `class`: [String](../topics/String.md) - the className of the object defined in `configFile >> "CfgTitles" >> class`
- `type`: [String](../topics/String.md) - one of "PLAIN", "PLAIN DOWN", "BLACK", "BLACK FADED", "BLACK OUT", "BLACK IN", "WHITE OUT" and "WHITE IN". See Title Effect Types for more information about these values.
- `speed`: [Number](../topics/Number.md) - (Optional, default -1) time in seconds to fade in resource
- `showInMap`: [Boolean](../topics/Boolean.md) - (Optional, default [true](../commands/true.md)) [false](../commands/false.md) to hide the text when the map is opened
- `drawOverHUD`: [Boolean](../topics/Boolean.md) - (Optional, default [true](../commands/true.md)) [false](../commands/false.md) to show the object under in-game HUD *(since arma3 2.16)*

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

### Syntax 3

*since arma3 1.58*

```sqf
layerName cutObj [class, type, speed, showInMap, drawOverHUD]
```

**Parameters:**

- `layerName`: [String](../topics/String.md) - layer name on which the effect is shown. Layer names are CaSe SeNsItIvE
- `class`: [String](../topics/String.md) - the className of the object defined in `configFile >> "CfgTitles" >> class`
- `type`: [String](../topics/String.md) - one of "PLAIN", "PLAIN DOWN", "BLACK", "BLACK FADED", "BLACK OUT", "BLACK IN", "WHITE OUT" and "WHITE IN". See Title Effect Types for more information about these values
- `speed`: [Number](../topics/Number.md) - (Optional, default -1) time in seconds to fade in resource
- `showInMap`: [Boolean](../topics/Boolean.md) - (Optional, default [true](../commands/true.md)) [false](../commands/false.md) to hide the text when the map is opened
- `drawOverHUD`: [Boolean](../topics/Boolean.md) - (Optional, default [true](../commands/true.md)) [false](../commands/false.md) to show the object under in-game HUD *(since arma3 2.16)*

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

## Examples

### Example 1

```sqf
cutObj ["TVSet", "PLAIN"];
cutObj ["TVSet", "PLAIN", 2];
```

### Example 2

```sqf
2 cutObj ["Sphere", "PLAIN"];
```

### Example 3

```sqf
private _layer = "layer1" cutObj ["BISLogo", "PLAIN"];
```

## See also

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

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