@idetik/core 0.32.7 → 0.34.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as gl_matrix from 'gl-matrix';
-import { vec2, mat4, vec3, quat, vec4 } from 'gl-matrix';
+import { vec2, mat4, vec3, vec4, quat } from 'gl-matrix';
 import * as zarr from 'zarrita';
 import { Location, Readable } from 'zarrita';
 import { z } from 'zod';
@@ -37,6 +37,14 @@ declare abstract class Texture extends Node {
     get type(): string;
 }
 
+type SpatialAxis = "x" | "y" | "z";
+type SliceAxes = {
+    u: SpatialAxis;
+    v: SpatialAxis;
+    w: SpatialAxis;
+};
+type SliceOrientation = "XY" | "XZ" | "YZ";
+
 declare const chunkDataTypes: readonly [Int8ArrayConstructor, Int16ArrayConstructor, Int32ArrayConstructor, Uint8ArrayConstructor, Uint16ArrayConstructor, Uint32ArrayConstructor, Float32ArrayConstructor];
 type ChunkDataConstructor = (typeof chunkDataTypes)[number];
 type ChunkData = InstanceType<ChunkDataConstructor>;
@@ -169,7 +177,7 @@ declare class ChunkStore {
     get channelCount(): number;
     get dimensions(): SourceDimensionMap;
     getLowestResLOD(): number;
-    addView(policy: ImageSourcePolicy): ChunkStoreView;
+    addView(policy: ImageSourcePolicy, axes?: SliceAxes): ChunkStoreView;
     get views(): ReadonlyArray<ChunkStoreView>;
     canDispose(): boolean;
     updateAndCollectChunkChanges(): Set<Chunk>;
@@ -218,11 +226,12 @@ declare class ChunkStoreView {
     private readonly sourceMaxSquareDistance2D_;
     private readonly chunkViewStates_;
     private isDisposed_;
-    constructor(store: ChunkStore, policy: ImageSourcePolicy);
+    constructor(store: ChunkStore, policy: ImageSourcePolicy, axes?: SliceAxes);
     get chunkViewStates(): ReadonlyMap<Chunk, ChunkViewState>;
     get isDisposed(): boolean;
     get lodCount(): number;
     get channelCount(): number;
+    getWholePlaneRect(): Box2;
     getChunksToRender(): Chunk[];
     updateChunksForImage(sliceCoords: SliceCoordinates, view: {
         worldViewRect: Box2;
@@ -276,7 +285,7 @@ declare class ChunkManager {
         cpuChunkBytes: number;
         cpuChunkCount: number;
     };
-    addView(source: ChunkSource, policy: ImageSourcePolicy): ChunkStoreView;
+    addView(source: ChunkSource, policy: ImageSourcePolicy, axes?: SliceAxes): ChunkStoreView;
     update(): void;
     private releaseChunk;
     private enqueueWithinBudget;
@@ -287,6 +296,34 @@ declare class ChunkManager {
     private disposeChunkTexture;
 }
 
+/** @group Layer Configuration */
+type ColorLike = Color | vec3 | vec4 | string;
+/** @group Layer Configuration */
+declare class Color {
+    static readonly RED: Color;
+    static readonly GREEN: Color;
+    static readonly BLUE: Color;
+    static readonly YELLOW: Color;
+    static readonly MAGENTA: Color;
+    static readonly CYAN: Color;
+    static readonly BLACK: Color;
+    static readonly WHITE: Color;
+    static readonly TRANSPARENT: Color;
+    private readonly rgba_;
+    constructor(r: number, g: number, b: number, a?: number);
+    get rgb(): [number, number, number];
+    get rgba(): readonly [number, number, number, number];
+    get r(): number;
+    get g(): number;
+    get b(): number;
+    get a(): number;
+    get rgbHex(): string;
+    get packed(): number;
+    static from(colorLike: ColorLike): Color;
+    static fromRgbHex(hex: string): Color;
+    private toHexComponent;
+}
+
 declare class Box3 {
     min: vec3;
     max: vec3;
@@ -358,34 +395,6 @@ declare class TrsTransform {
 
 type Shader = "floatScalarImage" | "floatVolume" | "intLabelImage" | "intScalarImage" | "intVolume" | "labelImage" | "points" | "projectedLine" | "uintScalarImage" | "uintVolume" | "wireframe";
 
-/** @group Layer Configuration */
-type ColorLike = Color | vec3 | vec4 | string;
-/** @group Layer Configuration */
-declare class Color {
-    static readonly RED: Color;
-    static readonly GREEN: Color;
-    static readonly BLUE: Color;
-    static readonly YELLOW: Color;
-    static readonly MAGENTA: Color;
-    static readonly CYAN: Color;
-    static readonly BLACK: Color;
-    static readonly WHITE: Color;
-    static readonly TRANSPARENT: Color;
-    private readonly rgba_;
-    constructor(r: number, g: number, b: number, a?: number);
-    get rgb(): [number, number, number];
-    get rgba(): readonly [number, number, number, number];
-    get r(): number;
-    get g(): number;
-    get b(): number;
-    get a(): number;
-    get rgbHex(): string;
-    get packed(): number;
-    static from(colorLike: ColorLike): Color;
-    static fromRgbHex(hex: string): Color;
-    private toHexComponent;
-}
-
 type CullingMode = "none" | "front" | "back" | "both";
 
 declare abstract class RenderableObject extends Node {
@@ -490,6 +499,11 @@ declare class EventDispatcher {
     private readonly handleEvent;
 }
 
+type OrthographicCameraOptions = {
+    near?: number;
+    far?: number;
+    orientation?: SliceOrientation;
+};
 /**
  * A camera using an orthographic (parallel) projection.
  *
@@ -508,6 +522,8 @@ declare class OrthographicCamera extends Camera {
     private height_;
     private viewportAspectRatio_;
     private viewportSize_;
+    private readonly axes_;
+    private readonly rotation_;
     /**
      * Creates an orthographic camera framing the given world-space rectangle.
      *
@@ -515,10 +531,10 @@ declare class OrthographicCamera extends Camera {
      * @param right - Right edge of the view frame, in world units.
      * @param top - Top edge of the view frame, in world units.
      * @param bottom - Bottom edge of the view frame, in world units.
-     * @param near - Near clipping plane distance. Defaults to `-1e6`.
-     * @param far - Far clipping plane distance. Defaults to `1e6`.
+     * @param options - Near/far clipping plane distances (default `-1e6` and
+     *   `1e6`) and the slice orientation the camera faces (default `"XY"`).
      */
-    constructor(left: number, right: number, top: number, bottom: number, near?: number, far?: number);
+    constructor(left: number, right: number, top: number, bottom: number, options?: OrthographicCameraOptions);
     get viewportSize(): [number, number];
     setAspectRatio(aspectRatio: number): void;
     setFrame(left: number, right: number, bottom: number, top: number): void;
@@ -683,6 +699,7 @@ type IdetikParams = {
     memoryLimitMB?: number;
     maxConcurrentRequests?: number;
     maxGpuUploadsPerUpdate?: number;
+    backgroundColor?: ColorLike;
 };
 type IdetikContext = {
     chunkManager: ChunkManager;
@@ -1481,6 +1498,7 @@ type ImageLayerProps = LayerOptions & {
     source: ChunkSource;
     sliceCoords: SliceCoordinates;
     policy: ImageSourcePolicy;
+    orientation?: SliceOrientation;
     channelProps?: ChannelProps[];
     onPickValue?: (info: PointPickingResult) => void;
 };
@@ -1503,6 +1521,7 @@ declare class ImageLayer extends Layer implements ChannelsEnabled {
     private readonly source_;
     private readonly sliceCoords_;
     private readonly axes_;
+    private readonly planeRotation_;
     private readonly onPickValue_?;
     private readonly visibleChunks_;
     private readonly pool_;
@@ -1517,7 +1536,7 @@ declare class ImageLayer extends Layer implements ChannelsEnabled {
     private lastPresentationTimeStamp_?;
     private lastPresentationTimeCoord_?;
     private readonly wireframeColors_;
-    constructor({ source, sliceCoords, policy, channelProps, onPickValue, ...layerOptions }: ImageLayerProps);
+    constructor({ source, sliceCoords, policy, orientation, channelProps, onPickValue, ...layerOptions }: ImageLayerProps);
     protected attach(context: IdetikContext): void;
     protected detach(_context: IdetikContext): void;
     update(viewport?: Viewport): void;
@@ -1610,6 +1629,7 @@ type LabelLayerProps = LayerOptions & {
     source: ChunkSource;
     sliceCoords: SliceCoordinates;
     policy: ImageSourcePolicy;
+    orientation?: SliceOrientation;
     colorMap?: LabelColorMapProps;
     onPickValue?: (info: PointPickingResult) => void;
     outlineSelected?: boolean;
@@ -1620,6 +1640,7 @@ declare class LabelLayer extends Layer {
     private readonly source_;
     private readonly sliceCoords_;
     private readonly axes_;
+    private readonly planeRotation_;
     private readonly onPickValue_?;
     private readonly outlineSelected_;
     private readonly visibleChunks_;
@@ -1632,7 +1653,7 @@ declare class LabelLayer extends Layer {
     private static readonly STALE_PRESENTATION_MS_;
     private lastPresentationTimeStamp_?;
     private lastPresentationTimeCoord_?;
-    constructor({ source, sliceCoords, policy, colorMap, onPickValue, outlineSelected, ...layerOptions }: LabelLayerProps);
+    constructor({ source, sliceCoords, policy, orientation, colorMap, onPickValue, outlineSelected, ...layerOptions }: LabelLayerProps);
     protected attach(context: IdetikContext): void;
     protected detach(_context: IdetikContext): void;
     update(viewport?: Viewport): void;
@@ -2030,4 +2051,4 @@ type Image = z.infer<typeof Image>;
 type OmeZarrImage = Image;
 
 export { AxesLayer, Color, Idetik, ImageLayer, ImageRenderable, LabelColorMap, LabelImageRenderable, LabelLayer, Layer, OmeZarrImageSource, OrbitControls, OrthographicCamera, PanZoomControls, PerspectiveCamera, Points, ProjectedLine, VolumeLayer, VolumeRenderable, createExplorationPolicy, createImageSourcePolicy, createNoPrefetchPolicy, createPlaybackPolicy, loadOmeZarrPlate, loadOmeZarrWell, loadOmeroChannels, loadOmeroDefaults };
-export type { ChannelProps, ColorLike, LayerState, MemoryStats, OmeZarrImage, Overlay, SliceCoordinates };
+export type { ChannelProps, ColorLike, LayerState, MemoryStats, OmeZarrImage, Overlay, SliceCoordinates, SliceOrientation };