Migrating from Previous Versions

ImageGear for .NET, up to version 16.x, used a single assembly for all its features. Starting with version 17, all ImageGear for .NET functionality is split into smaller assemblies. The application can use a subset of assemblies, according to its needs.

Perform the following steps to port an application from a single-assembly to a multi-assembly version of ImageGear:

Replace the reference to the old ImageGear assembly with references to ImageGear assemblies that the application needs to use.
Add initialization for components that require it. See Assembly Initialization for the list of components that require initialization.

If the application uses file formats metadata API, DICOM Display Settings, or annotations, add casting to classes that expose actual functionality. See Resolving Assembly Cross-Dependencies for details.

A number of methods that belonged to ImGearRasterProcessing Class have been moved to the new ImGearEffects Class. Corresponding methods from ImGearRasterProcessingVerifier Class have been moved to the new ImGearEffectsVerifier Class. See the new ImGearEffects Class for the methods that have been moved to this class.

The following table lists the mapping between ImageGear v16 and v19 assemblies. Note, however, that you do not have to use all of the assemblies. You only need to use assemblies that provide the desired functionality, and the assemblies upon which they depend. ImageGear for .NET Assemblies provides assembly dependency information. ImageGear for .NET Assemblies provides assembly dependency information.

ImageGear v16 Assemblies	ImageGear v19 Assemblies
ImageGearV16n.dll	ImageGear21.Art.dll ImageGear21.Core.dll ImageGear21.Formats.Advanced.dll ImageGear21.Formats.CameraRaw.dll ImageGear21.Formats.Common.dll ImageGear21.Formats.Dicom.dll ImageGear21.Formats.Jpeg2k.dll ImageGear21.Formats.Pdf.dll ImageGear21.Formats.SimplifiedMetadata.dll ImageGear21.Formats.Vector.dll ImageGear21.Presentation.dll (FW 3.0) ImageGear21.Processing.Advanced.dll ImageGear21.Twain.dll
IGWinFormsV16n.dll	ImageGear21.Art.Forms.dll ImageGear21.Windows.Forms.dll
IGWpfV16n.dll	ImageGear21.Wpf.dll
IGWebFormsV16n.dll	ImageGear21.Web.dll