Add Open Resolution Level command and Pyramidal dataset lifecycle management

[stefanhahmann]

Replaces PR #80

Resolves Issue #41
Resolves Issue #79
Resolves Issue #14

Summary

• Adds OpenResolutionLevelCommand (menu: Plugins > OME-Zarr > Open Resolution Level…) to open a specific resolution level of an OME-Zarr multi-resolution dataset as a new ImageJ dataset
• Adds per-level dataset access (asPyramidalDataset(int)) and NonExistingResolutionLevelException in the pyramid API
• Introduces the Pyramidal interface (implemented by PyramidalDataset and PyramidalBdvDataset)
• Replaces BdvHandleService with PyramidalService, which tracks the most recently focused Pyramidal window (BDV or IJ)
• PyramidalPreprocessor auto-resolves @Parameter Pyramidal command inputs from the active window
• OpenInBDVCommand creates a distinct PyramidalBdvDataset for each BDV opened, sharing the same underlying Pyramidal5DImageData (pixel data loaded only once)
• Stores axis calibration per resolution level in PyramidContents / AxisCalibration; physical extent (pixels × scale) is verified to be identical across all resolution levels
• Selecting resolution level via the menu is not yet part of this PR to not make it too big.
• Showing dimensions (XYZCT) during the resolution level selection is also not yet part of this PR to not make it too big.

Test plan

• Run mvn test — all existing and new tests pass

Open in IJ → Open Resolution Level

• Drag-and-drop an OME-Zarr onto Fiji → opens as IJ2 dataset (1 dataset in DatasetService, 1 pyramidal in PyramidalService)
• Run Plugins > OME-Zarr > Open Resolution Level… with the IJ2 dataset active → dialog shows resolution choices, selecting a level opens a new IJ2 window (2 datasets total); both share the same pyramid data

Open in BDV → Open Resolution Level

• Drag-and-drop an OME-Zarr onto Fiji → open in BDV (0 dataset in DatasetService, 1 pyramidal in PyramidalService)
• With the BDV window focused, run Open Resolution Level… without an active IJ2 display → command falls back to the focused BDV dataset, opens the selected level as a new IJ2 window (2 pyramidals in total, 1 dataset)

Open in IJ → Open in BDV

• Drag-and-drop → opens as IJ2 dataset (1 dataset)
• Run Plugins > OME-Zarr > Open in BDV with the IJ2 dataset active → BDV window opens (2 pyramidals in total, 1 dataset); BDV is a distinct PyramidalBdv sharing the same underlying pyramid data as the IJ2 dataset

Open in BDV → Open in BDV again

• Drag-and-drop → open in BDV (1 pyramidal)
• With BDV window focused, run Open in BDV again (no active IJ2 display) → command falls back to focused BDV dataset, a second BDV window opens (2 pyramidals, 0 datasets in total); both BDV share the same underlying pyramid data

Open dataset A in IJ → Open dataset B in BDV → Open resolution level

• Drag-and-drop → open in IJ (1 pyramidal, 1 dataset)
• Drag-and-drop → open in BDV (2 pyramidals, 1 dataset)
• With BDV window active run Open Resolution Level, select resolution level 1; The resolution level 1 of the dataset open in the BDV window should be shown.

Error cases

• Run Open Resolution Level… or Open in BDV with no image open → command cancels with a "No image is currently open" message dialog
• Close the BDV window, then run Open in BDV → same cancellation message

Jython Macro for testing

#@ DatasetService ds
#@ PyramidalService ps

print("----")
for dimg in ds.getDatasets():
	print("image '"+dimg.getImgPlus().getName()+"' (id: "+str(id(dimg))+\
	") of width x height: "+str(dimg.getWidth())+'x'+str(dimg.getHeight()))
for pyramidal in ps.getPyramidals():
	print("pyramidal '"+pyramidal.getPyramidName()+"' (id: "+str(id(pyramidal))+")")
print("----")

[sonarqubecloud]

Quality Gate passed

Issues
11 New issues
0 Accepted issues

Measures
0 Security Hotspots
85.5% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud