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 · 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:

Fields ​

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() (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)