# gradeVolume

> Talos next · Since next

A box with its own colour grade (HD), a post-process volume: as the camera enters, the scene's look blends toward `look` by `weight`, fading over `blend` metres outside; higher `priority` wins where volumes overlap.

The box comes from the entity's transform and `size`; `unbound` applies it everywhere. At most 16 count. Drawn only by HD (hd-only-ignored on other profiles).

Use it in a scene entity's `components` list as `{ "type": "gradeVolume", … }`. The contract writes the fields flat and refuses unknown keys.

## Fields

| Field | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `size` | `Vec3` | no |  |  | Full extents of the box along the entity's local axes before its scale, metres; each more than 0. Required unless `unbound`. |
| `unbound` | `boolean` | no | `false` |  | The volume applies everywhere (a level-wide grade layered over the scene's), and `size` and `blend` are not read. Default false. |
| `look` | `RenderLook` | yes |  |  | The grade inside the volume: the fields of `meta.render.look`, each blended over the look underneath. |
| `blend` | `number` | no | `1` |  | Metres outside the box over which the grade fades out as the camera leaves, 0 or more. Default 1. |
| `priority` | `number` | no | `0` |  | Order where volumes overlap: higher applies later and wins. Default 0. |
| `weight` | `number` | no | `1` |  | Strength inside the box, 0..1. Default 1. |