fo-dicom.Codecs 5.14.1

fo-dicom.Codecs

<img src="fo-dicom_logo.png" alt="fo-dicom logo" height="80" /><img src="efferent_logo.png" alt="Efferent logo" height="80" />

This is collaborative project mantained by Fellow Oak Dicom and Efferent Health, LLC. The codecs in this repository are written in pure C/C++ code and wrapped with C# and netstandard2.0. The supported platforms so far are:

• Windows 64-bit, Intel architecture (tested with Windows 10/11)
• Linux 64-bit, Intel and ARM architectures (tested with Ubuntu 18/20/22 Desktop and Server)
• MacOS 64-bit, Intel and Apple architectures (tested with Ventura/Sonoma)

Supported CODECs

The following CODECS are implemented:

The HT-JPEG2000 family of codecs is only supported since fo-dicom version 5.1.3

Usage

• Add the standard fo-dicom nuget packages to your project

With fo-dicom 4.x

• Add the nuget package to your .NET Standard or .NET Core project (minimum version is 2.0)
• Add the standard fo-dicom nuget packages to your project (version 4.x)
• At the beginning of your application, replace the transcoder manager, as:

  Dicom.Imaging.Codec.TranscoderManager.SetImplementation(new Dicom.Imaging.NativeCodec.NativeTranscoderManager());
  

With fo-dicom 5.x

• Add the nuget package to your .NET Standard or .NET project (minimum version is .NET 5.0)
• Add the standard fo-dicom nuget packages to your project (version 5.x)
• At the beginning of your application, replace the transcoder manager, as:

  new DicomSetupBuilder()
    .RegisterServices(s => s.AddFellowOakDicom().AddTranscoderManager<FellowOakDicom.Imaging.NativeCodec.NativeTranscoderManager>())
    .SkipValidation()
    .Build();
  

Dependencies

Windows

It is required to have Visual C++ Redistributable v14 installed in the target Windows machine. Otherwise, it will throw a runtime error:

Unable to load DLL 'Dicom.Native': The specified module could not be found. (Exception from HRESULT: 0x8007007E)

The installer can be downloaded directly from https://aka.ms/vs/17/release/vc_redist.x64.exe

Linux

The native library has been built on an Ubuntu 20.04 environment using GNU C Compiler version 9.4.x.

Therefore, it requires a GLIBC library runtime version 2.27 and GLIBCXX version 3.4. Otherwise, it can throw a runtime error like:

Unhandled Exception: System.DllNotFoundException: Unable to load shared library 'Dicom.Native.so' or one of its dependencies.