omezarr-tilesource 0.3.0 → 0.4.0

package/README.md

@@ -40,8 +40,8 @@ const tileSource2 = {
     url: url,
     // zip: undefined,  // undefined = OME-Zarr ZIP auto-detection based on .ozx suffix
     // c: undefined,  // undefined = composite of all active channels (requires dataType "context2d")
-    // z: undefined,  // undefined = omero metadata default
-    // t: undefined,  // undefined = omero metadata default
+    // z: undefined,  // undefined = omero rdefs default (middle z-slice if missing)
+    // t: undefined,  // undefined = omero rdefs default (middle timepoint if missing)
     // dataType: undefined,  // "context2d" (default, rendered tiles) or "ome-zarr" (raw single-channel chunks)
     // autoBoost: undefined  // boost brightness of dark tiles (default false)
 };
@@ -54,8 +54,8 @@ const tileSource4 = new OMEZarrTileSource({
     url: url,
     // zip: undefined,  // undefined = OME-Zarr ZIP auto-detection based on .ozx suffix
     // c: undefined,  // undefined = composite of all active channels (requires dataType "context2d")
-    // z: undefined,  // undefined = omero metadata default
-    // t: undefined,  // undefined = omero metadata default
+    // z: undefined,  // undefined = omero rdefs default (middle z-slice if missing)
+    // t: undefined,  // undefined = omero rdefs default (middle timepoint if missing)
     // dataType: undefined,  // "context2d" (default, rendered tiles) or "ome-zarr" (raw single-channel chunks)
     // autoBoost: undefined  // boost brightness of dark tiles (default false)
 });
@@ -71,6 +71,48 @@ const viewer = OpenSeadragon(
 );
 ```
 
+### Accessing OME-Zarr metadata
+
+Directly instantiated tile sources start loading the OME-Zarr metadata
+immediately. Await `whenReady()` (or use the `OMEZarrTileSource.open` shortcut)
+to access the `NgffImage` instance (ome-zarr.js) and the opened zarrita arrays
+(one per resolution level) before adding the tile source to a viewer:
+
+```javascript
+const tileSource = await OMEZarrTileSource.open({ url: url, c: 0 });
+// equivalent: await new OMEZarrTileSource({ url: url, c: 0 }).whenReady();
+
+console.log(tileSource.image.getAxesNames()); // e.g. ["t", "z", "c", "y", "x"]
+console.log(tileSource.image.omero?.channels); // omero channel metadata
+console.log(tileSource.arrays[0].shape); // full-resolution array shape
+
+viewer.addTiledImage({ tileSource: tileSource }); // no second metadata request
+```
+
+The metadata is loaded once per tile source instance: OpenSeadragon reuses a
+tile source instance passed to it as-is (waiting for it to become ready if
+necessary), whereas a URL or an inline configuration object makes OpenSeadragon
+create (and load) a new instance. `whenReady()` rejects (and `image`/`arrays`
+throw) if loading fails.
+
+### Sharing OME-Zarr metadata between tile sources
+
+A loaded `NgffImage` can be reused by other directly instantiated tile sources
+for the same URL (e.g. one tile source per channel) by passing it as the second
+constructor argument (also supported by `OMEZarrTileSource.open`). This skips
+loading the OME-Zarr metadata (the `zip` option is ignored) and reuses the
+opened zarrita arrays, which ome-zarr.js caches on the `NgffImage` instance.
+The tile source never modifies the `NgffImage`, so sharing is safe:
+
+```javascript
+const tileSource1 = await OMEZarrTileSource.open({ url: url, c: 0 });
+const tileSource2 = new OMEZarrTileSource(
+  { url: url, c: 1 },
+  tileSource1.image,
+);
+// or, without a first tile source: NgffImage.load(url) from ome-zarr.js
+```
+
 ## Data pipeline
 
 By default (`dataType: "context2d"`), tiles are rendered by the tile source and
@@ -79,6 +121,11 @@ passed to OpenSeadragon as 2D canvas contexts, using the rendering settings
 multi-channel images without `c`, all active channels are rendered into a
 composite image.
 
+Contrast limits are taken from the omero channel windows (`window.start`,
+`window.end`). Channels without them are rendered using the data type range
+for integer types (e.g. `[0, 65535]` for `uint16`) and `[0, 1]` for floating
+point types.
+
 With `dataType: "ome-zarr"`, tiles are instead downloaded as raw single-channel
 zarrita chunks and passed to OpenSeadragon with the data type `ome-zarr` (see
 the `OMEZarrTileData` type). Multi-channel images therefore require the `c`

package/dist/{__vite-browser-external-BIIyDRRX.js → __vite-browser-external-B2tgTj77.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./chunk-BXES_1_E.js";
+import { t as e } from "./omezarr-tilesource.js";
 //#region __vite-browser-external
 var t = /* @__PURE__ */ e(((e, t) => {
 	t.exports = {};

package/dist/dist-DXBnbeGc.js

@@ -0,0 +1,90 @@
+//#region node_modules/.pnpm/vite-plugin-node-polyfills@0.28.0_vite@8.0.14_yaml@2.9.0_/node_modules/vite-plugin-node-polyfills/shims/process/dist/index.js
+function e(e) {
+	return e && e.__esModule && Object.prototype.hasOwnProperty.call(e, "default") ? e.default : e;
+}
+var t = { exports: {} }, n = t.exports = {}, r, i;
+function a() {
+	throw Error("setTimeout has not been defined");
+}
+function o() {
+	throw Error("clearTimeout has not been defined");
+}
+(function() {
+	try {
+		r = typeof setTimeout == "function" ? setTimeout : a;
+	} catch {
+		r = a;
+	}
+	try {
+		i = typeof clearTimeout == "function" ? clearTimeout : o;
+	} catch {
+		i = o;
+	}
+})();
+function s(e) {
+	if (r === setTimeout) return setTimeout(e, 0);
+	if ((r === a || !r) && setTimeout) return r = setTimeout, setTimeout(e, 0);
+	try {
+		return r(e, 0);
+	} catch {
+		try {
+			return r.call(null, e, 0);
+		} catch {
+			return r.call(this, e, 0);
+		}
+	}
+}
+function c(e) {
+	if (i === clearTimeout) return clearTimeout(e);
+	if ((i === o || !i) && clearTimeout) return i = clearTimeout, clearTimeout(e);
+	try {
+		return i(e);
+	} catch {
+		try {
+			return i.call(null, e);
+		} catch {
+			return i.call(this, e);
+		}
+	}
+}
+var l = [], u = !1, d, f = -1;
+function p() {
+	!u || !d || (u = !1, d.length ? l = d.concat(l) : f = -1, l.length && m());
+}
+function m() {
+	if (!u) {
+		var e = s(p);
+		u = !0;
+		for (var t = l.length; t;) {
+			for (d = l, l = []; ++f < t;) d && d[f].run();
+			f = -1, t = l.length;
+		}
+		d = null, u = !1, c(e);
+	}
+}
+n.nextTick = function(e) {
+	var t = Array(arguments.length - 1);
+	if (arguments.length > 1) for (var n = 1; n < arguments.length; n++) t[n - 1] = arguments[n];
+	l.push(new h(e, t)), l.length === 1 && !u && s(m);
+};
+function h(e, t) {
+	this.fun = e, this.array = t;
+}
+h.prototype.run = function() {
+	this.fun.apply(null, this.array);
+}, n.title = "browser", n.browser = !0, n.env = {}, n.argv = [], n.version = "", n.versions = {};
+function g() {}
+n.on = g, n.addListener = g, n.once = g, n.off = g, n.removeListener = g, n.removeAllListeners = g, n.emit = g, n.prependListener = g, n.prependOnceListener = g, n.listeners = function(e) {
+	return [];
+}, n.binding = function(e) {
+	throw Error("process.binding is not supported");
+}, n.cwd = function() {
+	return "/";
+}, n.chdir = function(e) {
+	throw Error("process.chdir is not supported");
+}, n.umask = function() {
+	return 0;
+};
+var _ = t.exports, v = /* @__PURE__ */ e(_);
+//#endregion
+export { v as t };

package/dist/omezarr-tilesource.d.ts

@@ -1,5 +1,6 @@
 import { Channel } from 'ome-zarr.js';
 import { default as default_2 } from 'openseadragon';
+import { NgffImage } from 'ome-zarr.js';
 import * as zarr from 'zarrita';
 
 export declare interface OMEZarrTileData {
@@ -20,8 +21,13 @@ export declare class OMEZarrTileSource extends default_2.TileSource {
     height: number;
     private _image?;
     private _arrays?;
-    constructor(url: string);
-    constructor(options: OMEZarrTileSourceOptions);
+    private readonly _readyPromise;
+    static open(config: string | OMEZarrTileSourceOptions, image?: NgffImage): Promise<OMEZarrTileSource>;
+    constructor(url: string, image?: NgffImage);
+    constructor(options: OMEZarrTileSourceOptions, image?: NgffImage);
+    get image(): NgffImage;
+    get arrays(): zarr.Array<zarr.NumberDataType | zarr.BigintDataType>[];
+    whenReady(): Promise<this>;
     supports(data: string | object | object[] | Document): boolean;
     configure(data: string | object | object[] | Document, _url: string, postData?: string | null): OMEZarrTileSourceOptions;
     equals(other: default_2.TileSource): boolean;
@@ -37,6 +43,7 @@ export declare class OMEZarrTileSource extends default_2.TileSource {
     private static _learnConverters;
     private _getActiveChannelIndices;
     private static _render;
+    private static _getDataTypeRange;
 }
 
 export declare interface OMEZarrTileSourceOptions {