# `StageSettings.grade`

> Contract 2.0.0 · package sha256 `a857eca95b35921109faf997094bb4192f12527d9d0fcd4be7e97f06425bad6e` · generated from `configurator-runtime.d.ts` by `services/onsite-scripter/scripts/build-contract-docs.mjs`; edit the source, not this file.

Property of [`StageSettings`](StageSettings.md) · stable · since 2.0.0 · called as `session.document.stage.grade`

```ts
grade?: {
  saturation?: number;
};
```

Applied after the tone curve and the output's sRGB encoding, in every render path, capture
included, to every pixel the canvas draws: colour and gradient backgrounds, 'unlit' and
`exactColor` surfaces skip exposure and the curve, not the grade. Never to the runtime's DOM
overlays.
`saturation`: 1 = unchanged.

**Default:** { saturation: 1 }

## Fields

<a id="saturation"></a>
### `saturation`

```ts
saturation?: number;
```

s, the Filter Effects `saturate(s)` matrix (feColorMatrix type 'saturate': R' = (0.213 +
0.787s)R + (0.715 − 0.715s)G + (0.072 − 0.072s)B, and so on), applied per pixel to the
sRGB-encoded, unpremultiplied values, each channel clamped to 0..1, alpha unchanged: the
operation of 1.x's CSS `filter: saturate(s)` on the canvas, so an opaque pixel of the same
colour before it reads the same within 1/255. 1 = unchanged, 0 = that matrix's grey. s is
finite and at least 0, else HoloInputError.

**Default:** 1

## Generic-API test (spec 3.1)

| Rule | Result |
| --- | --- |
| 1. Neutral name | pass: `grade` names no product |
| 2. A precedent | pass: [CSS saturate()](https://developer.mozilla.org/en-US/docs/Web/CSS/filter-function/saturate) (row `G17`) |
| 3. Two apps, or labs | pass: 27 apps (ledger: app-04c2774145, app-0c773a4ee3, app-37356bf09f, app-4762caacdc, app-4f16d2f6da, app-4fd23bc869, app-510d750508, app-59c5b5751e and 19 more; fleet cross-check: app-04c2774145, app-0c773a4ee3, app-4762caacdc, app-4f16d2f6da, app-4fd23bc869, app-510d750508, app-59c5b5751e, app-822bb9d6aa and 14 more) |
| 4. The cheaper fix first | decided per need in Appendix B: rows `G17` at tier stable (a member only where no rule, data, asset or app code serves the need) |