---
name: "Title Effect Type"
type: topic
source: https://community.bistudio.com/wiki/Title_Effect_Type
revid: 341304
updated: 2023-05-20T20:48:07Z
---

# Title Effect Type

A [Title Effect Type](../topics/Title_Effect_Type.md) is a [String](../topics/String.md) parameter that is required by a few scripting commands.
The commands are used to display custom GUI elements on the front end or the back end.

Six commands use this parameter:

| cut* commands | title* commands |
|---|---|
| - [cutObj](../commands/cutObj.md)<br>- [cutRsc](../commands/cutRsc.md)<br>- [cutText](../commands/cutText.md) | - [titleObj](../commands/titleObj.md)<br>- [titleRsc](../commands/titleRsc.md)<br>- [titleText](../commands/titleText.md) |

> [!NOTE]
> The main difference between these commands is that `title*` commands can only have a single effect on a single title layer, whereas the `cut*` ones allow to have multiple effects on multiple cut layers.\
> If a layer is not specified, the cut effects will be defaulted to layer 0.

The **Title Effect** simply tells the game engine how to display the object, resource, or text that is passed to the command.
If plain text is given, it is always white with a black shadow and horizontally centered.
The different effects are described below - the effects may vary if a black or white 'curtain' is currently visible or not:

| Colour | Type | Description |
|---|---|---|
| N/A | "PLAIN" | Displays the text, object, or resource given. Plain text is vertically centered. |
| N/A | "PLAIN NOFADE" | Displays the text, object, or resource given. Plain text is vertically centered. Has no fade in and fade out. |
| N/A | "PLAIN DOWN" | Displays the text, object, or resource given. Plain text is vertically aligned to 25% from the bottom of the screen. |
|  | "WHITE OUT" | Causes the screen to turn completely white, and displays the optional text, object, or resource given. All other GUI is hidden behind this white 'curtain'.<br>This can easily blind the player so it should be used with caution. Make sure that a fade-in time is set when calling the command. |
|  | "WHITE IN" | Withdraws a white 'curtain' revealing the GUI. |
|  | "BLACK" | Same as "BLACK OUT". |
|  | "BLACK FADED" | Causes the screen to turn completely black without fading in, and displays the optional text, object, or resource given. All other GUI is hidden behind this black 'curtain'.<br>If a 'speed' is not given, the 'curtain' and the displayed element disappears **instantly** after 5-10 seconds. Otherwise it will stay black with the element still visible. |
|  | "BLACK OUT" | Causes the screen to turn completely black, and displays the optional text, object, or resource given. All other GUI is hidden behind this black 'curtain'. |
|  | "BLACK IN" | Reveals the GUI after a black 'curtain' is withdrawn along with the optional text, object, or resource that was given. |

<sub>Source: [BI Community Wiki — Title Effect Type](https://community.bistudio.com/wiki/Title_Effect_Type) (revision 341304).</sub>