ImageEn supports over eighty image and video formats:

• Adobe PhotoShop
• Camera Raw Images
• DICOM
• GIF
• HEIC/HEIF
• ImageEn Format
• JPEG
• JPEG 2000
• PCX/DCX
• PDF Files
• PNG
• PostScript
• SVG
• TIFF
• WebP
• Windows Bitmap
• Windows Cursors
• Windows Icons
• Windows Metafiles
• Other Native Images
• WIC Image Formats
• Other Plug-In Formats
• AVI Videos
• Other Video Formats
• ZIP Archives

Supported Formats

Adobe Photoshop Format

PSD is the native image format of Adobe Photoshop. It supports layers.

Notes
◼ImageEn can load PSD files as a single image or as multiple layers (if PSD_LoadLayers is enabled)
◼Some custom PSD layer formats may not be supported
◼If you save to PSD from a TImageEnView containing multiple layers the created PSD file will have layers. To avoid this, merge the image before saving
◼View all PSD Methods and Properties

Demo
Demos\LayerEditing\Layers_AllTypes\Layers.dpr

Camera Raw Formats

ImageEn supports a wide variety of the native image formats of cameras, from Canon (*.cr2, *.cr3, *.crw), Kodak (*.dcr, *.kdc), Minolta (*.mrw), Nikon (*.nef), Olympus (*.orf), Pentax (*.pef), Fuji (*.raf), Leica (*.raw), Sony (*.srf, *.sr2, *.arw) and Sigma (*.x3f). RAW formats are full color images.

Notes
◼Two imaging engines are available: DLL (based on LibRaw) and WIC. Using the DLL adds support for a much wider set of Raw formats
◼You can speed up loading by retrieving a half size, embedded JPEG or thumbnail image
◼RAW images generally needs to have their colors adjusted for display using options such as RAW_UseAutoWB, RAW_UseCameraWB and other parameters
◼RAW images can be automatically rotated for display if relevant meta-data is available
◼Saving is NOT supported
◼View all Camera Raw Methods and Properties

Demo
\Demos\InputOutput\CameraRaw\CameraRaw.dpr

Dicom Format

DICOM is a widely used image format in the medical community. It offers both lossy and lossless saving and supports many compression types and color formats.

Notes
◼Specify which frame to load using ImageIndex (between 0 and ImageCount-1), use a TImageEnMView to load and display all frames or enable Playing to animate the image
◼There are many compression and other parameters that affect saving
◼To update DICOM Tags without resaving the image use InjectDicomTags
◼View all DICOM Methods and Properties

Demo
\Demos\InputOutput\Dicom\Dicom.dpr

GIF Format

GIF is a popular web format. It is lossless (no image information lost on saving), but is limited to 256 colors. GIF files are often animated.

Notes
◼Specify which frame to load using ImageIndex (between 0 and ImageCount-1), use a TImageEnMView to load and display all frames
◼Enable Playing in TImageEnView or TImageEnMView to animate the image
◼There are few parameters that affect saving
◼Enable GIF_FlagTranspColor and specify the key color to save a transparent GIF
◼To manipulate multiframe GIFs in memory, use a TIEMultiBitmap or global methods
◼View all GIF Methods and Properties

Demo
\Demos\ImageEditing\AnimatedGIF\GifDemo.dpr

ImageEn Format

IEN is a propietary image format of ImageEn. It is a compressed format with support for transparency, vectors, annotations and layers (images, text, shapes and lines).

Notes
◼You can speed up loading by retrieving a thumbnail
◼If you save to IEN from a TImageEnView containing multiple layers the created file will have layers
◼To save layers as annotations only (i.e. not including the background image), disable IEN_StoreBackground
◼Specify the compression and size of the thumbnail
◼View all IEN Methods and Properties

Demo
Demos\LayerEditing\Layers_AllTypes\Layers.dpr

JPEG Format

JPEG is one of the most widely used image formats. It is lossy (discards some image information when saving) and offers good quality for a very small file size. It works best with photos.

Notes
◼Three imaging engines are available: Native, DLL and WIC
◼You can speed up loading by retrieving a scaled image or thumbnail
◼Other parameters can be set to optimize I/O
◼JPEG can be automatically rotated for display if relevant meta-data is available
◼Specify the quality when saving to optimize image quality vs file size
◼Quality is lost each time an image is saved as JPEG (lossy), but there are global methods to rotate, flip and crop images without quality loss (lossless)
◼To update EXIF without resaving the image use InjectJpegEXIF
◼To update IPTC without resaving the image use InjectJpegIPTC
◼View all JPEG Methods and Properties

JPEG 2000 Format

JPEG 2000 was created as a modern replacement for the JPEG format, but despite its many advantages it has not seen wide adoption. It offers both lossy and lossless saving and supports many compression types and color formats.

Notes
◼Two imaging engines are available: Native and DLL
◼You can speed up loading by retrieving a scaled image
◼Specify the quality or rate to optimize image quality vs file size. Images can be saved losslessly (without quality loss) by setting rate to 1
◼Other parameters can be set to optimize I/O when saving
◼View all JPEG2000 Methods and Properties

PDF Files

Adobe PDF files are documents that are widely used in business.

Format Support
ImageEn supports PDF files in multiple ways, which are not all compatible:

PDFium
If you have installed the PDFium plug-in and enabled PdfViewer mode, then via TImageEnView (or directly using a TIEPdfViewer object) you can display and manipulate PDF files, including text searching and selection, form editing, and page importing, moving and deletion.
In this mode, LoadFromFilePDF and SaveToFilePDF will interact directly with the PdfViewer to load and save multipage PDF files.

PDF Loading
If you have installed a relevant plug-in, such as PDFium (and NOT enabled PdfViewer mode), then ImageEn can import a rasterized bitmap of each page into a TImageEnView or rasterized version of a whole document into a TImageEnMView. You should not save the document to PDF if it was loaded in this way because it will be converted to an image-only PDF (e.g. text content cannot be selected or searched).
You can also import objects in a PDF page as ImageEn layers.

PDF Saving
Natively, ImageEn can save images to a PDF file. Also, if you have multiple layers the saved PDF file will be scalable and text will be selectable and searchable.
If you have installed the PDFium plug-in and enabled PdfViewer mode, then changes made to the PDF document can be saved.

OCR Method
The IEVision Add-On also includes a method to convert text images to Searchable PDF files

Notes
◼Specify the supported method for PDF using PDFEngine
◼To load PDF files you must install a plug-in
◼Specify which page to load using ImageIndex (between 0 and ImageCount-1) or use a TImageEnMView to load and display all pages
◼Pages can be loaded to a specific size using LoadFromFilePDF or by specifying auto-scaling properties
◼Specify the compression and other parameters when saving
◼The TIEPDFBuilder class can be used for more control over PDF generation
◼View all PDF Methods and Properties

Demos
\Demos\PDF\PDFBuilder\PDFBuilder.dpr
\Demos\PDF\PDFBuilder2\PDFBuilder2.dpr
\Demos\PDF\PDFViewer\PdfViewer.dpr
\Demos\PDF\PDFViewerToolbar\PdfViewerToolbar.dpr
\Demos\Actions\Actions_PdfViewer\PdfViewerActions.dpr
\Demos\PDF\PDFPageObjects\PDFPageObjects.dpr
\Demos\PDF\PDFPageObjects_FromLayers\PDFPageObjectsLayers.dpr
\Demos\PDF\PDFPageDragDrop\PDFPageDD.dpr
\Demos\PDF\PDFFormFields\PdfViewerFF.dpr
\Demos\PDF\PDFPrinter\PdfPrinter.dpr

PNG Format

PNG is a widely used image format. It is lossless (no image information lost on saving) and supports all color formats and transparency. It is one of the best formats to use when saving images for editing.

Notes
◼Three imaging engines are available: Native, DLL and WIC
◼Using the DLL adds support for extra PNG features, including Apple CgBI format and improved PNG text fields compatibility
◼When saving set the compression to reduce file size (it will not lower the quality of the image but will slow processing)
◼For PNG files that contains chunks, ImageEn will extract EXIF data from "eXIf", "iTXt", "zTXt" and "tEXt" chunks and XMP from "iTXt", "zTXt" and "tEXt" chunks
◼View all PNG Methods and Properties

PostScript Files

Adobe PostScript (*.ps, *.eps) is an electronic publishing format.

Notes
◼ImageEn cannot natively load PS files. If you have installed a relevant plug-in ImageEn can import a rasterized bitmap of each page
◼Specify which page to load using ImageIndex (between 0 and ImageCount-1) or use a TImageEnMView to load and display all pages
◼ImageEn can export images to a PS file
◼Specify the compression and other parameters when saving

SVG Format

SVG (Scalable Vector Graphics) is a vector format mainly used by web browsers. SVG images can be scaled without losing quality.

Format Support
ImageEn supports SVG files in multiple ways:

SVG Loading
◼Loads SVG natively as a rasterized bitmap or imports as vector layers
◼Loads SVG as a rasterized bitmap on Delphi 12 if you add Vcl.Skia to your uses clause and enable Skia for your project
◼Loads SVG as a rasterized bitmap if you install the ImageMagick Plug-In

SVG Saving
◼ImageEn can natively export layers from TImageEnView as a scalable SVG file
◼ImageEn can save an image as an embedded-image SVG file

Notes
◼Specify the compression for saving of image layers
◼The TIESVGParser class can be used for more control over SVG parsing
◼View all SVG Methods and Properties

Demos
\Demos\InputOutput\SVGParsing\SVGParsing.dpr
\Demos\LayerEditing\Layers_AllTypes\Layers.dpr
\Demos\InputOutput\ImageMagick\ImageMagick.dpr
\Demos\LayerEditing\SVGVectorLayers\SVGLayers.dpr

TIFF Format

TIFF is a popular document format. It is lossless (no image information lost on saving) and has many sub-formats (e.g. types of compression). It is often used with monochrome documents, such as Fax images.

Notes
◼Specify which frame to load using ImageIndex (between 0 and ImageCount-1) or use a TImageEnMView to load and display all frames
◼TIFF supports various compression and other options when saving
◼To manipulate multiframe TIFFs (add, delete pages, etc), use a TIEMultiBitmap, a TIETIFFHandler object or global methods
◼To update EXIF without resaving the image use InjectTIFFEXIF
◼View all TIFF Methods and Properties

Demos
\Demos\Multi\MultiBitmap\MBitmap.dpr
\Demos\Multi\Multiview\Multi.dpr

Windows Bitmaps

BMP is a native Windows image format. It is lossless (no image information lost on saving), but offers only limited compression (very large files).

Notes
◼Due to the lack of compression, loading and saving of BMP is very fast (good for temporary files)
◼View all BMP Methods and Properties

Windows Cursors

Cursor files are used by Windows to store mouse pointers of varying sizes and resolutions.

Notes
◼Specify which image to load using ImageIndex (between 0 and ImageCount-1) or use a TImageEnMView to load and display all images
◼When saving, specify the "hot spot" of the cursor
◼View all CUR Methods and Properties

Windows Icons

Icon files are used by Windows to store images of varying sizes and resolutions for applications and documents.

Notes
◼Specify which image to load using ImageIndex (between 0 and ImageCount-1) or use a TImageEnMView to load and display all images
◼When saving, ImageEn can automatically generate icons of different sizes and resolutions from a single image
◼Specify the compression and other parameters
◼View all ICO Methods and Properties

Demo
\Demos\ImageEditing\IconEditor\IconEditor.dpr

Meta Files

Metafiles are Windows vector images that are commonly used for clip-art. They can be scaled when loading without loss of quality.

Notes
◼You can also specify a default background color
◼Meta-files can be loaded to a specific size using ImportMetafile or by specifying auto-scaling properties
◼You can also specify a maximum loading size
◼Saving is NOT supported

Demo
\Demos\LayerEditing\SVGVectorLayers\SVGLayers.dpr

WebP Format

WebP is a raster graphics file format developed by Google. It supports both lossy and lossless compression.

Format Support
WebP is supported by ImageEn in the following ways:

WebP Loading
◼Supported by the WebP DLL
◼Supported automatically on Delphi 12 if you add Vcl.Skia to your uses clause and enable Skia for your project
◼Supported by WIC
◼Supported by the ImageMagick Plug-In

WebP Saving
◼Supported using the WebP DLL
◼Supported by the ImageMagick Plug-In

Notes
◼Specify the supported method for WebP using WebPEngine
◼WebP images can be saved losslessly, or at various levels of compression
◼For ImageMagick Plug-In, you can use a Dictionary to specify quality options when saving to WebP
◼To load multi-frame images with ImageMagick Plug-In, specify which image to load using ImageIndex (between 0 and ImageCount-1) or use a TImageEnMView to load and display all images
◼View all WebP Methods and Properties

Demos
\Demos\InputOutput\ImageMagick\ImageMagick.dpr

HEIC/HEIF Format

HEIC/HEIF (High Efficiency Image File) is a container format for storing images and image sequences.

Format Support
HEIC is not supported natively by ImageEn, but loading is supported using PlugIns:

HEIC Loading
◼Supported by WIC
◼Supported by the ImageMagick Plug-In

HEIC Saving
◼Supported by WIC

Notes
◼For multi-frame images, specify which image to load using ImageIndex (between 0 and ImageCount-1) or use a TImageEnMView to load and display all images
◼Only saving of single-frame images is supported. Use HDP_ImageQuality to specify the compression

Demos
\Demos\InputOutput\ImageMagick\ImageMagick.dpr

Other Native Formats

ImageEn also provides native support for other formats, including BmpRaw, a true "raw" bitmap format, and Targa (*.tga), PXM, Wireless BMP (*.wbmp), PCX and DCX (a multi-page variant of PCX). Most of the these formats are seldom used today.


Notes
◼Loading and saving is supported for all formats
◼For DCX, specify which frame to load using ImageIndex (between 0 and ImageCount-1) or use a TImageEnMView to load and display all frames
◼TGA supports compression, as does PCX/DCX
◼Specify parameters when saving BmpRaw
◼View all Legacy Methods and Properties

Demo
\Demos\InputOutput\RealRAW\RealRAW.dpr

WIC Formats

WIC (Windows Imaging Component) is a Windows API that provides access to fast Windows methods for loading and saving images.
WIC is used by ImageEn to support HDP, DDS, HEIF/HEIC, AVIF and WebP. It can optionally be used to load other formats such as JPEG, PNG, GIF, etc.
To support some WIC formats (such as HEIF, AVIF and WebP) you will need to install a codec from the Microsoft Store

Notes
◼For multi-frame images, specify which image to load using ImageIndex (between 0 and ImageCount-1) or use a TImageEnMView to load and display all images
◼WIC can optionally be used for loading JPEG, PNG, JPEG 2000 and Camera Raw images
◼Saving is supported for DDS and HDP. Saving is NOT supported for HEIF, AVIF and WebP. Other formats will depend on the codec
◼Specify the quality when saving HDP (optionally making it lossless)
◼You can optionally use the TIEWICReader and TIEWICWriter classes directly
◼View all WIC Methods and Properties

Other Plug-In Formats

ImageEn supports many other image formats via external plug-ins:
Adobe PDF (*.pdf, *.epdf), PostScript (*.ps, *.eps), Scalable Vector Graphics (*.svg, *.svgz), High Efficiency Image File (*.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), Microsoft XML Page (*.xps), MPEG (*.mp4, *.mpeg, *.mpg*.mov; *.m2v; *.m4v)

Notes
◼Loading is supported for all formats
◼You can load images at a specific size using the auto-scaling properties (works best with vector formats, such as SVG)
◼Saving is NOT supported for these formats: *.heic, *.heif, *.avif, *.ttf, *.otf, *.pfa, *.pfb, *.ttc, *.dfont, *.pes, *.cals, *.cal, *.xcf
◼View all Plug-In Methods and Properties

Demos
\Demos\InputOutput\ImageMagick\ImageMagick.dpr
\Demos\LayerEditing\SVGVectorLayers\SVGLayers.dpr

AVI Videos

AVI is a Windows video file format.

Notes
◼Use a TImageEnMView to load and display all video frames, or load specific frames into a TImageEnView
◼Enable Playing in TImageEnView or TImageEnMView to animate the video frames (without audio)
◼Use DirectShow for native Windows playback and capture
◼ImageEn can save silent AVI files or capture using DirectShow
◼Specify the frame interval to control playback speed
◼View all AVI Methods and Properties

Demo
\Demos\Multi\Multiview\Multi.dpr
\Demos\VideoCapture\ImagesToAvi\ImagesToAvi.dpr
\Demos\Display\VideoPlayer\VideoPlayer.dpr

Other Video Formats

ImageEn supports other video formats (MPEG, WMV, etc) via the DirectShow or MMF APIs

Notes
◼Use a TImageEnMView to load and display all video frames, or load specific frames into a TImageEnView
◼Use DirectShow for native Windows playback and capture
◼ImageEn can capture using DirectShow
◼Specify the frame interval to control playback speed
◼View all Video Methods and Properties

Demo
\Demos\Display\VideoPlayer\VideoPlayer.dpr

ZIP and Other Archives

ZIP is an archive format that compresses and stores files (with optional encryption).

Notes
◼Requires the 7z plug-in
◼Use a TImageEnMView to load and display all files, or load specific files into a TImageEnView
◼View all ZIP Methods and Properties

Demo
\Demos\Other\ZipBrowser\ZipBrowser.dpr
\Demos\Multi\FolderMView\FolderMView.dpr

See Also

◼TIOFileType
◼FileFormats
◼RegisterPlugIns

---