# Overlay

**Overlay Objects** are the driving force behind connecting *3D* and *2D* components in **Incari**. Since these items are separated into their respective dimensionalities in either [**Scenes**](https://docs.incari.com/incari-studio/objects-and-types/project-objects/scene) or [**Scene2Ds**](https://docs.incari.com/incari-studio/objects-and-types/project-objects/scene2d), it is necessary to use **Overlay Objects** to combine them if a *User Interface* calls for a mix of the two.

## 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-178138fc695013c01fb61e87121d0f86ee2426fa%2Foverlayimage220241.png?alt=media)

Once finished with any *2D* aspects for that particular **Scene2D**, the user then needs to go to the desired *3D* **Scene** in which they wish to overlay *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-6a89062d251af8c049d76e5220738d81b67bf00c%2Foverlayimage320241.png?alt=media) ![](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-dd4da6c22d1f243cf1dd46e3ce56703bc38e48dc%2Foverlayimage420241.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-6f9c130dada3d3af5a1102aec83daa2f2453ec12%2Foverlayimage520241.png?alt=media) ![](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-eb6a1b8c5acb191fd702b81f2a70a43ceed587ef%2Foverlayimage620241.png?alt=media)

Once this is done, the **Scene2D** will render over the *3D* **Scene**. 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-f385aff7d9b0309a5cda9a740a0b0ad5c45a05a9%2Foverlayimage720241.gif?alt=media)

## Overlay Order

It is possible to have multiple **Overlays** in a **Scene**. 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.

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