> For the complete documentation index, see [llms.txt](https://help.intangible.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.intangible.ai/build/environment.md).

# Environment

Sun position, time of day, background, shadows, terrain and grid – the scene-level environment controls in Build mode.

Scene-level lighting and ground. Sun position and time of day, the background, shadows, terrain color, grid visibility. Set once per scene; everything you build sits on top.

![Environment mode in Build: the panel row sits above the mode's own toolbar, which carries Exit, Environment Type and Fog](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-b6be0268d29f82c57b54d47ca50d311fe30b8f88%2Fenvironment-01.png?alt=media)

## What it does

Think of the environment controls as the work lights on a set. They pre-light the 3D scene so you can read where objects sit in relation to one another while you build and block, the same way you'd flood a stage before the DP comes in to light the actual shot. The lighting itself isn't passed to the visualizer. Render lighting is set later, in Visualize, with [Lighting presets](https://help.intangible.ai/visualize/lighting-presets.md).

The one exception is ground color. The vision model that reads your 3D scene sees the terrain color and infers a material from it: a green ground tends to read as grass, brown as dirt, gray as asphalt or concrete. That carries into the render even when you don't ask for it, so pick the ground color deliberately.

The environment controls are scene-level – they apply to every shot in the active scene. To vary how a scene reads across an edit, build separate scenes and cut between them in the [Sequence Timeline](https://help.intangible.ai/compose/timeline.md).

## Where things live

**Environment mode** is opened from the sun icon in the bottom toolbar. It holds the lighting – the sun, ambient light, shadows, the background – and the terrain. An exit control sits in the mode's own bar, and Escape leaves it.

**Edit Scene Details**, the panel on the left of Build, holds the scene's name and its description, and nothing else. Terrain colour and Show grid are on Environment mode's Terrain panel.

**Fog is an object you place**, from the Fog button on the Environment mode toolbar, not a setting on the scene. See [Fog](https://help.intangible.ai/build/fog.md).

## Light the scene

![Environment mode's controls in Build: the row of panel buttons above the mode's toolbar with Exit, Environment Type and Fog](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-1a7466291ad47c90f686d0d68e0f4eb1ca43d709%2Fenvironment-mode-01.png?alt=media)

Inside the mode, panels cover the background, the sun, ambient light, shadows, and terrain.

### The sun and ambient light

**Main Light** is the sun.

| Control     | What it sets                                               |
| ----------- | ---------------------------------------------------------- |
| Color       | The sun's colour                                           |
| Intensity   | How strong it is                                           |
| Azimuth     | Its compass direction, in degrees                          |
| Time of Day | A clock time, with the sun's altitude in degrees beside it |

![The Main Light panel, showing Color, Intensity, Azimuth and Time of Day](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-5e5c095fefcf3891b71f7376e493aeabf4739f26%2Fenvironment-main-light-01.png?alt=media)

A reset control returns the panel to its defaults.

**Ambient Light** carries Color and Intensity. It fills the scene where the sun does not reach.

![The Ambient Light panel](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-b796ee5ed4463549c0b47886ada6bff1763fe4b2%2Fenvironment-ambient-light-01.png?alt=media)

A diegetic sun gizmo sits in the viewport, with rings for azimuth and altitude that you drag directly. A moon sits opposite the sun, and the light hands over between them across day and night.

Sun and shadow are keyframable, so the light can change across a shot.

## The panels

Environment mode is a row of buttons, each opening one panel.

| Panel             | What it holds                                                                                                                                                                        |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Background**    | The background itself: a sky, a solid colour, or an image. Image backgrounds accept HDRIs, including images from the team media library, and add Intensity, Blurriness and Rotation. |
| **Main Light**    | The sun. Colour, Intensity, Azimuth, and Time of Day.                                                                                                                                |
| **Ambient Light** | Colour and Intensity.                                                                                                                                                                |
| **Shadows**       | An Enabled switch and an Intensity slider. Shadow quality is set separately in the renderer settings.                                                                                |
| **Terrain**       | The floor, rather than the environment: a colour, plus Show grid, Visible, and Blend Horizon.                                                                                        |

**The Background button is conditional.** It appears when the environment type is set to Color or to Image, and not when it is set to Sky, which is the default. On a sky scene the row is four buttons: Main Light, Ambient Light, Shadows, Terrain. Change the type from the **Environment Type** control in the mode's own bottom toolbar and the button appears.

Each panel's header carries a reset control that puts that panel back to its defaults, so you can undo an experiment on the lighting without touching the background.

**There is no Location control.** An earlier version of this page described one for anchoring the time of day to a real place. None of Environment mode's panels is it. Time of Day is driven by the sun's altitude and nothing else.

**Blend Horizon**, on by default, blends the infinite floor into the background rather than ending it on a hard line. It sits on the Terrain panel rather than Background.

![The Terrain panel open above Environment mode's toolbar: Color, Show grid, Visible and Blend Horizon](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-912c2465996c3414af04159b730c762b8b978482%2Fenvironment-terrain-panel-01.png?alt=media)

## What reaches the render

```mermaid
flowchart LR
    A[Time of day, sun, fog] --> B[3D viewport readability only]
    C[Ground color] --> D[Vision model reads the scene]
    D --> E[Render]
    F[Grid] -->|never| E
```

Sun position and time of day light the 3D viewport, and every render starts from a capture of that lit view. With no lighting preset set, the render follows them: a low orange sun renders as a sunset. A lighting preset overrides them. Ground color reaches the render through the same capture: the vision model reads the colored terrain and infers a material. The grid is scaffolding for you, not for the render – it never appears in rendered output.

## Where render lighting comes from

With no lighting preset, the render's light comes from here. Set a [lighting preset](https://help.intangible.ai/visualize/lighting-presets.md) in Visualize and it takes over. The pattern:

* Use **environment** to make the 3D scene readable, and as the render's lighting when a shot has no preset.
* Use **lighting presets** in Visualize for control and for a sequence that matches. "This shot is stormy; the next is misty."

## Common mistakes

{% hint style="warning" %}
**The grid being on doesn't affect renders, but it can throw off your composition.** If you're framing a shot in Compose mode and the grid lines are visible, the lines aren't going to render – but they're occupying mental space while you frame. Toggle the grid off before you compose.
{% endhint %}

* **Tuning fog and then forgetting it's there.** A dense fog object darkens your viewport readability. If your scene looks unexpectedly murky, check the [fog](https://help.intangible.ai/build/fog.md) in it first.
* **Expecting the viewport's time of day to drive the render.** Sun and time of day light the viewport, not the render. A scene that looks like midnight in the viewport renders with whatever [lighting preset](https://help.intangible.ai/visualize/lighting-presets.md) you set in Visualize. Set render lighting there, not by the Time slider.
* **Leaving the ground a color you don't want read as a material.** A green ground can render as grass, gray as asphalt. If the render keeps inventing a surface, check the terrain color first.

## Related

* [Fog](https://help.intangible.ai/build/fog.md)
* [Lighting presets](https://help.intangible.ai/visualize/lighting-presets.md)
* [Scene context](https://help.intangible.ai/visualize/scene-context.md)
* [Auto-prompt](https://help.intangible.ai/visualize/auto-prompt.md)
* [Asset library](https://help.intangible.ai/build/asset-library.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.intangible.ai/build/environment.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
