Pending changes in the mainline
===============================

=> Recommended SDK version: 1.12.9 <=
=> Minimum SDK version: 1.7.0 <=

* Support for annotations
* Persistence of annotations in the Orthanc database (SDK 1.12.8 is required)
* Per-user annotations if the "orthanc-education" plugin is installed

Maintenance
-----------

* OrthancWSIDicomizer:
  - Now adding a FrameOfReferenceUID DICOM tag.  This is required, amongst others, 
    by the measurement tools in the OHIF microscopy viewer.
* Viewer plugin:
  - Added CMake option "ORTHANC_SDK_VERSION"


Version 3.3 (2025-11-06)
========================

* OrthancWSIDicomizer:
  - New option "--encoding" to specify the specific character set of DICOM instances
  - Placeholder tags are now automatically inserted when the "--dataset" option
    provides incomplete data, ensuring the generated DICOM instances remain valid
  - The version of the DICOM-izer is available in DICOM tag "SoftwareVersions"
  - ImagedVolumeWidth and ImagedVolumeHeight are swapped with respect to releases <= 3.2:
    https://discourse.orthanc-server.org/t/5912
* Viewer plugin:
  - Added rotation button in the viewer
  - The viewer displays a label if the "description" GET parameter is provided
  - Upgraded to OpenLayers 10.6.1


Version 3.2 (2025-04-08)
========================

* Support windowing when rendering grayscale images using on-the-fly deep zoom
* Added tolerance to imaged volume width/height by looking only at the finest level
* Added support for more transfer syntaxes in the Web viewer plugin, including JPEG-LS
* Added support for JPEG-LS in OrthancWSIDicomizer with argument "--compression=jpeg-ls"
* Fix photometric interpretation of JPEG2000 images generated by OrthancWSIDicomizer
  (now set to RGB instead of YBR_FULL_422)


Version 3.1 (2025-03-17)
========================

* Upgraded to OpenLayers 10.4.0 (was previously 3.19.0)
* The viewer now displays the scale if imaged volume size is available in DICOM
* Fix handling of "Image Type" in the viewer for compatibility with other vendors
* OrthancWSIDicomizer does not fill anymore the imaged volume width/height
  tags if no information is available
* OrthancWSIDicomizer detects imaged volume size for Aperio files without OpenSlide

Compatibility notes about the viewer
------------------------------------

* Compatibility tested against sample DICOM images shipped by OpenSlide:
  3DHISTECH-1.zip, CMU-1-JP2K-33005.zip, JP2K-33003-1.zip, and Leica-4.zip:
  https://openslide.cs.cmu.edu/download/openslide-testdata/DICOM/

* Compatibility tested against the images of the 2023 DICOM WG26 Connectathon
  from vendors: Hamamatsu, Leica, Objective Imaging, Philips, and Roche
  ftp://medical.nema.org/medical/dicom/Datasets/WG26/


Version 3.0 (2024-12-20)
========================

=> Minimum SDK version: 1.7.0 <=

* On-the-fly creation of pyramids from frames of DICOM instances ("deep zoom" button)


Version 2.1 (2024-10-18)
========================

* Support of sparse encoding of tiles in OpenSlide (notably for MIRAX format)
* OrthancWSIDicomizer supports plain TIFF, besides hierarchical TIFF
* New option: "--force-openslide" to force the use of OpenSlide on TIFF-like files
* New option: "--padding" to control deep zoom of plain PNG/JPEG/TIFF images over IIIF
* Added support for DICOM tag "Recommended Absent Pixel CIELab" (0048,0015)
* Force version of Mirador to 3.3.0
* In the IIIF manifest, reverse the order of the "sizes" field, which
  seems to fix compatibility with Mirador v4.0.0-alpha


Version 2.0 (2023-10-07)
========================

* Support of IIIF
* Automated extraction of the imaged volume if using OpenSlide
* URI "/wsi/tiles/{id}/{z}/{x}/{y}" supports the "Accept" HTTP header
  to force JPEG, JPEG2k, or PNG in the decoded tiles
* Force version of OpenSeadragon to 4.0.0


Version 1.1 (2021-12-11)
========================

* OrthancWSIDicomizer: Support importing of images from Cytomine


Version 1.0 (2021-01-14)
========================

* Viewer can display DICOM pyramids whose tile sizes vary across levels
* Allow images without "Per frame functional groups sequence" tag (0x5200,0x9230)
* Better handling of PhotometricInterpretation in viewer
* Fix colorspace of TIFF containing JPEG with RGB photometric interpretation (not YCbCr)
* Don't display the thumbnail/overview instances in the Web viewer
* Fix issue #145 (support of Concatenation UID)
* Support of dynamic linking against the system-wide Orthanc framework library
* Upgraded dependencies for static builds (notably on Windows):
  - libtiff, from 4.0.6 to 4.2.0
  - openjpeg, from 2.1 to 2.4.0


Version 0.7 (2020-05-26)
========================

* Improved consistency when transcoding/re-encoding is applied
* Support of grayscale images
* Fix issue #139 (OrthancWSIDicomizer PixelSpacing)
* Fix issue #144 (OrthancWSIDicomizer PhotometricInterpretation)
* Fix issue #163 (Failure to recognize MIRAX / 3DHISTECH images)
* Upgrade to Orthanc framework 1.7.0


Version 0.6 (2019-01-26)
========================

* Fix compatibility with the Orthanc 1.5.2 framework


Version 0.5 (2018-04-23)
========================

* "--max-size=0" allowed to create a single instance per pyramid level
* Support more colorspaces with JPEG2k
* SSL is enabled by default for HTTPS transfers
* Fix Debian #876807 (orthanc-wsi FTBFS with libopenjp2-7-dev 2.2.0-1)
* Resort to Orthanc framework
* Support of OpenBSD and FreeBSD
* Support of Linux Standard Base


Version 0.4 (2017-03-01)
========================

* Fix issue #30 (Bad colorspace if using OpenSlide)


Version 0.3 (2016-12-23)
========================

* Thanks to David Clunie's feedback:
  - Fix generation of tag "Dimension Index Sequence" (0020,9222)
  - Fix generation of tag "Dimension Index Values" (0020,9157)
* Improved logging in the viewer plugin
* Display version of the framework in the logs


Version 0.2 (2016-11-28)
========================

* Huge speed-up in the whole-slide imaging Web viewer plugin:
  - Reduction of the number of calls to the Orthanc REST API
  - Cache pre-computed information for each instance as metadata
  - Larger cache with LRU recycling to improve viewer performance
* "OrthancWSIClearCache.py" companion script to clear the WSI cache
* Various refactorings


Version 0.1 (2016-10-28)
========================

* Docker images are available
* Provide "--version" flag in command-line tools
* Fix freeze if the target Orthanc is not accepting images

Maintenance
-----------

* Windows resources for command-line tools
* Build under Apple OS X
* Build using Microsoft Visual Studio
* Automatic build in CIS


2016-10-22
==========

* Initial release
