Declaration

TIEMiscPluginsImageMagick = class;

Description

TIEMiscPluginsImageMagick is a wrapper around ImageMagick library allowing ImageEn to load and save many extra formats.

The plug-in adds support for: Scalable Vector Graphics (*.svg, *.svgz), High Efficiency Image Format (*.heic, *.heif, *.avif), WebP image (*.webp), JPEG XL Image (*.jxl), GIMP (*.xcf), TrueType Fonts (*.ttf, *.otf), Kodak Photo-CD (*.pcd, *.pcds), Apple Pict (*.pict), CALS Image (*.cals, *.cal), Flexible Image Transport System (*.fits), HP PCL Printer Image (*.pcl), Kodak Cineon (*.cin), Embrid Embroidery Format (*.pes), SMPTE (*.dpx), Magick (*.miff, *.mvg), Matlab (*.mat), JPEG Network Graphics (*.jng), Multiple-Image Network Graphics (*.mng), High Dynamic Range File (*.exr), MPEG (*.mp4, *.mpeg, *.mpg*.mov; *.m2v; *.m4v)
And if GhostScript is available: Adobe PDF (*.pdf, *.epdf), PostScript (*.ps, *.eps), Microsoft XML Page (*.xps)

Saving is NOT supported for these formats: *.heic, *.heif, *.avif, *.ttf, *.otf, *.pfa, *.pfb, *.ttc, *.dfont, *.pes, *.cals, *.cal, *.xcf



To enable the ImageMagick wrapper just call the RegisterPlugin class method once at application startup, or alternatively, RegisterPlugIns.

Note: All formats are rasterized.

You can either download the ImageMagick plug-in from:
www.imageen.com/download/

And unzip the files to your EXE folder (and ship them with your application).

Or ImageEn can automatically support the installed version of ImageMagick:
www.imagemagick.org/script/download.php#windows

In order to load PDF, PS, PCL and XPS you must install the Ghostscript library:
www.ghostscript.com/download/

Or download the portable version of GhostScript and add the files to your EXE folder (you may need a license to use GhostScript).

ImageMagick Options

You can use assign options to the Dict property to scale or size the loaded image:
* You can also specify import size of images using AutoScaleImport

And also to control saving behavior:

You can also create dictionary named 'ImageMagick' to add custom ImageMagick options:
- imagemagick.org/script/defines.php
- imagemagick.org/script/webp.php

// Save a PNG file as a lossless WebP with maximum compression
ImageEnView1.IO.SaveToFile('D:\Image.png');
ImageEnView1.IO.Params.Dict.Insert( 'ImageMagick', TIEDictionary.Create() );
ImageEnView1.IO.Params.Dict.GetDictionary('ImageMagick').Insert( 'webp:lossless', True );
ImageEnView1.IO.Params.Dict.GetDictionary('ImageMagick').Insert( 'webp:method', 6 );
ImageEnView1.IO.SaveToFile('D:\Image_out.webp');

Methods and Properties

Demos

Examples

// Register the ImageMagick plug-in
IEGlobalSettings().RegisterPlugIns([iepiImageMagick]);
if not ( iepiImageMagick in IEGlobalSettings().ActivePlugIns ) then
  ShowMessage( 'ImageMagick not found!' );

// Load an SVG at double size
ImageEnView1.IO.Params.Dict.Clear();
ImageEnView1.IO.Params.Dict.Insert( 'ImageMagick:Scale', 2 );
ImageEnView1.IO.LoadFromFile( 'D:\SVG\Lion.svg' );

// Load an SVG at size 2000x1000px
ImageEnView1.IO.Params.Dict.Clear();
ImageEnView1.IO.Params.Dict.Insert( 'ImageMagick:Width', 2000 );
ImageEnView1.IO.Params.Dict.Insert( 'ImageMagick:Height', 1000 );
ImageEnView1.IO.LoadFromFile( 'D:\SVG\Lion.svg' );

// Which is the same as...
ImageEnView1.IO.Params.AutoScaleImport := True;
ImageEnView1.IO.Params.LoadToWidth := 2000;
ImageEnView1.IO.Params.LoadToHeight := 1000;
ImageEnView1.IO.LoadFromFile( 'D:\SVG\Lion.svg' );

// Load an SVG at size 2000px wide. Auto-calculate height
ImageEnView1.IO.Params.Dict.Clear();
ImageEnView1.IO.Params.Dict.Insert( 'ImageMagick:Width', 2000 );
ImageEnView1.IO.Params.Dict.Insert( 'ImageMagick:Height', 0 );
ImageEnView1.IO.LoadFromFile( 'D:\SVG\Lion.svg' );

// Load an SVG at size 1000px high. Auto-calculate width
ImageEnView1.IO.Params.Dict.Clear();
ImageEnView1.IO.Params.Dict.Insert( 'ImageMagick:Width', 0 );
ImageEnView1.IO.Params.Dict.Insert( 'ImageMagick:Height', 1000 );
ImageEnView1.IO.LoadFromFile( 'D:\SVG\Lion.svg' );

// Load an SVG at size up to 2000x1000px, but maintain the Aspect ratio
ImageEnView1.IO.Params.Dict.Clear();
ImageEnView1.IO.Params.Dict.Insert( 'ImageMagick:Width', 2000 );
ImageEnView1.IO.Params.Dict.Insert( 'ImageMagick:Height', 1000 );
ImageEnView1.IO.Params.Dict.Insert( 'ImageMagick:AspectRatio', 1 );
ImageEnView1.IO.LoadFromFile( 'D:\SVG\Lion.svg' );

// Load an SVG at 200 dpi
ImageEnView1.IO.Params.Dict.Clear();
ImageEnView1.IO.Params.Dict.Insert( 'ImageMagick:Density', 200 );
ImageEnView1.IO.LoadFromFile( 'D:\SVG\Lion.svg' );

// Rasterize page number 5 of mybook.pdf at 200dpi
ImageEnView1.IO.Params.ImageIndex := 5;
ImageEnView1.IO.Params.Dict.Insert('ImageMagick:Density', 200);
ImageEnView1.IO.LoadFromFile('mybook.pdf');

// Save a JPEG as WebP at 95% quality
ImageEnView1.IO.LoadFromFile( 'D:\Image.jpg' );
ImageEnView1.IO.Params.Dict.Clear();
ImageEnView1.IO.Params.Dict.Insert( 'ImageMagick:Quality', 95 );
ImageEnView1.IO.LoadFromFile( 'D:\Image_out.WebP' );

// Save a PNG file as a lossless WebP with maximum compression
ImageEnView1.IO.SaveToFile('D:\Image.png');
ImageEnView1.IO.Params.Dict.Insert( 'ImageMagick', TIEDictionary.Create() );
ImageEnView1.IO.Params.Dict.GetDictionary('ImageMagick').Insert( 'webp:lossless', True );
ImageEnView1.IO.Params.Dict.GetDictionary('ImageMagick').Insert( 'webp:method', 6 );
ImageEnView1.IO.SaveToFile('D:\Image_out.webp');
{
Results:
Original PNG: 2.19 MB
Lossless+Method=0: 1.38 MB
Lossless+Method=6: 1.17 MB
Lossy+Method=0: 86.4 KB
Lossy+Method=6: 63.6 KB
}

---