# Overlay

**Overlay Objects** allow the user to reference other **Scene2Ds** within a **Scene2D**.

## Setting up for an Overlay Object

To start, the user must create a **Scene2D** and populate it with the desired *2D* components. This can be done in the **Project Outliner**. After it is created and dragged to the correct **Screen**, the user just needs to locate the appropriate tab at the top of the window, below the Menu bar of **Incari Studio**.

![](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-6a2e480582988a95eba278ee2c1f8f9b468daacf%2Foverlayimage120232.png?alt=media) ![](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-b2b94251b433bf28cdf5af80cece412309e5ce04%2Foverlay2d220241.png?alt=media)

Once finished with any *2D* aspects for that particular **Scene2D**, the user then needs to go to the desired **Scene2D** in which they wish to overlay the other *2D* elements.

## Creating an Overlay Object

To create an **Overlay Object**, either click the plus icon in the **Scene Outliner** or right-click in the **Scene Outliner**, hover over `Create`, and locate **Overlay**.

![](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-64527f9ac3180ddb88b915f0003a0551b29ef0c4%2Foverlay2dimage320241.png?alt=media) ![](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-d82a68e418df258886aaa72e9a2045407c59230a%2Foverlay2dimage420241.png?alt=media)

In the **Attribute Editor**, the desired **Scene2D** simply needs to be selected from the drop-down Menu of `2D Scene` under the `Overlay` **Attribute**.

![](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-1859cf4c4dbaa7dbe5d4d932d576cefd819066d5%2Foverlay2dimage520241.png?alt=media) ![](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-8a7334f6aff2791e9f1fe9b00fa44d8e00f382a2%2Foverlay2dimage620241.png?alt=media)

Once this is done, the **Scene2D** will render over the target **Scene2D**. An example of this process is shown below, culminating in a **Player View** that displays the contents of the **Overlay Object**.

![Overlay Object Example.](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-008740bf2bd5d6498a702c8eb07762e7f94e49e0%2Foverlay2dgif20241.gif?alt=media)

## Overlay Order

It is possible to have multiple **Overlays** in a **Scene2D**. If they are overlapping, there is an order in which they appear. This is determined by the order in the **Scene Outliner**. The top-most **Overlay** will appear at the front and the bottom-most will be appear behind any and all **Overlays** before it.

Please note that when switching the order in the **Scene Outliner**, this will not be reflected in **Incari Studio** in either `Player view` or `Editor view`. The user must open the **Player** to see any changes.