# SceneEnvironment

> Talos 0.7 · Since 0.6; changed in 0.7

## Fields

| Field | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `skyColor` | `string` | no |  |  | Hex colour of a `"kind": "color"` sky, and read by nothing else: a scene whose sky is procedural or hdr, or that has no `sky`, ignores it and the contract reports sky-color-ignored. A color sky without it is black. |
| `envMap` | `string` | no |  |  | Deprecated: the earlier spelling of `sky.asset`. Still read, and still exported, so no scene needs migrating. When both are present and name different assets, `sky.asset` wins and the contract reports sky-envmap-conflict. |
| `ambient` | `number` | yes |  |  |  |
| `sky` | `SceneSky` | no |  |  | The sky and the image-based light it casts. Absent means the default procedural clear-noon sky, and `ambient` then keeps its earlier meaning of a flat fill added on top of it. See docs/SKY.md. |
| `fog` | `SceneFog` | no |  |  | Distance fog. Absent: none, unless an atmosphere `sky.preset` supplies one. Drawn by the standard renderer; see docs/SKY.md, Fog. |
| `ocean` | `SceneOcean` | no |  |  | The scene's sea. Absent: no sea. Present turns it on, and lets `buoyancy` bodies float. |
| `gi` | `SceneGi` | no |  |  | Global controls of HD's ray-traced GI. Absent: all at 1. |
| `air` | `SceneAir` | no |  |  | The scene's air: density and wind. Present, `buoyancy` bodies out of the water are buoyed by the air and dragged against the wind (a gas envelope floats). Absent: no air forces. |

## See also

- `SceneSky`
- `SceneFog`
- `SceneOcean`
- `SceneGi`
- `SceneAir`