# 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**](/incari-studio/2024.1/objects-and-types/project-objects/scene.md) or [**Scene2Ds**](/incari-studio/2024.1/objects-and-types/project-objects/scene2d.md), 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**.

![](/files/kAEcwX22yKYG6sUmbRw8) ![](/files/2A3nRIgSD9NA5klOYVpi)

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**.

![](/files/SXwxxtFWMZSoyOdZmXWH) ![](/files/xGN4hHYnxvDog6RsQGM3)

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

![](/files/VQCtMZjpLMk8xc7TJ32h) ![](/files/qaKOkS6cRkp5Zf2hzghz)

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.](/files/vTTLp5kvMCvlRuHQ3xkx)

## 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.](/files/tXu3E7AKaAiQXTFPtTK3)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.incari.com/incari-studio/2024.1/objects-and-types/scene-objects/overlay.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
