> For the complete documentation index, see [llms.txt](https://interopxyz.gitbook.io/three-plus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://interopxyz.gitbook.io/three-plus/components/scene/environment.md).

# Environment

Adds an environment map to a scene.

## Description

Adds an environment map to a scene for reflections and background as well as a light probe for box maps.

{% tabs %}
{% tab title="Preview" %}
![](https://2542354621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbH1SBOktQqL8caPM2Xpc%2Fuploads%2F4X664VgKUii6CodXX44F%2FScene-Environment.png?alt=media\&token=fbddea4c-45ae-4c0b-95f0-e694f3662b8c)
{% endtab %}

{% tab title="Location" %}
**Name** | Environment

**Nickname** | Env

**Tab** | ThreeJs

**Panel** | Scene

**Division** | 2
{% endtab %}

{% tab title="Inputs" %}
**C** | **Background Color** (*Colour*) | The background color if an image is not used.

**Img** | **Image** (*Bitmap / CubeMap*) | A Bitmap, CubeMap, or file path to an image. 

**B** | **Is Background** (*Bool*) | If true the image will be used as the background.

**E** | **Is Environment** (*Bool*) | If true the image will be used as the reflection environment for physical and standard materials.

**L** | **Is Illumination** (*Bool*) | If true the image will be used as a light probe illuminating the scene. (Only work with CubeMaps.)
{% endtab %}

{% tab title="Ouputs" %}
**E** | **Scene Element** (*T+ Scene Element*) | An Environment Three Plus Scene Modifier Element
{% endtab %}

{% tab title="Mode" %}
*none*
{% endtab %}
{% endtabs %}

## Usage