Updating and Compatibility

Downloading Updates

During your registration period you will receive all new release for free. You can obtain the update at:

Once your registration ends, you will need to purchase an extension to continue receiving updates and support:

Implementing Updates

In general, the process of upgrading from any earlier version of ImageEn to the latest is painless. We work hard to ensure that our improvements do not affect your existing functionality, or require recoding. Generally this is done by defaulting to old methods, or marking an existing method as "Deprecated" while adding a newer one.

The following list includes all compatibility issues over its lifetime. If upgrading from a recent version of ImageEn it is easier to review the "Compatibility Issues" section of the version history.

TImageEnView Compatibility Notes

Item Version Change Type Notes
TImageEnView.fIEBitmap 10.3.5 Demoted The fIEBitmap field is no longer exposed. Use ImageEnView.IEBitmap instead
TImageEnView.PdfViewer 10.2.0 Changed Behavior To allow text selection you must set ImageEnView1.MouseInteractGeneral := [miPdfSelectText];
TIELayer.FillGradient 10.0.0 Changed Type Layer Gradients are now of type TIEGDIPlusGradient rather than TIELayerGradient. Conversions are as follows: grdNone -> gpgNone, grdHorizontal -> gpgHorizontal, grdVertical -> gpgVertical, grdHorzCenter -> gpgHorzCenter, grdVertCenter -> gpgVertCenter, grdDiagonal -> gpgDiagonal, grdDiagonal2 -> gpgDiagonal2, grdDiagCentered -> gpgDiagCenter, grdDiagCentered2 -> gpgDiagCenter2
MouseInteract 8.6.0 Changed Property TImageEnView.MouseInteract has now been split into MouseInteractGeneral and MouseInteractLayers. Layer interaction items have been renamed with an ml* prefix, e.g. miMoveLayers has become mlMoveLayers
miMoveLayers, miResizeLayers, miRotateLayers, miCreateImageLayers,miCreateShapeLayers, miCreateLineLayers, miCreatePolylineLayers,miCreateTextLayers, miClickCreateLineLayers, miClickCreatePolylineLayersmiDrawCreatePolylineLayers, miEditLayerPoints 8.6.0 Renamed Renamed with ml* prefix: mlMoveLayers, mlResizeLayers, mlRotateLayers, mlCreateImageLayers,mlCreateShapeLayers, mlCreateLineLayers, mlCreatePolylineLayers,mlCreateTextLayers, mlClickCreateLineLayers, mlClickCreatePolylineLayersmlDrawCreatePolylineLayers, mlEditLayerPoints
RulerParams.Units 8.5.0 Changed Types Units of RulerParams are now of the type TIEUnits not TIERulerUnits
OnButtonClick 8.1.2 Changed Parameters OnButtonClick now includes a MouseButton parameter. Remove existing event and add event handler again
OnDrawLayerBox 8.0.0 Changed Parameters OnDrawLayerBox uses a TCanvas rather than a TIEBitmap. Remove existing event and add event handler again
OnLayerSelectionChange 8.0.0 Changed Functionality OnLayerSelectionChange now fires for programmatic changes of selection too. Use OnLayerNotifyEx if you only want user generated changes
AnimPolygon* methods 8.0.0 Removed TImageEnView.AnimPolygonDel, AnimPolygonNew, AnimPolygonClear, AnimPolygonAddPt and AnimPolygonEnabled have been removed. Contact us if you made use of this functionality
Bitmap/LegacyBitmap 7.5.0 Changed Default LegacyBitmap now defaults to False. If your code accesses ImageEnView1.Bitmap, it will automatically set ImageEnView1.LegacyBitmap := True;
ZoomSelectionAspectRatio 7.5.0 Removed Use iedoMaintainAROnZoomSelect item of DisplayOptions instead
OffScreenPaint 7.5.0 Removed Use iedoPaintWhenOffScreen item of DisplayOptions instead
GetFitValue 7.0.1 Removed Use GetIdealZoom instead
LayersSync 7.0.0 Removed This property is no longer available. If you made use of this functionality (forcing all layers to have the same dimensions), email us for a workaround
LayersAdd/LayersInsert 7.0.0 Changed Functionality Layers are no longer created at position (0,0), they are given a default position which increments with each new layer
TIELayer 6.3.3 Moved unit The TIELayer class has been moved to the iexLayers unit so you may need to add it to your uses clause
LayersRepositionAll 6.3.1 Changed Functionality Due to error, LayersRepositionAll would move layer in opposite direction to documentation. Corrected in 6.3.1
DoubleBuffer 6.3.0 Removed No change in functionality
DisplayGridKind 6.2.2 Removed Rather than TImageEnView.DisplayGrid use DisplayGridKind
DPIX/DPIY 6.2.2 Changed Functionality These properties now just reference TImageEnView.IO.Params.DPI
LayersAutoUndo 6.2.1 Removed TImageEnView.LayersAutoUndo is now an option of LayerOptions. Also it is enabled by default if TImageEnView.Proc.AutoUndo is true
DisplayImageRect 5.2.0 Removed Set VisibleBitmapRect instead
Assign 5.2.0 Changed Functionality Now when calling Assign and the source is a TImageEnView it will copy all layers. If it is a TImageEnVect it will also copy all objects

TImageEnMView Compatibility Notes

Item Version Change Type Notes
FilenameFilter 10.1.0 Renamed FilenameFilter renamed to Filter
OnSelectionChanging 9.3.1 Changed Parameters OnSelectionChanging event now includes a NewIndex parameter. Remove existing event and add event handler again
OnSelectionChanging 9.3.1 Changed Behavior OnSelectionChanging event now occurs with Seek and SelectSeek
EnableLoadEXIFThumbnails 9.1.0 Changed Behavior Now defaults to false. If EnableLoadEXIFThumbnails is enabled, it uses EXIF thumbnails even if they are lower quality than the thumbnail resolution
SetPresetThumbnailFrame 8.3.0 Removed Removed TImageEnMView.SetPresetThumbnailFrame, use SetImageEnMViewPresetThumbnailFrame in iepresetim unit instead
GridWidth 8.1.0 Changed Behavior Default GridWidth for a new TImageEnMView is -1 (auto-width) instead of 0 (single row)
MultiSelectedImages 8.0.0 Changed Functionality MultiSelectedImages is now sorted by display order. To prevent auto-sorting (maintain order they were selected) add iemoDontSortMultiSelection to MultiSelectionOptions
AssignLayers 8.0.0 Changed Functionality AssignLayers was outputting in an order different from documentation. The default value for the Reversed parameter has been changed. Check any calls to AssignLayers in your code.
CropTool.Mode 6.3.1 Renamed TIECropToolInteraction.BitmapRectangle renamed to BitmapPolygon, TIECropTool.RotatedRectangle renamed to RotatedPolygon, TIECropTool.SetBitmapRectangle renamed to SetBitmapPolygon, TIECropTool.ScreenRectangle renamed to ScreenPolygon
RemoveCorrupted 6.2.2 Removed Rather than ImageEnMView1.RemoveCorrupted := True; use ieixRemoveCorrupted, e.g. ImageEnMView1.IOOptionsEx := ImageEnMView1.IOOptionsEx + [ ieixRemoveCorrupted ];
ThumbWidth/ThumbHeight 6.2.2 Changed Functionality No longer takes zoom into account when read. See ThumbSizeInfo instead
UpperGap/BottomGap 6.2.2 Changed Functionality No longer includes space for text (which is handled internally) so layout may change
TIEMText 6.0.0 Removed See compatibility notes for ImageTopText/ImageInfoText/ImageBottomText
EnableResamplingOnMinor 6.0.0 Removed Add ietxStretchSmallImages to TImageEnMView.ThumbnailOptionsEx
ImageTopText/ImageInfoText/ImageBottomText 6.0.0 Changed Functionality ImageTopText/ImageInfoText/ImageBottomText are no longer records, just widestring properties (see details below)
ImageTopText/ImageInfoText/ImageBottomText.Caption 6.0.0 Removed Just set ImageTopText/ImageInfoText/ImageBottomText which are now a widestring properties, e.g. IEMView1.ImageInfoText[idx].Caption := sFilename; Will become: IEMView1.ImageInfoText[idx] := sFilename;
ImageTopText/ImageInfoText/ImageBottomText.BackgroundStyle and Background 6.0.0 Removed Use TextBackgroundStyle and TextBackgroundColor. If you need custom styles for certain frames use OnGetTextEx
ImageTopText/ImageInfoText/ImageBottomText.TruncSide 6.0.0 Removed Use TImageEnMView.TextTruncSide
TImageEnMView.ImageTopText/ImageInfoText/ImageBottomText.Font 6.0.0 Removed Use TImageEnMView.TopTextFont/TImageEnMView.InfoTextFont/TImageEnMView.BottomTextFont. If you need custom fonts for certain frames use OnGetTextEx
Checkboxes 5.2.0 Changed Functionality Checkbox properties have changed. See Checkboxes and CheckboxPos
OnPlayFrame 5.2.0 Changed Parameters Remove existing OnPlayFrame event and add event handler again
HighlightTextColor 5.2.0 Removed Use SelectedFontColor (Note: Default of HighlightColor was clHighlightText, whereas ThumbnailsBackgroundSelected defaults to clNone)
SelectionStyle 5.2.0 Removed Use ThumbnailsBackgroundSelected instead
HighlightColor 5.2.0 Removed Use ThumbnailsBackgroundSelected (Note: Default of HighlightColor was clHighlight, whereas ThumbnailsBackgroundSelected defaults to clBtnFace)
OnImageIDRequest/OnImageIDRequestEx 5.1.0 Changed Parameters Remove existing OnImageIDRequest or OnImageIDRequestEx event and add event handler again
LoadIconOnUnknownFormat 5.0.0 Removed Add ietxShowIconForUnknownFormat to ThumbnailOptionsEx instead

TImageEnFolderMView Compatibility Notes

Item Version Change Type Notes
IncludeSubfolders 10.2.0 Changed By default, TImageEnFolderMView when parse a maximum of 1000 sub-folders when IncludeSubfolders is enabled. This can be configured using SubFolderLimit
DetectFileFormat 6.2.2 Removed Instead use ieixLoadOnlyByFileExt, e.g. TImageEnView.IOOptionsEx := ImageEnMView1.IOOptionsEx + [ ieixLoadOnlyByFileExt ];
ResetAllTextToDefault 6.2.0 Removed No longer needed when setting Default*Text. Otherwise use SetAllText e.g. IEMView1.SetAllText( IEMView1.DefaultTopText, IEMView1.DefaultInfoText, IEMView1.DefaultBottomText );
OnFolderChange 6.0.0 Removed Use OnFolderChanging and OnFolderChanged instead

TImageEnProc Compatibility Notes

Item Version Change Type Notes
RemoveIsolatedPixels 7.0.1 Changed Functionality By default, pixels that touch diagonally are no longer considered isolated. Set the CheckDiagonals parameter to false to revert to old functionality
Math and color methods 7.0.0 Moved unit Many math and color helper methods that were located in the imageenproc unit have now been moved to the hyieutils unit
Redo/RedoAt 6.3.0 Changed Parameters Combined parameters of Redo/RedoAt. If AutoUndo parameter is enabled then the entries added to undo will be removed from the Redo list. To return to older functionality, enable the IEUseLegacyUndoFunctionality define in
RedoPeekAt 6.3.0 Removed Code such as ImageEnView1.Proc.RedoPeekAt( idx ) should be replaced with ImageEnView1.Proc.GetRedoInfo( ImageEnView1.Proc.RedoCount - 1 - idx, Src, iOp ); See GetRedoInfo
Undo 6.3.0 Changed Undo captions are now read from iewords.pas and not hard coded. To use the older undo captions enable the IEUseLegacyUndoCaptions define in
Undo/UndoAt 6.3.0 Changed Parameters Combined parameters of Undo/UndoAt. If AutoUndo parameter is enabled then the entries added to redo will be removed from the Undo list. To return to older functionality, enable the IEUseLegacyUndoFunctionality define in
UndoPeekAt 6.3.0 Removed Code such as ImageEnView1.Proc.UndoPeekAt( idx ) should be replaced with ImageEnView1.Proc.GetUndoInfo( ImageEnView1.Proc.UndoCount - 1 - idx, Src, iOp ); See GetUndoInfo
ShiftChannel 5.2.0 Changed Parameters No longer use integers to specify channels for ShiftChannel. Use iecRed for 2, iecGreen for 1 and iecBlue for 0
Rotate 5.0.0 Changed Functionality Deprecated some Rotate methods in favour of overloaded versions that avoid the AntiAlias parameter. If you have used ImageEnProc1.Rotate(45) (i.e. with only one parameter and a non-90 degree rotation) then the anti-aliasing has changed from "None" to "Fast". To preserve the old behaviour, change your code to: ImageEnProc1.Rotate(45, ierNone)
CutTransparentBorder 4.3.0 Renamed Renamed to CropTransparentBorder

TImageEnIO Compatibility Notes

Item Version Change Type Notes
PrintImagePos and DoPrintPreviewDialog 8.0.0 Change in functionality When printing at a specified size, the aspect ratio of the image will be maintained. Set PrintingMaintainAR to false to prevent this
TIEDictionary 6.3.1 Change in functionality TImageEnView.IO.Params.Dict is now case insensitive
ProxyAddress/ProxyPassword/ProxyUser 6.2.0 Removed Now properties of IEGlobalSettings() so they apply to TIEBitmap and TIEMultiBitmap too. See ProxyAddress
AcquireOpen/AcquireClose 4.1.0 Renamed Renamed to TwainAcquireOpen/TwainAcquireClose

TImageEnMIO Compatibility Notes

Item Version Change Type Notes
PreviewPrintImages, PrintImagesToBitmap and PrintImagesToFile 8.1.0 Changed parameters Heading parameters have been added, so you may need to check the parameters you are using for PreviewPrintImages, PrintImagesToBitmap and PrintImagesToFile. If you pass a value for iPageNo, prefix it by: '', 5, clBlack,
PrintImagePos and DoPrintPreviewDialog 8.0.0 Change in functionality When printing at a specified size, the aspect ratio of the image will be maintained. Set PrintingMaintainAR to false to prevent this
SaveToFile 7.0.1 Changed Parameters May need to add ioUnknown as the second parameter for SaveToFile
ProxyAddress/ProxyPassword/ProxyUser 6.2.0 Removed Now properties of IEGlobalSettings() so they apply to TIEBitmap and TIEMultiBitmap too. See ProxyAddress
AcquireOpen/AcquireClose 4.1.0 Renamed Renamed to TwainAcquireOpen/TwainAcquireClose

TImageEnVect Compatibility Notes

Item Version Change Type Notes
Bitmap/LegacyBitmap 7.5.0 Changed Default LegacyBitmap now defaults to False. If your code accesses ImageEnVect1.Bitmap, it will automatically set ImageEnVect1.LegacyBitmap := True;
TIEShape 7.0.0 Renamed The class of ObjBeginShape and ObjEndShape has been renamed TIEVArrowShape
iekTEXT 6.2.2 Changed Functionality Text labels are vertically centered if using rounded labels
OnBeforeDrawObject/OnAfterDrawObject 5.1.0 Changed Parameters Remove existing OnBeforeDrawObject and OnAfterDrawObject events and add event handler again
GetObj 5.0.6 Changed Functionality GetObj now returns more specific exceptions
SelObjects 5.0.6 Changed Functionality SelObjects now returns -1 if there are no selected objects
DrawObjectsToBack/CopyObjectToBack/DrawObjectToBack/DrawOneObjectToBack 5.0.5 Changed Parameters Removed MergeAlpha parameter

TIEBitmap Compatibility Notes

Item Version Change Type Notes
RenderToTIEBitmap/RenderToTBitmap 6.3.0 Changed Parameters Removed ABitmapScanline parameter from RenderToTIEBitmap and RenderToTBitmap
Read (Stream overload) 6.0.0 Changed Parameters Check paramaters for Read. Code such as MyBmp.Read(aStream, aIOParams); should change to MyBmp.Read(aStream, ioUnknown, aIOParams);
RenderToTIEBitmapEx 6.0.0 Changed Functionality RenderToTIEBitmapEx now includes a bEnableAlpha parameter (set to True to preserve existing functionality)

IEVision Compatibility Notes

Item Version Change Type Notes
createOCR 8.3.0 Updated Support File IEVision 5.0.0 improves OCR and now uses a new set of language files. These should be downloaded from:

Other Compatibility Notes

Item Version Change Type Notes
ieppPrintTextWithGDI, iepoGrayScale 11.0.0 Removed Removed PDF options that are no longer supported by PDFium
TIEPdfViewerInteraction.AllowTextSelection 10.2.0 Removed To allow text selection you must set ImageEnView1.MouseInteractGeneral := [miPdfSelectText];
IEGlobalSettings().ImageEnVersion 10.0.1 Type change IEGlobalSettings().ImageEnVersion is now of type TIEVersion. Code that referenced IEGlobalSettings().ImageEnVersion should use IEGlobalSettings().ImageEnVersion.VersionStr
iexClasses, iexVirtualBitmaps, iexUserInteractions 9.3.1 New Units Some classes have been moved to new units. You may need to add them to your uses clause.
IEGlobalSettings().CameraRawEngine 9.2.5 Type change TIECameraRawEngine type replaced by TIEImagingEngine. Set items change as follows: iecrAuto -> ieenAuto, iecrLibRaw -> ieenDLL, iecrWIC -> ieenWIC, iecrDCRaw -> ieenLegacy
IEGlobalSettings().EnableTheming 9.1.0 Changed default EnableTheming now defaults to true, i.e. themed colors will be used by default, if VCL theming has been enabled
IEGlobalSettings().MinimumRawEmbeddedJpegWidth/Height 9.1.0 Removed Instead use RAW_EmbeddedJpegMinWidth and RAW_EmbeddedJpegMinHeight
TIEFileDragDrop 8.7.5 Moved Unit If you use TIEFileDragDrop, you will need to add iexWindowsFunctions to your uses clause
IEGetJumboFileIcon/IEGetLargeFileIcon 8.3.0 Renamed Exposed as WindowsGetFileIcon
IEGetMyComputerName 8.3.0 Renamed Exposed as WindowsGetMyPCName
IEGetMyComputerIcon 8.3.0 Renamed Exposed as WindowsGetMyPCIcon
WindowsGetExplorerThumbnail 8.3.0 Renamed Exposed as WindowsGetExplorerThumbnail
TIEGlobalSettings.CameraRawEngine 8.3.0 Changed Default By default, Raw Camera images will be loaded using LibRaw (or WIC) instead of DCRaw. You can revert to old functionality using CameraRawEngine, e.g. IEGlobalSettings().CameraRawEngine := ieenLegacy;
IEDLLLoadLog 8.1.1 Moved Instead of IEDLLLoadLog, use IEGlobalSettings().DLLLoadingLog
ImageEn Layer Actions 8.1.0 Moved classes All TImageEnView Layer Actions have been moved to the iexActionsLayers unit. You may need to add it to your uses clause.
IEGlobalSettings().UseLibRaw 8.0.1 Removed Instead use IEGlobalSettings().CameraRawEngine
TIEDicomTags.GetTagDescription 8.0.0 Moved Use IEGetDicomTagDescription in ieDicomTags unit instead. Code that was s := ImageEnView1.IO.Params.DICOM_Tags.GetTagDescription(idx); should be changed to s := IEGetDicomTagDescription( ImageEnView1.IO.Params.DICOM_Tags, idx );
Supported_Generate_Points_Shapes 8.0.0 Removed All shapes are now supported by points
TRulerBox.OnRulerPosChange/OnRulerGripClick/OnRulerGripDblClick/OnRulerClick 6.3.1 Changed Parameters Parameters have changed for TRulerBox events. Remove old event handlers and recreate
TIOParams.LoadFromFile/LoadFromStream/SaveToFile/SaveToStream 6.3.1 Changed Functionality By default, LoadFromFile/LoadFromStream is incompatible with files created using SaveToFile/SaveToStream in pre-6.3.1 versions of ImageEn. To maintain compatiblity you must set the CheckMagicString parameter to false
TIEVirtualBitmapProvider.Render 6.3.0 Changed Parameters Check documentation for Render
IEAddExtIOPlugin 6.2.2 Changed Functionality Now raises exception if try to load DCRAW (i.e. call ieaddextioplugin('dcrawlib.dll'). Instead of DCRAW add ielib.dll/ielib64.dll to your EXE folder (it loads automatically)
DCRAW.DLL and Raw Files 6.2.0 Changed Functionality No longer supports RAW camera format internally or uses dcrawlib.dll. ImageEn now just needs ielib.dll/ielib64.dll to load RAW camera files (don't need to initialize, just put in same folder as your EXE)
ioRawDLLPlugIn 6.2.0 Removed Use ioRaw instead
TOpenImageEnDialog 6.2.0 Changed Functionality No longer defaults to filter of filename, unless FilterDefault is set
AdjustRectToAspectRatio 6.0.0 Changed Parameters Replaced by IEAdjustRectToAspectRatio, but note change of parameter order
iexHelperFunctions.GetFileDetails 6.0.0 Removed Use IEGetFileDetails instead
iexDicomRoutines 5.2.0 Removed Dicom helper unit, iexDicomRoutines is no longer included, by default. Either use the updated array and relevant functions in ieDicom or the access the old units in \Source\Legacy\
iexEXIFRoutines.pas/iexIPTCRoutines.pas 5.2.0 Removed EXIF helper unit, iexEXIFRoutines.pas, and IPTC helper unit, iexIPTCRoutines.pas, are no longer included, by default. Either use the iexMetaHelpers unit or the access the old units in \Source\Legacy\
TIEDICOMTags.AddTag/TIEDICOMTags.GetTagChildren 5.2.0 Changed Functionality Applications calling AddTag and GetTagChildren must work with TObjectList as child object
TOpenImageEnDialog 5.1.0 Changed Functionality The file types that appear in the "Common" list of TOpenImageEnDialog file filter have changed
TOpenImageEnDialog.ShowAVI 5.1.0 Removed Use the published property, ShowFormats, instead
ieXtraTransitions.pas 5.0.5 Renamed Renamed to iexTransitions.pas
TIETransitionType 5.0.5 Moved TIETransitionType and other transition code moved to iexTransitions.pas
TIEVirtualBitmapRenderer 5.0.0 Renamed Renamed to TIEVirtualBitmapProvider
ioDLLPLUGINS 5.0.0 Removed Replaced by ioOtherDLLPlugIns
DefGIF_LZWDECOMPFUNC, DefGIF_LZWCOMPFUNC, DefTIFF_LZWDECOMPFUNC, DefTIFF_LZWCOMPFUNC 4.3.1 Changed Functionality These are now set automatically by ImageEn. They do not need to be specified.
iegDefaultCoresCount, iegOpSys, iegUnicodeOS, iegDefaultPreviewsZoomFilter, IEDefDialogCenter, iegDefaultDialogFont, IEDefMinFileSize, iegAutoLocateOnDisk, iegAutoFragmentBitmap, iegUseGDIPlus, iegPreviewImageBackgroundStyle, iegPreviewImageBackgroundColor, iegPreviewAdditionalMultipageExts, iegMemoShortCuts, ieMeasureUnits, gSystemColors, gIsRemoteSession, gSystemDPIX, gSystemDPIY, gDefaultDPIX, gDefaultDPIY, gMMX, gEdgeX, gEdgeY, gBorderX, gBorderY, gVScrollWidth, gHScrollHeight, iegMinZoomDisplayGrid, iegGridPen, iegSelectionGridColor, iegMViewExplorerThumbnailExts, iegFileFormats, iegUseCMYKProfile, iegUseDefaultFileExists, iegMaxImageEMFSize, iegEnableCMS, iegColorReductionQuality, iegColorReductionAlgorithm, iegObjectsTIFFTag, iegUseRelativeStreams, iegPanZoomQualityFilter, gRedToGrayCoef, gGreenToGrayCoef 4.3.1 Removed Now available under IEGlobalSettings(), e.g. Instead of IEDefMinFileSize := 10240000; use IEGlobalSettings().DefMinFileSize := 10240000;
MsgLanguage 4.3.1 Removed Now removed from individual objects. Instead use MsgLanguage

Deprecated Classes and Methods

Superseded methods in ImageEn are marked deprecated and you may get a warning from Delphi (you can prevent this by undefining IEWarningForDeprecated in Although deprecated methods will continue to work thoughout the lifetime of ImageEn, you can disable their inclusion by undefining IEIncludeDeprecatedInV* in

Item Version Change Type Notes
TImageEnMView.UnfilteredCount 10.3.0 Deprecated Instead use FilteredCount(False)
TImageEnView.IsEmpty2 10.1.0 Deprecated Instead use IsEmpty(False)
TImageEnMView.MultiSelectedImagesAutoSort 9.2.0 Deprecated Instead add iemoDontSortMultiSelection to MultiSelectionOptions to disable sorting
TImageEnMView.SideGap 9.1.0 Deprecated Instead use LeftGap and RightGap
TImageEnView.AutoFit 8.6.0 Deprecated Instead use AutoShrink and AutoStretch
TImageEnView.AutoFixRotationBorders 7.0.0 Deprecated Instead use loAutoFixBorders of LayerOptions
TImageEnView.CopySelectionToIEBitmap 6.2.0 Deprecated Use CopySelectionToBitmap instead
TImageEnView.CropTool.Crop 8.0.0 Deprecated Instead use ImageEnView1.CropTool.Enact
TImageEnView.LayersRotationDelayFilterOnPreview 7.0.0 Deprecated Instead use LayersFastDrawing := iefDelayed;
TImageEnView.ForceALTkey 8.0.0 Deprecated Instead use ShiftKeyLock
TImageEnView.LayersCreateFromText 7.0.0 Deprecated Instead use LayersAdd text overload
TImageEnView.LayersLoadFromFile/LayersLoadFromStream/LayersSaveToFile/LayersSaveToStream 7.0.0 Deprecated Instead use LoadFromFileIEN/LoadFromStreamIEN/SaveToFileIEN/SaveToStreamIEN
TImageEnView.LayersMove 8.0.0 Renamed Now named LayersArrange
TImageEnView.LayersRotationAntialias 9.0.0 Deprecated Use LayersRotationFilter instead
TImageEnView.MouseInteract 8.6.0 Renamed Now named MouseInteractGeneral. Some items have been moved to MouseInteractLayers
TImageEnView.RulerParams.AlignToImage 8.0.0 Deprecated Instead use ImageEnView1.RulerParams.DisplayNegativeValues
TIELayer.IsRuler 10.2.0 Deprecated Instead use RulerMode = iermLabel;
TIELineLayer.SizeToFit 8.7.6 Deprecated No longer needed as line layers now automatically size to fit the containing line
TIELineLayer.SetLinePointsEx 8.7.6 Deprecated Instead use SetPoints
TIELayer.GetIndex 8.0.0 Deprecated Instead use LayerIndex
TIELineLayer.LinePoints 8.0.0 Deprecated Instead use LinePoint1 and LinePoint2
TImageEnFolderMView.SortAscending/SortCaseSensitive 9.3.0 Deprecated Use SortOptions instead
TImageEnMView.InsertTransitionFramesEx 9.0.0 Deprecated Use InsertTransitionFrames overload instead
TImageEnMView.DrawImageBackground 8.5.0 Deprecated Instead add ietxFillWithImgBackground to ThumbnailOptionsEx
TImageEnMView.TrackMouseSelection 8.0.0 Deprecated Replaced by iemoHideSelectionRect of MultiSelectionOptions
TImageEnMView.SelectionAntialiased 7.0.0 Deprecated Replaced by ThumbnailsBorderCurved
TImageEnMView.SetIEBitmap 6.2.0 Deprecated Use SetImage instead
TImageEnProc.PrepareTransitionBitmapsEx 9.0.0 Deprecated Use PrepareTransitionBitmaps overload instead
TImageEnProc.CopyToClipboard 7.0.0 Deprecated See new overload of CopyToClipboard
TImageEnProc.SelCopyToClip 7.0.0 Deprecated Instead use CopyToClipboard(iecpSelection)
TImageEnProc.SelCutToClip 7.0.0 Deprecated Instead use CutToClipboard(iecpSelection)
TImageEnProc.IsClipboardAvailable 7.0.0 Deprecated Instead use CanPasteFromClipboard(iecAuto)
TImageEnProc.SelPasteFromClip 7.0.0 Deprecated Instead use PasteFromClipboard(iecpSelection)
TImageEnProc.SaveUndoCaptioned/SaveRedoCaptioned 6.2.2 Deprecated Use overloaded SaveUndo/SaveRedo instead
TImageEnProc.MergeIEBitmap 6.2.0 Deprecated Use Merge instead
TImageEnProc.SelPasteFromClipStretch 6.2.0 Deprecated Use PasteFromClipboard instead
TImageEnProc.ppeColorAdjust/ppeEffects 6.0.0 Deprecated Use ppeColorAdjustments, ppeEditingFunctions, ppeSpecialEffects instead
TImageEnIO.LoadFromFileFormat/LoadFromStreamFormat 6.2.0 Deprecated Use LoadFromFile/LoadFromStream instead
TImageEnIO.TIOParamsVals 6.2.0 Deprecated Renamed TIOParamsVals class to TIOParams
TImageEnMIO.LoadFromFileFormat/LoadFromStreamFormat 6.2.0 Deprecated Use LoadFromFile/LoadFromStream instead
TImageEnViewSelCopyToClip/TImageEnViewSelCutToClip 7.0.0 Deprecated Use TImageEnViewCopyToClipboard/TImageEnViewCutToClipboard instead. Set CopySource to iecpSelection
TImageEnViewLayersCreateFromClipboard 7.0.0 Deprecated Use TImageEnViewPasteFromClipboard instead. Set PasteDest to iecpLayer
DrawCustomShape/CreateCustomShapeRegion/TXCustomShape 7.0.0 Deprecated Use new IEDrawShape/IECreateShapeRegion/TIEShape instead
TImageEnVideoView/TImageEnVideoCap 5.0.0 Deprecated Use DirectShow instead. See Demos for more info
TIEMultiBitmap.InsertTransitionFramesEx 9.0.0 Deprecated Use InsertTransitionFrames overload instead
EXIFCompatibleFile, NewGridForEXIF, ReadGridFromEXIF, WriteGridToEXIF, NewListForEXIF, ReadListFromEXIF, WriteListToEXIF, EXIF_WriteToStrings, EXIF_ApertureValue_Str, ExposureTime_Str, EXIF_FNumber_Str, EXIF_MaxApertureValue_Str, EXIF_ShutterSpeedValue_Str, EXIF_XResolution, EXIF_YResolution, EXIF_CanWriteEXIFData, IPTC_HasIPTCData, IPTCCompatibleFile, NewGridForIPTC, ReadGridFromIPTC, WriteGridToIPTC, NewListForIPTC, ReadListFromIPTC, WriteListToIPTC, IPTC_WriteToStrings, DicomCompatibleFile, DICOM_HasDicomTags, ReadGridFromDicom, ReadListFromDicom, DICOM_WriteToStrings, XMPCompatibleFile, XMP_HasXMPData, ReadGridFromXMP, ReadListFromXMP, XMP_WriteToStrings, InitializeGrid, ClearGridFields, InitializeList, ClearListFields, GetExifTagList, ContainsExifTag, ReplaceExifTags 11.0.0 Deprecated Review the iexMetaHelper Compatibility Notes
IEGlobalSettings().MemoShortcuts 10.2.0 Deprecated Use KeyboardShortcuts instead
IEAutoLoadIOPlugins 10.0.0 Deprecated Use RegisterPlugIns instead
IEGetTranslationWord/IESetTranslationWord 9.3.0 Deprecated Use GetLanguageWord and SetLanguageWord instead
CubeEngineExistsInFolder 8.3.0 Deprecated IEVision 5.0.0 improves OCR and no longer uses Cube so CubeEngineExistsInFolder will always return False
ievOCRFAST, ievOCRCUBE, ievOCRACCURATE 8.3.0 Deprecated IEVision 5.0.0 improves OCR and no longer needs these definitions

Deprecated Components

Some older components have been replaced by newer ones, or otherwise are no longer relevant. To support legacy projects, these components will continue to be available thoughout the lifetime of ImageEn, you can disable their inclusion by undefining them in

Component Replaced by Notes
TImageEnVect TImageEnView Layers Please read the conversion documentation
TRulerBox TImageEnView Rulers Rulers are now built into TImageEnView
TImageEnDBView TIEDBBitmap Use a standard TImageEnView and set TIEDBBitmap as a source bitmap
TImageEnDBVect TIEDBBitmap Convert your code to use TImageEnView Layers and use a TIEDBBitmap
TIEMediaReader TIEMultiBitmap TIEMediaReader uses IMediaDet, which Microsoft has marked as Deprecated and may be removed from future releases of Windows
TImageEnVideoView TIEDirectShow Video for Windows is no longer supported by Microsoft. See the DirectShow demos to display video files in a TImageEnView
TImageEnVideoCap TIEDirectShow Video for Windows is no longer supported by Microsoft. See the DirectShow demos to capture video