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