@photivra/engine 2.5.0 → 2.7.0

package/dist/facade/chart-scenes.js

@@ -23,6 +23,7 @@
  * levels, like the grey ramp: the step (below 0.1 % of the range) is far below sensor noise.
  * @see docs/QUICK_START.md for the chart catalogue and their analytic definitions.
  */
+import { portablePow } from "../core/portable-math.js";
 import { InvalidConfigurationError } from "../core/configuration-error.js";
 import { prepareColorimetricSpectrum } from "../color/color-matching-functions.js";
 import { requireInputObject, requireInputKeys } from "../core/record-validation.js";
@@ -69,7 +70,8 @@ function finiteIn(value, name, minimum, maximum, open = false) {
 }
 /** Wavelength range every chart spectrum must cover (the facade's sensor quadrature range). */
 export const CHART_SPECTRAL_RANGE_NANOMETERS = Object.freeze({ minimum: 380, maximum: 780 });
-function material(value, name) {
+/** Internal: validates a chart reflectance input (a neutral number or a reflectance spectrum covering 380–780 nm) as a material. */
+export function resolveChartMaterial(value, name) {
     if (typeof value === "number")
         return { kind: "neutral", reflectance: reflectance(value, name) };
     let spectrum;
@@ -124,6 +126,15 @@ export function resolveChartScene(input) {
         throw new InvalidConfigurationError("Chart aspect must be positive.");
     return resolveScene(scene, aspect, { pictureHeight: 2 * aspect, nested: false });
 }
+/**
+ * Internal (not exported from the package): {@link resolveChartScene} with the step wedge's geometric levels computed
+ * with the portable power (`portablePow`, within 1 ulp) instead of `**`, whose last bit differs between JavaScript
+ * engines. Every other value, the geometry and the material order are the same. The display view uses its materials.
+ */
+export function resolvePortableChartScene(input) {
+    requireInputObject(input, "resolveChartScene input");
+    return resolveScene(input.scene, input.aspect, { pictureHeight: 2 * input.aspect, nested: false, pow: portablePow });
+}
 function resolveScene(scene, aspect, context) {
     requireInputObject(scene, "chart scene");
     const preset = scene.preset;
@@ -163,7 +174,7 @@ function resolveScene(scene, aspect, context) {
     };
     switch (preset) {
         case "uniform": {
-            const raw = get("reflectance"), m = material(raw, "reflectance");
+            const raw = get("reflectance"), m = resolveChartMaterial(raw, "reflectance");
             return done({ reflectance: typeof raw === "number" ? raw : "caller-spectrum" }, [m], () => 0, [typeof raw === "number" ? undefined : raw]);
         }
         case "slanted-edge": {
@@ -209,7 +220,7 @@ function resolveScene(scene, aspect, context) {
                 throw new InvalidConfigurationError("spacing must be equal-density or linear.");
             if (!(hi > lo) || (spacing === "equal-density" && lo <= 0))
                 throw new InvalidConfigurationError("Step wedge needs 0 < minimum < maximum reflectance.");
-            const values = calculateStepWedgeReflectances({ steps, minimumReflectance: lo, maximumReflectance: hi, spacing });
+            const values = stepWedgeReflectances(steps, lo, hi, spacing, context.pow);
             return done({ steps, minimumReflectance: lo, maximumReflectance: hi, spacing, stepReflectances: values }, values.map((reflectanceValue) => ({ kind: "neutral", reflectance: reflectanceValue })), (u) => Math.min(steps - 1, Math.max(0, Math.floor((u + 1) / 2 * steps))));
         }
         case "grey-ramp": {
@@ -250,7 +261,7 @@ function resolveScene(scene, aspect, context) {
                 if (typeof p.patchId !== "string" || p.patchId.trim() === "" || ids.has(p.patchId))
                     throw new InvalidConfigurationError("Each patch needs a unique non-empty patchId.");
                 ids.add(p.patchId);
-                materials.push(material(p.reflectance, "patches[" + index + "].reflectance"));
+                materials.push(resolveChartMaterial(p.reflectance, "patches[" + index + "].reflectance"));
                 inputs.push(typeof p.reflectance === "number" ? undefined : p.reflectance);
             }
             const columnsRaw = record.columns === undefined ? Math.ceil(Math.sqrt(list.length)) : record.columns;
@@ -390,7 +401,7 @@ function resolveScene(scene, aspect, context) {
             const list = record.elements;
             if (!Array.isArray(list) || list.length < 1 || list.length > 256)
                 throw new InvalidConfigurationError("elements must list 1 to 256 chart elements.");
-            const nested = { pictureHeight: context.pictureHeight, nested: true };
+            const nested = { pictureHeight: context.pictureHeight, nested: true, ...(context.pow ? { pow: context.pow } : {}) };
             const background = resolveScene(get("background"), aspect, nested);
             const materials = [...background.materials], inputs = [...chartMaterialInputs(background)];
             for (const key of background.defaultedParameters)
@@ -410,7 +421,7 @@ function resolveScene(scene, aspect, context) {
                 if (e.mask === undefined)
                     defaulted.push("elements." + index + ".placement.mask");
                 // The element's own frame: u = ±1 across its width; frequencies keep the composite's picture height.
-                const chart = resolveScene(e.scene, height / width, { pictureHeight: context.pictureHeight * 2 / width, nested: true });
+                const chart = resolveScene(e.scene, height / width, { pictureHeight: context.pictureHeight * 2 / width, nested: true, ...(context.pow ? { pow: context.pow } : {}) });
                 for (const key of chart.defaultedParameters)
                     defaulted.push("elements." + index + ".parameters." + key);
                 const offset = materials.length;
@@ -636,11 +647,14 @@ export function calculateStepWedgeReflectances(input) {
         throw new InvalidConfigurationError("spacing must be equal-density or linear.");
     if (!(hi > lo) || (input.spacing === "equal-density" && lo <= 0))
         throw new InvalidConfigurationError("Step wedge needs 0 < minimum < maximum reflectance.");
+    return stepWedgeReflectances(steps, lo, hi, input.spacing, undefined);
+}
+function stepWedgeReflectances(steps, lo, hi, spacing, pow) {
     return Array.from({ length: steps }, (_, k) => {
         if (k === steps - 1)
             return hi;
         const t = k / (steps - 1);
-        return input.spacing === "linear" ? lo + (hi - lo) * t : lo * (hi / lo) ** t;
+        return spacing === "linear" ? lo + (hi - lo) * t : lo * (pow ? pow(hi / lo, t) : (hi / lo) ** t);
     });
 }
 /** Centres (frame units) of a point grid: one disk centred in each of columns × rows equal cells, row-major from the top-left. */