@niivue/niivue 0.44.2-dev.1 → 0.45.0

package/build/index.d.ts

@@ -598,8 +598,7 @@ declare enum DRAG_MODE {
     measurement = 2,
     pan = 3,
     slicer3D = 4,
-    callbackOnly = 5,
-    roiSelection = 6
+    callbackOnly = 5
 }
 /**
  * NVConfigOptions
@@ -669,17 +668,10 @@ type NVConfigOptions = {
     renderOverlayBlend: number;
     sliceMosaicString: string;
     centerMosaic: boolean;
-    penSize: number;
     clickToSegment: boolean;
     clickToSegmentRadius: number;
+    clickToSegmentSteps: number;
     clickToSegmentBright: boolean;
-    clickToSegmentAutoIntensity: boolean;
-    clickToSegmentIntensityMax: number;
-    clickToSegmentIntensityMin: number;
-    clickToSegmentPercent: number;
-    clickToSegmentMaxDistanceMM: number;
-    selectionBoxLineThickness: number;
-    selectionBoxIsOutline: boolean;
 };
 declare const DEFAULT_OPTIONS: NVConfigOptions;
 type SceneData = {
@@ -984,18 +976,6 @@ type NiiVueLocation = {
     vox: vec3;
     xy: [number, number];
 };
-type SyncOpts = {
-    '3d'?: boolean;
-    '2d'?: boolean;
-    zoomPan?: boolean;
-    cal_min?: boolean;
-    cal_max?: boolean;
-    gamma?: boolean;
-    useSliceOffset?: boolean;
-    sliceType?: boolean;
-    crosshair?: boolean;
-    clipPlane?: boolean;
-};
 
 type ValuesArray = Array<{
     id: string;
@@ -1632,7 +1612,6 @@ type Descriptive = {
     cal_max: number;
     robust_min: number;
     robust_max: number;
-    area: number | null;
 };
 type SliceScale = {
     volScale: number[];
@@ -1691,6 +1670,7 @@ type SaveImageOptions = {
  * let niivue = new Niivue({crosshairColor: [0,1,0,0.5], textHeight: 0.5}) // a see-through green crosshair, and larger text labels
  */
 declare class Niivue {
+    loaders: {};
     canvas: HTMLCanvasElement | null;
     _gl: WebGL2RenderingContext | null;
     isBusy: boolean;
@@ -1717,7 +1697,6 @@ declare class Niivue {
     orientCubeShader?: Shader;
     orientCubeShaderVAO: WebGLVertexArrayObject | null;
     rectShader?: Shader;
-    rectOutlineShader?: Shader;
     renderShader?: Shader;
     lineShader?: Shader;
     line3DShader?: Shader;
@@ -1762,7 +1741,7 @@ declare class Niivue {
     extentsMin?: vec3;
     extentsMax?: vec3;
     private resizeObserver;
-    syncOpts: SyncOpts;
+    syncOpts: Record<string, unknown>;
     readyForSync: boolean;
     uiData: UIData;
     back: NVImage | null;
@@ -1783,7 +1762,7 @@ declare class Niivue {
         screen2frac?: number[];
     }>;
     cuboidVertexBuffer?: WebGLBuffer;
-    otherNV: Niivue[] | null;
+    otherNV: Niivue | Niivue[] | null;
     volumeObject3D: NiivueObject3D | null;
     pivot3D: number[];
     furthestFromPivot: number;
@@ -2038,7 +2017,7 @@ declare class Niivue {
      * @deprecated use broadcastTo instead
      * @see {@link https://niivue.github.io/niivue/features/sync.mesh.html | live demo usage}
      */
-    syncWith(otherNV: Niivue | Niivue[], syncOpts?: {
+    syncWith(otherNV: Niivue, syncOpts?: {
         '2d': boolean;
         '3d': boolean;
     }): void;
@@ -2057,15 +2036,6 @@ declare class Niivue {
         '2d': boolean;
         '3d': boolean;
     }): void;
-    doSync3d(otherNV: Niivue): void;
-    doSync2d(otherNV: Niivue): void;
-    doSyncGamma(otherNV: Niivue): void;
-    doSyncZoomPan(otherNV: Niivue): void;
-    doSyncCrosshair(otherNV: Niivue): void;
-    doSyncCalMin(otherNV: Niivue): void;
-    doSyncCalMax(otherNV: Niivue): void;
-    doSyncSliceType(otherNV: Niivue): void;
-    doSyncClipPlane(otherNV: Niivue): void;
     /**
      * Sync the scene controls (orientation, crosshair location, etc.) from one Niivue instance to another. useful for using one canvas to drive another.
      * @internal
@@ -2169,6 +2139,7 @@ declare class Niivue {
      * @param file - File object
      */
     loadFromFile(file: File): Promise<void>;
+    useLoader(loader: unknown, fileExt: string, toExt: string): void;
     dropListener(e: DragEvent): void;
     /**
      * insert a gap between slices of a mutliplanar view.
@@ -2648,6 +2619,7 @@ declare class Niivue {
      * @see {@link https://niivue.github.io/niivue/features/document.3d.html | live demo usage}
      */
     saveDocument(fileName?: string, compress?: boolean): Promise<void>;
+    loadImages(images: Array<ImageFromUrlOptions | LoadFromUrlParams>): Promise<this>;
     /**
      * load an array of volume objects
      * @param volumeList - the array of objects to load. each object must have a resolvable "url" property at a minimum
@@ -2726,17 +2698,9 @@ declare class Niivue {
     drawGrowCut(): void;
     drawPt(x: number, y: number, z: number, penValue: number): void;
     drawPenLine(ptA: number[], ptB: number[], penValue: number): void;
-    /**
-     * Performs a 1-voxel binary dilation on a connected cluster within the drawing mask using the drawFloodFillCore function.
-     *
-     * @param seedXYZ -  voxel index of the seed voxel in the mask array.
-     * @param neighbors - Number of neighbors to consider for connectivity and dilation (6, 18, or 26).
-     */
-    drawingBinaryDilationWithSeed(seedXYZ: number[], // seed voxel x,y,z
-    neighbors?: 6 | 18 | 26): void;
     drawFloodFillCore(img: Uint8Array, seedVx: number, neighbors?: number): void;
     drawFloodFill(seedXYZ: number[], newColor?: number, growSelectedCluster?: number, // if non-zero, growth based on background intensity POSITIVE_INFINITY for selected or bright, NEGATIVE_INFINITY for selected or darker
-    forceMin?: number, forceMax?: number, neighbors?: number, maxDistanceMM?: number): void;
+    forceMin?: number, forceMax?: number, neighbors?: number): void;
     drawPenFilled(): void;
     /**
      * close drawing: make sure you have saved any changes before calling this!
@@ -2865,33 +2829,13 @@ declare class Niivue {
     updateGLVolume(): void;
     /**
      * basic statistics for selected voxel-based image
-     * @param options - an object containing the following properties:
-     *   - layer: selects image to describe
-     *   - masks: optional binary images to filter voxels
-     *   - drawingIsMask: a boolean indicating if the drawing is used as a mask
-     *   - roiIsMask: a boolean indicating if the ROI is used as a mask
-     *   - startVox: the starting voxel coordinates
-     *   - endVox: the ending voxel coordinates
-     * @returns numeric values to describe image or regions of images
-     * @example
-     * niivue.getDescriptives({
-     *   layer: 0,
-     *   masks: [],
-     *   drawingIsMask: true, // drawingIsMask and roiIsMask are mutually exclusive
-     *   roiIsMask: false,
-     *   startVox: [10, 20, 30], // ignored if roiIsMask is false
-     *   endVox: [40, 50, 60] // ignored if roiIsMask is false
-     * });
+     * @param layer - selects image to describe
+     * @param masks - are optional binary images to filter voxles
+     * @returns numeric values to describe image
+     * @example niivue.getDescriptives(0);
      * @see {@link https://niivue.github.io/niivue/features/draw2.html | live demo usage}
      */
-    getDescriptives(options: {
-        layer?: number;
-        masks?: number[];
-        drawingIsMask?: boolean;
-        roiIsMask?: boolean;
-        startVox?: number[];
-        endVox?: number[];
-    }): Descriptive;
+    getDescriptives(layer?: number, masks?: any[], drawingIsMask?: boolean): Descriptive;
     refreshLayers(overlayItem: NVImage, layer: number): void;
     /**
      * query all available color maps that can be applied to volumes
@@ -3123,4 +3067,4 @@ declare class Niivue {
     set gl(gl: WebGL2RenderingContext | null);
 }
 
-export { type Connectome, type ConnectomeOptions, DEFAULT_OPTIONS, DRAG_MODE, type DocumentData, type DragReleaseParams, type ExportDocumentData, INITIAL_SCENE_DATA, LabelAnchorPoint, LabelLineTerminator, LabelTextAlignment, type LegacyConnectome, type LegacyNodes, MULTIPLANAR_TYPE, type NVConfigOptions, type NVConnectomeEdge, type NVConnectomeNode, NVController, NVDocument, NVImage, NVImageFromUrlOptions, NVLabel3D, NVLabel3DStyle, NVMesh, NVMeshFromUrlOptions, NVMeshLayerDefaults, NVMeshLoaders, NVMeshUtilities, NVUtilities, type NiftiHeader, type NiiVueLocation, type NiiVueLocationValue, Niivue, type Point, SHOW_RENDER, SLICE_TYPE, type Scene, type SyncOpts, type Volume, cmapper, ColorTables as colortables };
+export { type Connectome, type ConnectomeOptions, DEFAULT_OPTIONS, DRAG_MODE, type DocumentData, type DragReleaseParams, type ExportDocumentData, INITIAL_SCENE_DATA, LabelAnchorPoint, LabelLineTerminator, LabelTextAlignment, type LegacyConnectome, type LegacyNodes, MULTIPLANAR_TYPE, type NVConfigOptions, type NVConnectomeEdge, type NVConnectomeNode, NVController, NVDocument, NVImage, NVImageFromUrlOptions, NVLabel3D, NVLabel3DStyle, NVMesh, NVMeshFromUrlOptions, NVMeshLayerDefaults, NVMeshLoaders, NVMeshUtilities, NVUtilities, type NiftiHeader, type NiiVueLocation, type NiiVueLocationValue, Niivue, type Point, SHOW_RENDER, SLICE_TYPE, type Scene, type Volume, cmapper, ColorTables as colortables };