cloudmr-ux 4.3.1 → 4.3.2

package/dist/CmrComponents/niivue-contrast-adjustments/NiivueContrastAdjustments.d.ts

@@ -0,0 +1,91 @@
+import React from "react";
+export interface NiivueContrastAdjustmentsProps {
+    /** The Niivue instance. */
+    nv: any;
+    /**
+     * Current window minimum in real space (mirrors `volumes[0].cal_min`).
+     * Controlled by the parent — updated via `setMin`.
+     */
+    min: number;
+    /**
+     * Current window maximum in real space (mirrors `volumes[0].cal_max`).
+     * Controlled by the parent — updated via `setMax`.
+     */
+    max: number;
+    /** Called with the new real-space minimum when the user moves the low thumb. */
+    setMin: (min: number) => void;
+    /** Called with the new real-space maximum when the user moves the high thumb. */
+    setMax: (max: number) => void;
+    /**
+     * Scaling factors used to convert between real space and the display (render)
+     * space shown in the dual-range input boxes.
+     *
+     * Transform: `renderValue = a * realValue - a * b`
+     * Inverse:   `realValue  = renderValue / a + b`
+     *
+     * Pass `{ a: 1, b: 0 }` for a 1-to-1 mapping (no scientific-notation scaling).
+     */
+    transformFactors: {
+        a: number;
+        b: number;
+    };
+    /** Current gamma value. Controlled by the parent — updated via `setGamma`. */
+    gamma: number;
+    /**
+     * React key forwarded to the gamma slider to force a remount when gamma is
+     * externally reset (e.g. from the Toolbar reset button).
+     */
+    gammaKey: number;
+    /** Called with the new gamma value when the user moves the gamma slider. */
+    setGamma: (val: number) => void;
+    /**
+     * Optional list of layer controls rendered below the gamma slider (e.g.
+     * per-layer color-map pickers). Pass an empty array or omit to render nothing.
+     */
+    layerList?: React.ReactNode[];
+    /**
+     * Heading displayed above the card.
+     * @default "Contrast Adjustments"
+     */
+    title?: string;
+    /**
+     * Accent color used on the dual-range slider and the gamma slider.
+     * @default "#580f8b"
+     */
+    accentColor?: string;
+    style?: React.CSSProperties;
+    className?: string;
+}
+/**
+ * **NiivueContrastAdjustments**
+ *
+ * A reusable "Contrast Adjustments" control panel for a Niivue viewer. Renders:
+ *
+ * 1. A dark **title strip** (`.title` class, same visual style as Slice Position).
+ * 2. An outlined **Card** + **CardContent** containing:
+ *    - A `TKDualRange` for window min/max with optional real→render-space transform.
+ *    - A gamma range slider.
+ *    - An optional `layerList` slot for per-layer controls.
+ *
+ * ### Wiring
+ *
+ * ```tsx
+ * <NiivueContrastAdjustments
+ *   nv={nv}
+ *   min={min}
+ *   max={max}
+ *   setMin={setMin}
+ *   setMax={setMax}
+ *   transformFactors={transformFactors}
+ *   gamma={gamma}
+ *   gammaKey={gammaKey}
+ *   setGamma={setGamma}
+ *   layerList={layerList}
+ * />
+ * ```
+ *
+ * Pass `title=""` to suppress the heading strip, or `title="Window / Level"` to
+ * rename it for a different application.
+ */
+export declare function NiivueContrastAdjustments({ nv, min, max, setMin, setMax, transformFactors, gamma, gammaKey, setGamma, layerList, title, accentColor, style, className, }: NiivueContrastAdjustmentsProps): import("react/jsx-runtime").JSX.Element;
+export default NiivueContrastAdjustments;

package/dist/CmrComponents/niivue-contrast-adjustments/NiivueContrastAdjustments.js

@@ -0,0 +1,74 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Card, CardContent, Box } from "@mui/material";
+import TKDualRange from "../tk-dualrange/TKDualRange";
+import CmrLabel from "../label/Label";
+// ─── Component ────────────────────────────────────────────────────────────────
+/**
+ * **NiivueContrastAdjustments**
+ *
+ * A reusable "Contrast Adjustments" control panel for a Niivue viewer. Renders:
+ *
+ * 1. A dark **title strip** (`.title` class, same visual style as Slice Position).
+ * 2. An outlined **Card** + **CardContent** containing:
+ *    - A `TKDualRange` for window min/max with optional real→render-space transform.
+ *    - A gamma range slider.
+ *    - An optional `layerList` slot for per-layer controls.
+ *
+ * ### Wiring
+ *
+ * ```tsx
+ * <NiivueContrastAdjustments
+ *   nv={nv}
+ *   min={min}
+ *   max={max}
+ *   setMin={setMin}
+ *   setMax={setMax}
+ *   transformFactors={transformFactors}
+ *   gamma={gamma}
+ *   gammaKey={gammaKey}
+ *   setGamma={setGamma}
+ *   layerList={layerList}
+ * />
+ * ```
+ *
+ * Pass `title=""` to suppress the heading strip, or `title="Window / Level"` to
+ * rename it for a different application.
+ */
+export function NiivueContrastAdjustments(_a) {
+    var _b, _c, _d, _e;
+    var nv = _a.nv, min = _a.min, max = _a.max, setMin = _a.setMin, setMax = _a.setMax, transformFactors = _a.transformFactors, gamma = _a.gamma, gammaKey = _a.gammaKey, setGamma = _a.setGamma, _f = _a.layerList, layerList = _f === void 0 ? [] : _f, _g = _a.title, title = _g === void 0 ? "Contrast Adjustments" : _g, _h = _a.accentColor, accentColor = _h === void 0 ? "#580f8b" : _h, style = _a.style, className = _a.className;
+    var a = transformFactors.a, b = transformFactors.b;
+    return (_jsxs("div", __assign({ style: style, className: className }, { children: [title !== "" && (_jsx("div", __assign({ className: "title", style: { width: "100%" } }, { children: title }))), _jsx(Card, __assign({ variant: "outlined", sx: { mb: 2, borderTopLeftRadius: 0, borderTopRightRadius: 0 } }, { children: _jsx(CardContent, { children: _jsxs(Box, __assign({ style: { display: "flex", flex: 1, minWidth: "245px", flexDirection: "column" } }, { children: [_jsx(TKDualRange, { name: "Values:", minDomain: (_c = (_b = nv.volumes[0]) === null || _b === void 0 ? void 0 : _b.robust_min) !== null && _c !== void 0 ? _c : 0, maxDomain: (_e = (_d = nv.volumes[0]) === null || _d === void 0 ? void 0 : _d.robust_max) !== null && _e !== void 0 ? _e : 1, valueLow: min, valueHigh: max, onChangeLow: function (newMin) {
+                                    var v = nv.volumes[0];
+                                    if (!v)
+                                        return;
+                                    v.cal_min = newMin;
+                                    nv.refreshLayers(v, 0, nv.volumes.length);
+                                    nv.drawScene();
+                                    setMin(newMin);
+                                }, onChangeHigh: function (newMax) {
+                                    var v = nv.volumes[0];
+                                    if (!v)
+                                        return;
+                                    v.cal_max = newMax;
+                                    nv.refreshLayers(v, 0, nv.volumes.length);
+                                    nv.drawScene();
+                                    setMax(newMax);
+                                }, transform: function (x) { return a * x - a * b; }, inverse: function (y) { return y / a + b; }, step: 0.001, precision: 3, accentColor: accentColor }), _jsxs("div", __assign({ style: { marginTop: 20, marginBottom: 15 } }, { children: [_jsxs(CmrLabel, __assign({ style: { display: "block", marginBottom: 6 } }, { children: ["Gamma: ", gamma.toFixed(2)] })), _jsx("input", { id: "gamma", type: "range", min: 0.1, max: 3.0, step: 0.05, value: gamma, onChange: function (e) {
+                                            var val = Number(e.target.value);
+                                            setGamma(val);
+                                            nv.setGamma(val);
+                                        }, style: { width: "100%", accentColor: accentColor } }, gammaKey)] })), layerList.length > 0 && (_jsx(Box, __assign({ style: { height: "100%" } }, { children: layerList })))] })) }) }))] })));
+}
+export default NiivueContrastAdjustments;

package/dist/index.d.ts

@@ -23,6 +23,8 @@ export { InvertibleDualSlider } from "./CmrComponents/double-slider/InvertibleDu
 export type { LambdaFile } from "./CmrComponents/upload/Upload";
 export { NiivueSlicePosition } from "./CmrComponents/niivue-slice-position/NiivueSlicePosition";
 export type { NiivueSlicePositionProps } from "./CmrComponents/niivue-slice-position/NiivueSlicePosition";
+export { NiivueContrastAdjustments } from "./CmrComponents/niivue-contrast-adjustments/NiivueContrastAdjustments";
+export type { NiivueContrastAdjustmentsProps } from "./CmrComponents/niivue-contrast-adjustments/NiivueContrastAdjustments";
 import type { FC } from "react";
 import type { CmrTableProps } from "./CmrTable/CmrTable";
 export declare const CmrTable: FC<CmrTableProps>;

package/dist/index.js

@@ -23,6 +23,7 @@ export { DualSlider } from "./CmrComponents/double-slider/DualSlider";
 export { Slider } from "./CmrComponents/gui-slider/Slider";
 export { InvertibleDualSlider } from "./CmrComponents/double-slider/InvertibleDualSlider";
 export { NiivueSlicePosition } from "./CmrComponents/niivue-slice-position/NiivueSlicePosition";
+export { NiivueContrastAdjustments } from "./CmrComponents/niivue-contrast-adjustments/NiivueContrastAdjustments";
 import CmrTableComponent from "./CmrTable/CmrTable";
 export var CmrTable = CmrTableComponent;
 export * from "./core";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudmr-ux",
-  "version": "4.3.1",
+  "version": "4.3.2",
   "author": "erosmontin@gmail.com",
   "license": "MIT",
   "repository": "erosmontin/cloudmr-ux",