@aics/vole-app 3.2.3 → 3.3.1

package/es/aics-image-viewer/components/useVolume.js

@@ -8,13 +8,13 @@ function _regeneratorAsyncIterator(t, e) { function n(r, o, i, f) { try { var c
 function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
 function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
 function _OverloadYield(e, d) { this.v = e, this.k = d; }
-function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
-function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
 function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
@@ -24,13 +24,12 @@ function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
 import { LoadSpec, VolumeLoaderContext } from "@aics/vole-core";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Box3, Vector3 } from "three";
-import { AXIS_TO_LOADER_PRIORITY, CACHE_MAX_SIZE, getDefaultChannelColor, getDefaultViewerChannelSettings, QUEUE_MAX_LOW_PRIORITY_SIZE, QUEUE_MAX_SIZE } from "../shared/constants";
+import { AXIS_TO_LOADER_PRIORITY, CACHE_MAX_SIZE, getDefaultViewerChannelSettings, QUEUE_MAX_LOW_PRIORITY_SIZE, QUEUE_MAX_SIZE } from "../shared/constants";
 import { ViewMode } from "../shared/enums";
 import { useConstructor, useRefWithSetter } from "../shared/utils/hooks";
 import PlayControls from "../shared/utils/playControls";
 import SceneStore from "../shared/utils/sceneStore";
 import { makeChannelIndexGrouping } from "../shared/utils/viewerChannelSettings";
-import { initializeOneChannelSetting } from "../shared/utils/viewerState";
 import { select, useViewerState } from "../state/store";
 export var ImageLoadStatus = /*#__PURE__*/function (ImageLoadStatus) {
   ImageLoadStatus[ImageLoadStatus["REQUESTED"] = 0] = "REQUESTED";
@@ -57,10 +56,14 @@ var CHANNEL_RELOAD = 0;
  */
 var useEffectEventRef = function useEffectEventRef(callback) {
   var callbackRef = useRef(callback);
-  useEffect(function () {
-    callbackRef.current = callback;
-  }, [callback]);
-  return callbackRef;
+  callbackRef.current = callback;
+  return useCallback(function () {
+    var _callbackRef$current;
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+    return (_callbackRef$current = callbackRef.current) === null || _callbackRef$current === void 0 ? void 0 : _callbackRef$current.call.apply(_callbackRef$current, [callbackRef].concat(args));
+  }, [callbackRef]);
 };
 
 /**
@@ -76,7 +79,7 @@ var useEffectEventRef = function useEffectEventRef(callback) {
 var useVolume = function useVolume(scenePaths, options) {
   var channelSettings = useViewerState(select("channelSettings"));
   var changeViewerSetting = useViewerState(select("changeViewerSetting"));
-  var replaceAllChannelSettings = useViewerState(select("replaceAllChannelSettings"));
+  var initChannelSettings = useViewerState(select("initChannelSettings"));
   var onErrorRef = useEffectEventRef(options === null || options === void 0 ? void 0 : options.onError);
   var onChannelLoadedRef = useEffectEventRef(options === null || options === void 0 ? void 0 : options.onChannelLoaded);
   var onChangeSceneRef = useEffectEventRef(options === null || options === void 0 ? void 0 : options.onChangeScene);
@@ -107,6 +110,9 @@ var useVolume = function useVolume(scenePaths, options) {
       setPlayingAxis(axis);
       // prioritize prefetching along the playing axis
       sceneLoader.setPrefetchPriority(axis ? [AXIS_TO_LOADER_PRIORITY[axis]] : []);
+      sceneLoader.updateFetchOptions({
+        onlyPriorityDirections: isPlaying
+      });
       // sync multichannel loading so we don't show loaded channels one at a time
       sceneLoader.syncMultichannelLoading(isPlaying);
       if (image) {
@@ -173,9 +179,8 @@ var useVolume = function useVolume(scenePaths, options) {
     }));
   }, [channelVersionsRef, setChannelVersions]);
   var onError = useCallback(function (e) {
-    var _onErrorRef$current;
     setLoadThrewError(true);
-    (_onErrorRef$current = onErrorRef.current) === null || _onErrorRef$current === void 0 || _onErrorRef$current.call(onErrorRef, e);
+    onErrorRef(e);
     throw e;
   }, [onErrorRef]);
 
@@ -185,10 +190,9 @@ var useVolume = function useVolume(scenePaths, options) {
     channelGroupedByType = _useState10[0],
     setChannelGroupedByType = _useState10[1];
   var onChannelDataLoaded = useCallback(function (aimg, channelIndex) {
-    var _onChannelLoadedRef$c;
     // let the hook caller know that this channel has loaded
     var isInitialLoad = channelVersionsRef.current[channelIndex] === CHANNEL_INITIAL_LOAD;
-    (_onChannelLoadedRef$c = onChannelLoadedRef.current) === null || _onChannelLoadedRef$c === void 0 || _onChannelLoadedRef$c.call(onChannelLoadedRef, aimg, channelIndex, isInitialLoad);
+    onChannelLoadedRef(aimg, channelIndex, isInitialLoad);
 
     // set this channel as loaded
     var newVersions = channelVersionsRef.current.slice();
@@ -200,34 +204,23 @@ var useVolume = function useVolume(scenePaths, options) {
       playControls.onImageLoaded();
     }
   }, [channelVersionsRef, onChannelLoadedRef, playControls, setChannelVersions]);
+  var setChannelStateForNewImage = useCallback(function (channelNames) {
+    var _useViewerState$getSt = useViewerState.getState(),
+      useDefaultViewerChannelSettings = _useViewerState$getSt.useDefaultViewerChannelSettings;
+    var viewerChannelSettings = useDefaultViewerChannelSettings ? getDefaultViewerChannelSettings() : options === null || options === void 0 ? void 0 : options.viewerChannelSettings;
+    var grouping = makeChannelIndexGrouping(channelNames, viewerChannelSettings);
+    setChannelGroupedByType(grouping);
+    return initChannelSettings(channelNames, viewerChannelSettings);
+  }, [initChannelSettings, options === null || options === void 0 ? void 0 : options.viewerChannelSettings]);
 
   // effect to start the initial load of the image
   useEffect(function () {
-    var channelSettings = useViewerState.getState().channelSettings;
     setChannelVersions(new Array(channelVersionsRef.current.length).fill(CHANNEL_INITIAL_LOAD));
     setLoadThrewError(false);
     inInitialLoadRef.current = true;
-    var setChannelStateForNewImage = function setChannelStateForNewImage(channelNames) {
-      var _useViewerState$getSt = useViewerState.getState(),
-        useDefaultViewerChannelSettings = _useViewerState$getSt.useDefaultViewerChannelSettings;
-      var viewerChannelSettings = useDefaultViewerChannelSettings ? getDefaultViewerChannelSettings() : options === null || options === void 0 ? void 0 : options.viewerChannelSettings;
-      var grouping = makeChannelIndexGrouping(channelNames, viewerChannelSettings);
-      setChannelGroupedByType(grouping);
-      var newChannelSettings = channelNames.map(function (name, index) {
-        var _channelSettings$inde;
-        var color = getDefaultChannelColor(index);
-        var channelSetting = (_channelSettings$inde = channelSettings[index]) !== null && _channelSettings$inde !== void 0 ? _channelSettings$inde : initializeOneChannelSetting(name, index, color, viewerChannelSettings);
-        return _objectSpread(_objectSpread({}, channelSetting), {}, {
-          name: name
-        });
-      });
-      replaceAllChannelSettings(newChannelSettings);
-      return newChannelSettings;
-    };
     var openImage = /*#__PURE__*/function () {
       var _ref3 = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
-        var _onCreateImageRef$cur;
-        var scene, time, loadSpec, aimg, channelNames, newChannelSettings, requiredLoadSpec, requiredChannelsToLoad, _useViewerState$getSt2, useDefaultViewerChannelSettings, viewerChannelSettings, maskChannelName, maskChannelIndex, viewMode, slice, onCreateScene;
+        var scene, time, loadSpec, aimg, channelNames, newChannelSettings, requiredLoadSpec, requiredChannelsToLoad, _useViewerState$getSt2, useDefaultViewerChannelSettings, viewerChannelSettings, maskChannelName, maskChannelIndex, viewMode, slice;
         return _regeneratorRuntime().wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
@@ -243,7 +236,7 @@ var useVolume = function useVolume(scenePaths, options) {
               newChannelSettings = setChannelStateForNewImage(channelNames);
               setChannelVersions(new Array(channelNames.length).fill(CHANNEL_INITIAL_LOAD));
               setImage(aimg);
-              (_onCreateImageRef$cur = onCreateImageRef.current) === null || _onCreateImageRef$cur === void 0 || _onCreateImageRef$cur.call(onCreateImageRef, aimg);
+              onCreateImageRef(aimg);
               playControls.stepAxis = function (axis) {
                 var time = useViewerState.getState().time;
                 var slice = useViewerState.getState().slice;
@@ -289,11 +282,10 @@ var useVolume = function useVolume(scenePaths, options) {
 
               // initiate loading only after setting up new channel settings,
               // in case the loader callback fires before the state is set
-              onCreateScene = onChangeSceneRef.current;
               sceneLoader.loadScene(scene, aimg, requiredLoadSpec, {
-                onCreateScene: onCreateScene
+                onCreateScene: onChangeSceneRef
               })["catch"](onError);
-            case 27:
+            case 26:
             case "end":
               return _context.stop();
           }
@@ -304,7 +296,7 @@ var useVolume = function useVolume(scenePaths, options) {
       };
     }();
     openImage();
-  }, [sceneLoader, onError, onCreateImageRef, onChangeSceneRef, onChannelLoadedRef, channelVersionsRef, setChannelVersions, playControls, setIsLoading, onChannelDataLoaded, changeViewerSetting, replaceAllChannelSettings, options === null || options === void 0 ? void 0 : options.viewerChannelSettings]);
+  }, [sceneLoader, onError, onCreateImageRef, onChangeSceneRef, onChannelLoadedRef, channelVersionsRef, setChannelVersions, playControls, setIsLoading, onChannelDataLoaded, changeViewerSetting, initChannelSettings, setChannelStateForNewImage, options === null || options === void 0 ? void 0 : options.viewerChannelSettings]);
   // of the above dependencies, we expect only `sceneLoader` to change.
 
   var setTime = useCallback(function (view3d, time) {
@@ -315,13 +307,26 @@ var useVolume = function useVolume(scenePaths, options) {
   }, [image, onError, setIsLoading, inInitialLoadRef]);
   var setScene = useCallback(function (scene) {
     if (image && !inInitialLoadRef.current) {
-      var onCreateScene = onChangeSceneRef.current;
+      var onCreateScene = function onCreateScene(volume, sceneIndex, loadSpec) {
+        setChannelStateForNewImage(volume.imageInfo.channelNames);
+        volume.updateChannelCount();
+        var prevChannelVersions = channelVersionsRef.current;
+        var newChannelVersions;
+        var addedChannelCount = volume.imageInfo.numChannels - prevChannelVersions.length;
+        if (addedChannelCount > 0) {
+          newChannelVersions = prevChannelVersions.concat(Array(addedChannelCount).fill(CHANNEL_INITIAL_LOAD));
+        } else {
+          newChannelVersions = prevChannelVersions.slice(0, volume.imageInfo.numChannels);
+        }
+        setChannelVersions(newChannelVersions);
+        onChangeSceneRef(volume, sceneIndex, loadSpec);
+      };
       sceneLoader.loadScene(scene, image, undefined, {
         onCreateScene: onCreateScene
       })["catch"](onError);
       setIsLoading(LoadType.SCENE);
     }
-  }, [image, onError, sceneLoader, setIsLoading, inInitialLoadRef, onChangeSceneRef]);
+  }, [image, sceneLoader, onError, setIsLoading, setChannelStateForNewImage, channelVersionsRef, setChannelVersions, onChangeSceneRef]);
   return useMemo(function () {
     return {
       image: image,

package/es/aics-image-viewer/shared/constants.js

@@ -31,7 +31,7 @@ export var TFEDITOR_DEFAULT_COLOR = [255, 255, 255];
 export var TFEDITOR_MAX_BIN = 255;
 export var CACHE_MAX_SIZE = 1000000000;
 export var QUEUE_MAX_SIZE = 10;
-export var QUEUE_MAX_LOW_PRIORITY_SIZE = 4;
+export var QUEUE_MAX_LOW_PRIORITY_SIZE = 6;
 
 /** Maps an axis the user can "play" through to the direction to prefetch while playing that axis */
 export var AXIS_TO_LOADER_PRIORITY = {
@@ -166,6 +166,8 @@ export var getDefaultViewerState = function getDefaultViewerState() {
     scene: 0,
     singleChannelMode: false,
     singleChannelIndex: 0,
+    useExactScaleLevel: false,
+    scaleLevelIndex: 0,
     // Do not override camera position, target, etc. by default;
     // instead, let the viewer apply default camera settings based on the view mode.
     // This prevents a bug where the camera's position and view mode are set to

package/es/aics-image-viewer/shared/utils/playControls.js

@@ -13,6 +13,7 @@ var PlayControls = /*#__PURE__*/function () {
     _defineProperty(this, "playWaitingForLoad", false);
     _defineProperty(this, "playHolding", false);
     _defineProperty(this, "playTimeoutId", 0);
+    _defineProperty(this, "lastStepTime", 0);
   }
   return _createClass(PlayControls, [{
     key: "setPlayingAxis",
@@ -28,11 +29,18 @@ var PlayControls = /*#__PURE__*/function () {
       if (!this.playingAxis || this.playHolding || !this.stepAxis) {
         return;
       }
-      // If the volume is not loaded, wait for it to load before continuing
       if (!((_this$getVolumeIsLoad = this.getVolumeIsLoaded) !== null && _this$getVolumeIsLoad !== void 0 && _this$getVolumeIsLoad.call(this))) {
         this.playWaitingForLoad = true;
         return;
       }
+
+      // Enforce minimum interval between frame *presentations* (not requests).
+      // lastStepTime is set in onImageLoaded when a frame's data arrives.
+      var delay = PLAY_STEP_INTERVAL_MS - (performance.now() - this.lastStepTime);
+      if (delay > 0) {
+        this.playTimeoutId = window.setTimeout(this.playStep.bind(this), delay);
+        return;
+      }
       this.stepAxis(this.playingAxis);
       this.playTimeoutId = window.setTimeout(this.playStep.bind(this), PLAY_STEP_INTERVAL_MS);
     }
@@ -41,6 +49,9 @@ var PlayControls = /*#__PURE__*/function () {
   }, {
     key: "onImageLoaded",
     value: function onImageLoaded() {
+      // Record when the frame was presented, so scheduleNextStep enforces
+      // PLAY_STEP_INTERVAL_MS between presentations (not between requests).
+      this.lastStepTime = performance.now();
       if (this.playWaitingForLoad) {
         this.playWaitingForLoad = false;
         this.playStep();

package/es/aics-image-viewer/shared/utils/sceneStore.js

@@ -1,3 +1,5 @@
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _regeneratorRuntime() { "use strict"; var r = _regenerator(), e = r.m(_regeneratorRuntime), t = (Object.getPrototypeOf ? Object.getPrototypeOf(e) : e.__proto__).constructor; function n(r) { var e = "function" == typeof r && r.constructor; return !!e && (e === t || "GeneratorFunction" === (e.displayName || e.name)); } var o = { "throw": 1, "return": 2, "break": 3, "continue": 3 }; function a(r) { var e, t; return function (n) { e || (e = { stop: function stop() { return t(n.a, 2); }, "catch": function _catch() { return n.v; }, abrupt: function abrupt(r, e) { return t(n.a, o[r], e); }, delegateYield: function delegateYield(r, o, a) { return e.resultName = o, t(n.d, _regeneratorValues(r), a); }, finish: function finish(r) { return t(n.f, r); } }, t = function t(r, _t, o) { n.p = e.prev, n.n = e.next; try { return r(_t, o); } finally { e.next = n.n; } }), e.resultName && (e[e.resultName] = n.v, e.resultName = void 0), e.sent = n.v, e.next = n.n; try { return r.call(this, e); } finally { n.p = e.prev, n.n = e.next; } }; } return (_regeneratorRuntime = function _regeneratorRuntime() { return { wrap: function wrap(e, t, n, o) { return r.w(a(e), t, n, o && o.reverse()); }, isGeneratorFunction: n, mark: r.m, awrap: function awrap(r, e) { return new _OverloadYield(r, e); }, AsyncIterator: _regeneratorAsyncIterator, async: function async(r, e, t, o, u) { return (n(e) ? _regeneratorAsyncGen : _regeneratorAsync)(a(r), e, t, o, u); }, keys: _regeneratorKeys, values: _regeneratorValues }; })(); }
 function _regeneratorValues(e) { if (null != e) { var t = e["function" == typeof Symbol && Symbol.iterator || "@@iterator"], r = 0; if (t) return t.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) return { next: function next() { return e && r >= e.length && (e = void 0), { value: e && e[r++], done: !e }; } }; } throw new TypeError(_typeof(e) + " is not iterable"); }
 function _regeneratorKeys(e) { var n = Object(e), r = []; for (var t in n) r.unshift(t); return function e() { for (; r.length;) if ((t = r.pop()) in n) return e.value = t, e.done = !1, e; return e.done = !0, e; }; }
@@ -16,7 +18,7 @@ function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r),
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-import { VolumeFileFormat } from "@aics/vole-core";
+import { createDefaultMetadata, VolumeFileFormat } from "@aics/vole-core";
 var SceneStore = /*#__PURE__*/function () {
   function SceneStore(context, paths) {
     _classCallCheck(this, SceneStore);
@@ -77,8 +79,8 @@ var SceneStore = /*#__PURE__*/function () {
     key: "loadScene",
     value: function () {
       var _loadScene = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee2(scene, image, loadSpec, options) {
-        var _options$onCreateScen;
-        var loader, spec;
+        var _spec$channels, _options$onCreateScen;
+        var loader, spec, imageInfo, maxTime, adjustedSpec;
         return _regeneratorRuntime().wrap(function _callee2$(_context2) {
           while (1) switch (_context2.prev = _context2.next) {
             case 0:
@@ -91,10 +93,19 @@ var SceneStore = /*#__PURE__*/function () {
               _context2.next = 7;
               return loader.createImageInfo(spec);
             case 7:
-              image.imageInfo.imageInfo = _context2.sent.imageInfo;
-              options === null || options === void 0 || (_options$onCreateScen = options.onCreateScene) === null || _options$onCreateScen === void 0 || _options$onCreateScen.call(options, image, scene);
-              loader.loadVolumeData(image, spec, options === null || options === void 0 ? void 0 : options.onChannelLoaded);
-            case 10:
+              imageInfo = _context2.sent.imageInfo;
+              image.imageInfo.imageInfo = imageInfo;
+              image.imageMetadata = createDefaultMetadata(imageInfo);
+              maxTime = imageInfo.multiscaleLevelDims[imageInfo.multiscaleLevel].shape[0] - 1;
+              adjustedSpec = _objectSpread(_objectSpread({}, spec), {}, {
+                channels: (_spec$channels = spec.channels) === null || _spec$channels === void 0 ? void 0 : _spec$channels.filter(function (channelIndex) {
+                  return channelIndex < imageInfo.channelNames.length;
+                }),
+                time: Math.min(spec.time, maxTime)
+              });
+              options === null || options === void 0 || (_options$onCreateScen = options.onCreateScene) === null || _options$onCreateScen === void 0 || _options$onCreateScen.call(options, image, scene, adjustedSpec);
+              loader.loadVolumeData(image, adjustedSpec, options === null || options === void 0 ? void 0 : options.onChannelLoaded);
+            case 14:
             case "end":
               return _context2.stop();
           }
@@ -147,6 +158,14 @@ var SceneStore = /*#__PURE__*/function () {
         currentLoader.setPrefetchPriority(priority);
       }
     }
+  }, {
+    key: "updateFetchOptions",
+    value: function updateFetchOptions(fetchOptions) {
+      var currentLoader = this.loaders[this.currentScene];
+      if (currentLoader) {
+        currentLoader.updateFetchOptions(fetchOptions);
+      }
+    }
   }]);
 }();
 export { SceneStore as default };

package/es/aics-image-viewer/shared/utils/test/urlParsing.test.js

@@ -438,7 +438,9 @@ describe("Viewer state", function () {
     scene: 0,
     cameraState: undefined,
     singleChannelMode: false,
-    singleChannelIndex: 0
+    singleChannelIndex: 0,
+    useExactScaleLevel: false,
+    scaleLevelIndex: 0
   };
   var SERIALIZED_DEFAULT_VIEWER_STATE = {
     mode: "volumetric",
@@ -459,7 +461,9 @@ describe("Viewer state", function () {
     t: "0",
     scene: "0",
     scm: "0",
-    sci: "0"
+    sci: "0",
+    esl: "0",
+    scl: "0"
   };
   var CUSTOM_VIEWER_STATE = {
     renderMode: RenderMode.pathTrace,
@@ -489,6 +493,8 @@ describe("Viewer state", function () {
     scene: 3,
     singleChannelMode: true,
     singleChannelIndex: 3,
+    useExactScaleLevel: true,
+    scaleLevelIndex: 3,
     cameraState: {
       position: [-1.05, -4, 45],
       target: [0, 0, 0],
@@ -517,6 +523,8 @@ describe("Viewer state", function () {
     scene: "3",
     scm: "1",
     sci: "3",
+    esl: "1",
+    scl: "3",
     cam: "pos:-1.05:-4:45,tar:0:0:0,up:0:1:0,ort:3.534,fov:43.5"
   };
   describe("serializeViewerState", function () {

package/es/aics-image-viewer/shared/utils/urlParsing.js

@@ -1,5 +1,5 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
-var _ViewerChannelSetting, _ViewerChannelSetting2, _ViewerChannelSetting3, _ViewerChannelSetting4, _ViewerChannelSetting5, _ViewerChannelSetting6, _ViewerChannelSetting7, _ViewerChannelSetting8, _ViewerChannelSetting9, _ViewerChannelSetting10, _ViewerChannelSetting11, _ViewerChannelSetting12, _ViewerChannelSetting13, _ViewerChannelSetting14, _ViewerStateKeys$View, _ViewerStateKeys$Mode, _ViewerStateKeys$Mask, _ViewerStateKeys$Imag, _ViewerStateKeys$Axes, _ViewerStateKeys$Boun, _ViewerStateKeys$Sing, _ViewerStateKeys$Sing2, _ViewerStateKeys$Boun2, _ViewerStateKeys$Back, _ViewerStateKeys$Auto, _ViewerStateKeys$Brig, _ViewerStateKeys$Dens, _ViewerStateKeys$Leve, _ViewerStateKeys$Inte, _ViewerStateKeys$Regi, _ViewerStateKeys$Slic, _ViewerStateKeys$Time, _ViewerStateKeys$Scen, _ViewerStateKeys$Came;
+var _ViewerChannelSetting, _ViewerChannelSetting2, _ViewerChannelSetting3, _ViewerChannelSetting4, _ViewerChannelSetting5, _ViewerChannelSetting6, _ViewerChannelSetting7, _ViewerChannelSetting8, _ViewerChannelSetting9, _ViewerChannelSetting10, _ViewerChannelSetting11, _ViewerChannelSetting12, _ViewerChannelSetting13, _ViewerChannelSetting14, _ViewerStateKeys$View, _ViewerStateKeys$Mode, _ViewerStateKeys$Mask, _ViewerStateKeys$Imag, _ViewerStateKeys$Axes, _ViewerStateKeys$Boun, _ViewerStateKeys$Sing, _ViewerStateKeys$Sing2, _ViewerStateKeys$Boun2, _ViewerStateKeys$Back, _ViewerStateKeys$Auto, _ViewerStateKeys$Brig, _ViewerStateKeys$Dens, _ViewerStateKeys$Leve, _ViewerStateKeys$Inte, _ViewerStateKeys$Regi, _ViewerStateKeys$Slic, _ViewerStateKeys$Time, _ViewerStateKeys$Scen, _ViewerStateKeys$UseE, _ViewerStateKeys$Scal, _ViewerStateKeys$Came;
 function _regeneratorRuntime() { "use strict"; var r = _regenerator(), e = r.m(_regeneratorRuntime), t = (Object.getPrototypeOf ? Object.getPrototypeOf(e) : e.__proto__).constructor; function n(r) { var e = "function" == typeof r && r.constructor; return !!e && (e === t || "GeneratorFunction" === (e.displayName || e.name)); } var o = { "throw": 1, "return": 2, "break": 3, "continue": 3 }; function a(r) { var e, t; return function (n) { e || (e = { stop: function stop() { return t(n.a, 2); }, "catch": function _catch() { return n.v; }, abrupt: function abrupt(r, e) { return t(n.a, o[r], e); }, delegateYield: function delegateYield(r, o, a) { return e.resultName = o, t(n.d, _regeneratorValues(r), a); }, finish: function finish(r) { return t(n.f, r); } }, t = function t(r, _t, o) { n.p = e.prev, n.n = e.next; try { return r(_t, o); } finally { e.next = n.n; } }), e.resultName && (e[e.resultName] = n.v, e.resultName = void 0), e.sent = n.v, e.next = n.n; try { return r.call(this, e); } finally { n.p = e.prev, n.n = e.next; } }; } return (_regeneratorRuntime = function _regeneratorRuntime() { return { wrap: function wrap(e, t, n, o) { return r.w(a(e), t, n, o && o.reverse()); }, isGeneratorFunction: n, mark: r.m, awrap: function awrap(r, e) { return new _OverloadYield(r, e); }, AsyncIterator: _regeneratorAsyncIterator, async: function async(r, e, t, o, u) { return (n(e) ? _regeneratorAsyncGen : _regeneratorAsync)(a(r), e, t, o, u); }, keys: _regeneratorKeys, values: _regeneratorValues }; })(); }
 function _regeneratorValues(e) { if (null != e) { var t = e["function" == typeof Symbol && Symbol.iterator || "@@iterator"], r = 0; if (t) return t.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) return { next: function next() { return e && r >= e.length && (e = void 0), { value: e && e[r++], done: !e }; } }; } throw new TypeError(_typeof(e) + " is not iterable"); }
 function _regeneratorKeys(e) { var n = Object(e), r = []; for (var t in n) r.unshift(t); return function e() { for (; r.length;) if ((t = r.pop()) in n) return e.value = t, e.done = !1, e; return e.done = !0, e; }; }
@@ -113,6 +113,8 @@ export var ViewerStateKeys = /*#__PURE__*/function (ViewerStateKeys) {
   ViewerStateKeys["CameraState"] = "cam";
   ViewerStateKeys["SingleChannelMode"] = "scm";
   ViewerStateKeys["SingleChannelIndex"] = "sci";
+  ViewerStateKeys["UseExactScaleLevel"] = "esl";
+  ViewerStateKeys["ScaleLevelIndex"] = "scl";
   return ViewerStateKeys;
 }({});
 export var CameraTransformKeys = /*#__PURE__*/function (CameraTransformKeys) {
@@ -272,6 +274,8 @@ _ViewerStateKeys$Regi = ViewerStateKeys.Region;
 _ViewerStateKeys$Slic = ViewerStateKeys.Slice;
 _ViewerStateKeys$Time = ViewerStateKeys.Time;
 _ViewerStateKeys$Scen = ViewerStateKeys.Scene;
+_ViewerStateKeys$UseE = ViewerStateKeys.UseExactScaleLevel;
+_ViewerStateKeys$Scal = ViewerStateKeys.ScaleLevelIndex;
 _ViewerStateKeys$Came = ViewerStateKeys.CameraState;
 /** Serialized version of `ViewerState`. */
 export var ViewerStateParams = /*#__PURE__*/_createClass(function ViewerStateParams() {
@@ -325,6 +329,10 @@ export var ViewerStateParams = /*#__PURE__*/_createClass(function ViewerStatePar
   _defineProperty(this, _ViewerStateKeys$Time, undefined);
   /** Scene number, for multiscene images. 0 by default. */
   _defineProperty(this, _ViewerStateKeys$Scen, undefined);
+  /** Whether to use an exact scale level index. 0 by default. */
+  _defineProperty(this, _ViewerStateKeys$UseE, undefined);
+  /** The exact scale level index to use, if `UseExactScaleLevel` is 1. 0 by default. */
+  _defineProperty(this, _ViewerStateKeys$Scal, undefined);
   /**
    * Camera transform settings, as a list of `key:value` pairs separated by commas.
    * Valid keys are defined in `CameraTransformKeys`:
@@ -952,6 +960,8 @@ export function deserializeViewerState(params) {
     renderMode: parseStringEnum(params[ViewerStateKeys.Mode], RenderMode),
     singleChannelMode: parseStringBoolean(params[ViewerStateKeys.SingleChannelMode]),
     singleChannelIndex: parseStringInt(params[ViewerStateKeys.SingleChannelIndex], 0, Number.POSITIVE_INFINITY),
+    useExactScaleLevel: parseStringBoolean(params[ViewerStateKeys.UseExactScaleLevel]),
+    scaleLevelIndex: parseStringInt(params[ViewerStateKeys.ScaleLevelIndex], 0, Number.MAX_SAFE_INTEGER),
     cameraState: parseCameraState(params[ViewerStateKeys.CameraState])
   };
 
@@ -983,11 +993,15 @@ export function deserializeViewerState(params) {
  * @returns A `ViewerStateParams` object with the serialized parameters. Undefined values are removed.
  */
 export function serializeViewerState(state, removeDefaults) {
-  var _state$maskAlpha, _state$brightness, _state$density, _state$levels, _state$time, _state$scene, _state$singleChannelI, _result;
+  var _state$maskAlpha, _state$brightness, _state$density, _state$levels, _state$time, _state$scene, _state$singleChannelI, _state$scaleLevelInde, _result;
   if (removeDefaults) {
     state = removeMatchingProperties(state, getDefaultViewerState());
+    // special case: if there's an explicit scale level but it's not being used, no reason to include it
+    if (state.scaleLevelIndex !== undefined && state.useExactScaleLevel === undefined) {
+      delete state.scaleLevelIndex;
+    }
   }
-  var result = (_result = {}, _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_result, ViewerStateKeys.Mode, state.renderMode), ViewerStateKeys.Mask, (_state$maskAlpha = state.maskAlpha) === null || _state$maskAlpha === void 0 ? void 0 : _state$maskAlpha.toString()), ViewerStateKeys.Image, state.imageType), ViewerStateKeys.Axes, serializeBoolean(state.showAxes)), ViewerStateKeys.BoundingBox, serializeBoolean(state.showBoundingBox)), ViewerStateKeys.BoundingBoxColor, state.boundingBoxColor && colorArrayToHex(state.boundingBoxColor)), ViewerStateKeys.BackgroundColor, state.backgroundColor && colorArrayToHex(state.backgroundColor)), ViewerStateKeys.Autorotate, serializeBoolean(state.autorotate)), ViewerStateKeys.Brightness, (_state$brightness = state.brightness) === null || _state$brightness === void 0 ? void 0 : _state$brightness.toString()), ViewerStateKeys.Density, (_state$density = state.density) === null || _state$density === void 0 ? void 0 : _state$density.toString()), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_result, ViewerStateKeys.Interpolation, serializeBoolean(state.interpolationEnabled)), ViewerStateKeys.Region, state.region && serializeRegion(state.region)), ViewerStateKeys.Slice, state.slice && serializeSlice(state.slice)), ViewerStateKeys.Levels, (_state$levels = state.levels) === null || _state$levels === void 0 ? void 0 : _state$levels.join(",")), ViewerStateKeys.Time, (_state$time = state.time) === null || _state$time === void 0 ? void 0 : _state$time.toString()), ViewerStateKeys.Scene, (_state$scene = state.scene) === null || _state$scene === void 0 ? void 0 : _state$scene.toString()), ViewerStateKeys.SingleChannelMode, serializeBoolean(state.singleChannelMode)), ViewerStateKeys.SingleChannelIndex, (_state$singleChannelI = state.singleChannelIndex) === null || _state$singleChannelI === void 0 ? void 0 : _state$singleChannelI.toString()), ViewerStateKeys.CameraState, state.cameraState && serializeCameraState(state.cameraState, removeDefaults, state.viewMode)));
+  var result = (_result = {}, _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_result, ViewerStateKeys.Mode, state.renderMode), ViewerStateKeys.Mask, (_state$maskAlpha = state.maskAlpha) === null || _state$maskAlpha === void 0 ? void 0 : _state$maskAlpha.toString()), ViewerStateKeys.Image, state.imageType), ViewerStateKeys.Axes, serializeBoolean(state.showAxes)), ViewerStateKeys.BoundingBox, serializeBoolean(state.showBoundingBox)), ViewerStateKeys.BoundingBoxColor, state.boundingBoxColor && colorArrayToHex(state.boundingBoxColor)), ViewerStateKeys.BackgroundColor, state.backgroundColor && colorArrayToHex(state.backgroundColor)), ViewerStateKeys.Autorotate, serializeBoolean(state.autorotate)), ViewerStateKeys.Brightness, (_state$brightness = state.brightness) === null || _state$brightness === void 0 ? void 0 : _state$brightness.toString()), ViewerStateKeys.Density, (_state$density = state.density) === null || _state$density === void 0 ? void 0 : _state$density.toString()), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_result, ViewerStateKeys.Interpolation, serializeBoolean(state.interpolationEnabled)), ViewerStateKeys.Region, state.region && serializeRegion(state.region)), ViewerStateKeys.Slice, state.slice && serializeSlice(state.slice)), ViewerStateKeys.Levels, (_state$levels = state.levels) === null || _state$levels === void 0 ? void 0 : _state$levels.join(",")), ViewerStateKeys.Time, (_state$time = state.time) === null || _state$time === void 0 ? void 0 : _state$time.toString()), ViewerStateKeys.Scene, (_state$scene = state.scene) === null || _state$scene === void 0 ? void 0 : _state$scene.toString()), ViewerStateKeys.SingleChannelMode, serializeBoolean(state.singleChannelMode)), ViewerStateKeys.SingleChannelIndex, (_state$singleChannelI = state.singleChannelIndex) === null || _state$singleChannelI === void 0 ? void 0 : _state$singleChannelI.toString()), ViewerStateKeys.UseExactScaleLevel, serializeBoolean(state.useExactScaleLevel)), ViewerStateKeys.ScaleLevelIndex, (_state$scaleLevelInde = state.scaleLevelIndex) === null || _state$scaleLevelInde === void 0 ? void 0 : _state$scaleLevelInde.toString()), _defineProperty(_result, ViewerStateKeys.CameraState, state.cameraState && serializeCameraState(state.cameraState, removeDefaults, state.viewMode)));
   var viewModeToViewParam = _defineProperty(_defineProperty(_defineProperty(_defineProperty({}, ViewMode.threeD, "3D"), ViewMode.xy, "Z"), ViewMode.xz, "Y"), ViewMode.yz, "X");
   result[ViewerStateKeys.View] = state.viewMode && viewModeToViewParam[state.viewMode];
   return removeUndefinedProperties(result);

package/es/aics-image-viewer/shared/utils/viewerChannelSettings.js

@@ -87,12 +87,11 @@ export function findFirstChannelMatch(channel, channelIndex, settings) {
 }
 export function getDisplayName(name, index, settings) {
   if (settings) {
+    var _c$name;
     var c = findFirstChannelMatch(name, index, settings);
-    if (c) {
-      return c.name || name;
-    }
+    return (_c$name = c === null || c === void 0 ? void 0 : c.name) !== null && _c$name !== void 0 ? _c$name : name;
   }
-  return name;
+  return name !== null && name !== void 0 ? name : index.toString();
 }
 export function makeChannelIndexGrouping(channels, settings) {
   if (!channels) {

package/es/aics-image-viewer/state/store.js

@@ -6,14 +6,15 @@ function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol"
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { create } from "zustand";
 import { subscribeWithSelector } from "zustand/middleware";
-import { getDefaultViewerState } from "../shared/constants";
+import { getDefaultChannelColor, getDefaultViewerState } from "../shared/constants";
+import { initializeOneChannelSetting } from "../shared/utils/viewerState";
 import { createResetSlice } from "./reset";
 import { validateState, validateStateValue } from "./util";
-var createViewerStateStore = function createViewerStateStore(set) {
-  for (var _len = arguments.length, etc = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
-    etc[_key - 1] = arguments[_key];
+var createViewerStateStore = function createViewerStateStore(set, get) {
+  for (var _len = arguments.length, etc = new Array(_len > 2 ? _len - 2 : 0), _key = 2; _key < _len; _key++) {
+    etc[_key - 2] = arguments[_key];
   }
-  return _objectSpread(_objectSpread(_objectSpread({}, createResetSlice.apply(void 0, [set].concat(etc))), getDefaultViewerState()), {}, {
+  return _objectSpread(_objectSpread(_objectSpread({}, createResetSlice.apply(void 0, [set, get].concat(etc))), getDefaultViewerState()), {}, {
     channelSettings: [],
     changeViewerSetting: function changeViewerSetting(key, value) {
       return set(function (state) {
@@ -41,6 +42,21 @@ var createViewerStateStore = function createViewerStateStore(set) {
         channelSettings: channelSettings
       });
     },
+    initChannelSettings: function initChannelSettings(names, settings) {
+      var currentSettings = get().channelSettings;
+      var channelSettings = names.map(function (name, index) {
+        var _currentSettings$inde;
+        var color = getDefaultChannelColor(index);
+        var channelSetting = (_currentSettings$inde = currentSettings[index]) !== null && _currentSettings$inde !== void 0 ? _currentSettings$inde : initializeOneChannelSetting(name, index, color, settings);
+        return _objectSpread(_objectSpread({}, channelSetting), {}, {
+          name: name
+        });
+      });
+      set({
+        channelSettings: channelSettings
+      });
+      return channelSettings;
+    },
     applyColorPresets: function applyColorPresets(colors) {
       set(function (_ref2) {
         var channelSettings = _ref2.channelSettings;
@@ -77,7 +93,9 @@ export var selectViewerSettings = function selectViewerSettings(store) {
     scene: store.scene,
     cameraState: store.cameraState,
     singleChannelMode: store.singleChannelMode,
-    singleChannelIndex: store.singleChannelIndex
+    singleChannelIndex: store.singleChannelIndex,
+    useExactScaleLevel: store.useExactScaleLevel,
+    scaleLevelIndex: store.scaleLevelIndex
   };
 };
 

package/es/aics-image-viewer/state/subscribers.js

@@ -139,7 +139,28 @@ export var subscribeImageToState = function subscribeImageToState(store, view3d,
   // interpolation
   store.subscribe(select("interpolationEnabled"), function (enabled) {
     return view3d.setInterpolationEnabled(image, enabled);
-  }, REF_EQ),
+  }, REF_EQ), store.subscribe(function (_ref3) {
+    var useExactScaleLevel = _ref3.useExactScaleLevel,
+      scaleLevelIndex = _ref3.scaleLevelIndex;
+    return {
+      useExactScaleLevel: useExactScaleLevel,
+      scaleLevelIndex: scaleLevelIndex
+    };
+  }, function (_ref4) {
+    var useExactScaleLevel = _ref4.useExactScaleLevel,
+      scaleLevelIndex = _ref4.scaleLevelIndex;
+    if (useExactScaleLevel) {
+      image.updateRequiredData({
+        useExplicitLevel: true,
+        multiscaleLevel: scaleLevelIndex
+      });
+    } else {
+      image.updateRequiredData({
+        useExplicitLevel: false,
+        multiscaleLevel: undefined
+      });
+    }
+  }, DEEP_EQ),
   // clipping
   store.subscribe(selectAxisClipUpdateInfo("x"), axisClipUpdater("x"), DEEP_EQ), store.subscribe(selectAxisClipUpdateInfo("y"), axisClipUpdater("y"), DEEP_EQ), store.subscribe(selectAxisClipUpdateInfo("z"), axisClipUpdater("z"), DEEP_EQ)
 

package/es/aics-image-viewer/state/test/reset.test.js

@@ -40,7 +40,9 @@ var arbitraryViewerState = function arbitraryViewerState() {
     scene: 3,
     singleChannelMode: true,
     singleChannelIndex: 3,
-    cameraState: undefined
+    cameraState: undefined,
+    useExactScaleLevel: true,
+    scaleLevelIndex: 3
   };
 };
 var arbitraryChannelState = function arbitraryChannelState() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aics/vole-app",
-  "version": "3.2.3",
+  "version": "3.3.1",
   "description": "web view of cell volume images",
   "main": "es/index.js",
   "module": "es/index.js",
@@ -25,6 +25,7 @@
     "gh-build-nightly": "webpack --config webpack.dev.js --env env=production basename=/vole-app/",
     "gh-build-release": "webpack --config webpack.dev.js --env env=production basename=/website-3d-cell-viewer-release/",
     "s3-build": "webpack --config webpack.dev.js --env env=production",
+    "release-build": "webpack --config webpack.dev.js --env env=production",
     "docker-build": "webpack --config webpack.common.js --env env=production",
     "dev": "webpack --config webpack.dev.js --env env=dev",
     "lint": "eslint --config ./.eslintrc --ignore-path ./.eslintignore --ext .jsx --ext .js --ext .ts --ext .tsx ./",
@@ -43,9 +44,9 @@
     "checks": "npm run lint && npm run typeCheck && npm run test"
   },
   "author": "Megan Riel-Mehan",
-  "license": "ISC",
+  "license": "BSD-3-Clause",
   "dependencies": {
-    "@aics/vole-core": "^4.6.4",
+    "@aics/vole-core": "^4.9.1",
     "@ant-design/icons": "^5.2.5",
     "@fortawesome/fontawesome-svg-core": "^6.5.2",
     "@fortawesome/free-solid-svg-icons": "^6.5.2",
@@ -65,8 +66,7 @@
   "peerDependencies": {
     "antd": "^5.16.2",
     "react": "18.x",
-    "react-dom": "18.x",
-    "three": "^0.171.0"
+    "react-dom": "18.x"
   },
   "devDependencies": {
     "@babel/cli": "^7.14.5",

package/type-declarations/aics-image-viewer/components/App/types.d.ts

@@ -5,7 +5,7 @@ import type { ViewerChannelSettings } from "../../shared/utils/viewerChannelSett
 import type { ViewerState } from "../../state/types";
 /** `typeof useEffect`, but the effect handler takes a `Volume` as an argument */
 export type UseImageEffectType = (effect: (image: Volume) => void | (() => void), deps: React.DependencyList) => void;
-type ControlNames = "alphaMaskSlider" | "autoRotateButton" | "axisClipSliders" | "brightnessSlider" | "backgroundColorPicker" | "boundingBoxColorPicker" | "colorPresetsDropdown" | "densitySlider" | "levelsSliders" | "interpolationControl" | "saveSurfaceButtons" | "fovCellSwitchControls" | "viewModeRadioButtons" | "resetCameraButton" | "showAxesButton" | "showBoundingBoxButton" | "metadataViewer";
+type ControlNames = "alphaMaskSlider" | "autoRotateButton" | "axisClipSliders" | "brightnessSlider" | "backgroundColorPicker" | "boundingBoxColorPicker" | "colorPresetsDropdown" | "densitySlider" | "levelsSliders" | "interpolationControl" | "saveSurfaceButtons" | "fovCellSwitchControls" | "viewModeRadioButtons" | "resetCameraButton" | "showAxesButton" | "showBoundingBoxButton" | "metadataViewer" | "scaleLevelControls";
 /** Show/hide different elements of the UI */
 export type ControlVisibilityFlags = {
     [K in ControlNames]: boolean;
@@ -41,7 +41,7 @@ export interface AppProps {
     view3dRef?: MutableRefObject<View3d | null>;
     metadataFormatter?: (metadata: MetadataRecord) => MetadataRecord;
     onControlPanelToggle?: (collapsed: boolean) => void;
-    showError?: (error: any) => void;
+    showError?: (error: unknown, image?: Volume) => void;
     onImageTitleChange?: (title: string | undefined) => void;
 }
 export {};