Assigning True to Aborting property, applications can abort save/load processing. On loading, the image will be truncated. On saving the file will be closed and truncated (will be unreadable).

Aborting doesn't grant that the input/output stop immediately (just it is possible).

You can also read Aborting property to know when aborting is in progress.

AddSelectionPoint adds a point to the current polygonal selection.

If SelectionBase is ClientArea all coordinates depends from actual Zoom and scrolling.

Otherwise, if SelectionBase is Bitmap (the default) all coordinates refers bitmap pixels.

Use EndSelect to terminate selection by code.

Add a soft shadow (Gaussian Shadow) to the image. The intensity comes from radius parameter (>0), and the light effect from OffsetX and OffsetY.

AddSoftShadow creates the shadow effect using the image alpha channel (create it if not exist), the to see the effect you should set IEViewer.EnableAlphaChannel to True.

The default shadow color is black. The image is automatically resized.

Add a soft shadow (Gaussian Shadow) to the image. The intensity comes from radius parameter (>0), and the light effect from OffsetX and OffsetY.

AddSoftShadow creates the shadow effect using the image alpha channel (create it if not exist), the to see the effect you should set IEViewer.EnableAlphaChannel to True.

The default shadow color is black.

Add a soft shadow (Gaussian Shadow) to the image. The intensity comes from radius parameter (>0), and the light effect from OffsetX and OffsetY.

AddSoftShadow creates the shadow effect using the image alpha channel (create it if not exist), the to see the effect you should set IEViewer.EnableAlphaChannel to True.

Add a soft shadow (Gaussian Shadow) to the image. The intensity comes from radius parameter (>0), and the light effect from OffsetX and OffsetY.

AddSoftShadow creates the shadow effect using the image alpha channel (create it if not exist), the to see the effect you should set IEViewer.EnableAlphaChannel to True.

Perform level adjustment with midtone.

Note: Null values (causing no change) would be: AdjustLevels( 0, 128, 255, 0, 255 );

Allocate prepares space for an image with Width and Height sizes.

Make sure LegacyBitmap is False before set formats other than 1 bit gray scale or 24 bit RGB.

Set AsyncMode to True to enable asynchronous input/output operations.

When asynchronous mode is enabled, each input/output method creates a new thread that executes the task then the called method returns without waiting for the end of the task.

When AutoAdjustDPI is True (default is False) and last loaded/scannered image has horizontal DPI not equal

to vertical DPI, IEImage resizes the image making DPIX=DPIY.

When true (default) all image processing functions converts automatically the source pixel format to the request one.

For example, Contrast method requires RGB24 pixel format. If your image is black/white or any other format, it is converted automatically to RGB24.

If you set AutoConvertFormat=False and call Contrast with a black/white image, Contrast just will don't work.

AutoCrop2 automatically removes the border using a density analysis algorithm.

This method works only when paper is white and text is black.

This is the first of a group of functions already implemented or that will be implemented in future which help to perform an automatic image adjustment.

AutoImageEnhance1 performs complex operations on the image to simulate how humans see the world to make the image to have better contrast and colors.

This is the first of a group of functions already implemented or that will be implemented in future which help to perform an automatic image adjustment.

AutoImageEnhance1 performs complex operations on the image to simulate how humans see the world to make the image to have better contrast and colors.

Enhances luminosity applying a local adaptation tone mapping algorithm (thanks to Prof. Irwin Scollar).

This is the same of AutoImageEnhance3 with parameter gamma=0.35 and saturation=80.

Specifies the background color.

The background color is the color showed in non used area when the current image is less of control size. This color is used also in geometric processing (as rotation) to fill blank areas.

Sends current image to a target IEImage, after "delay" milliseconds and then each "interval" milliseconds.

This is useful to display captured frames to another control with delay.

You can (but you don't need to do) end frame sending calling IEImage.EndPostFrames.

Multiple calls to BeginPostFrames are possible.

Get/set the alignment in bits of each row. Default is 32, while 8 means no alignment used.

BitAlignment is valid only when Location is Memory and LegacyBitmap is False.

Display the Brush Properties dialog which allows the user to change settings for the brush of the current interaction tool.

CalcImageNumColors returns how much colors has current image.

This doesn't depend on the internal format of image (so a 24 bit images dosen't necessarily has 16 million of colors).

Applies only to document images (images with text) to get document orientation.

Can detect only 0° or 90° orientation. Cannot detect down-up, inverted text.

Useful to adjust a document from portrait to landscape.

Returns true if a call to CopyToClipboard is possible.

Notes:

- The Source specified for CanCopyToClipboard, must be the same as that you will use for CopyToClipboard.

Returns true if a call to CutToClipboard is possible.

Notes:

- The Source specified for CanCutToClipboard, must be the same as that you will use for CutToClipboard.

Returns true if the clipboard contains an image or an IEvolution layer that IEImage can paste.

If dest is Selection then there must also be a valid selection in the associated IEImage.

Notes:

- The Dest you specify for CanPasteFromClipboard, should be the same as the FC>Dest for your call to CanPasteFromClipboard

ClosePDFFile closes the current open Adobe PDF file.

You can create a PDF file using CreatePDFFile then add pages using SaveToPDF and finally close the file using ClosePDFFile.

The resulting PDF file will contain only images, aligned to the upper-left side of the paper.

ClosePSFile closes the currently open PostScript file.

You can create a PostScript file using CreatePSFile then add pages using SaveToPS and finally close the file using ClosePSFile.

The resulting PS file will contain only images, aligned to the upper-left side of the paper.

The method Closing performs a dilation (Maximum filter with WindowSize paramter) followed by an erosion (Minimum filter with WindowSize parameter).

The closing filter operation will reduce small negative oriented regions and negative noise regions.

Colorize sets hue and saturation for all pixels of the image.

It also changes the luminosity using this paramter as a multiplicator to increase or decrease the luminosity.

This function could be used to obtain a sepia effect, using following parameters:

IEViewer1.Image.Colorize(40,50,1.1);

Compares current image with "image" and returns a floating point value from 0 to 1 which specifies the percentage of equality.

1 means that two images are equal.

The algorithm compares only the intensity of the pixels, not the colors.

Compares current image with "image" and returns a floating point value from 0 to 1 which specifies the percentage of equality.

1 means that two images are equal.

The algorithm compares only the intensity of the pixels, not the colors.

This method returns an 8 bit gray scale image which contains the differences.

CopyAlphaImageTo copies current image inside target bitmap, at destX, destY position.

If the image has an alpha channel, CopyAlphaImageTo copies only visible area.

Copies from specified source image converting to current pixel format.

Uses color quantizers when convert from a true color to a paletted.

Creates a new AVI file.

Codec examples:

'DIB ' : no compression

'cvid' : cinepak by Radius

'msvc' : Microsoft Video 1

'mp42' : Microsoft MPEG4 V2

More codecs at http://www.fourcc.org or http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnwmt/html/registeredfourcccodesandwaveformats.asp (or at msdn.microsoft.com searching for registered fourcc codes and wave formats).

You can save each frame to the created AVI file using SaveToAVI method.

Finally call CloseAVIFile to close the file.

Creates a new DIB object from current image.

You have to destroy the DIB using DestroyDIB.

reates a new DIB from specified area of current image.

You have to destroy the DIB using DestroyDIB.

CreatePDFFile creates a new Adobe PDF file using nf path and file name.

You can add pages using SaveToPDF and finally close the file using ClosePDFFile.

The resulting PDF file will contain only images, aligned to the upper-left side of the paper.

CreatePSFile creates a new PostScript file using nf path and file name.

You can add pages using SaveToPS and finally close the file using ClosePSFile.

The PS file will contain only images, aligned to the upper-left side of the paper.

This function decrypts current image (layer), crypted using IEImage.Encrypt.

The algorithm used is TEA Tiny Encryption Algorithm with a key of 128 bits.

Specifies the default value for MinFileSize property.

MinFileSize specifies the minimum memory needed by the image to allow use of memory mapped file.

If the memory needed by the image is less than MinFileSize, the image will be stored in memory (also if the Location is File).

If the global static variable DefaultMinFileSize is not -1, it overlaps the property MinFileSize value.

DisplayContrast specifies a dynamic contrast to apply.

It doesn’t changes the image but only how it is displayed. Allowed values are 0 to 100.

Converts current color image to black/white (1 bit) with a Shen-Castan (ISEF) edge detection algorithm.

Shen-Castan algorithm convolves the image with the Infinite Symmetric Exponential Filter, computes the binary Laplacian image, suppresses false zero crossing, performs adaptive gradient thresholding, and, finally, also applies hysteresis thresholding. (Algorithms for Image Processing and Computer Vision J.R.Parker).

Converts current color image to black/white (1 bit) with a Shen-Castan (ISEF) edge detection algorithm.

Shen-Castan algorithm convolves the image with the Infinite Symmetric Exponential Filter, computes the binary Laplacian image, suppresses false zero crossing, performs adaptive gradient thresholding, and, finally, also applies hysteresis thresholding. (Algorithms for Image Processing and Computer Vision J.R.Parker).

Performs an edge detect using Sobel filter.

The result is a gray scale bitmap: high values (closed to 255) are edges.

When ImageLocation is Drawable, the output pixel format is RGB 24, otherwise it is gray scale 8 bit.

To make result black/white (with 1=edge) it is suggested to call ConvertToBlackWhite(Threshold,-2), that uses Maximum Entropy Algorithm.

IEvolution includes a Color Management System (CMS) which if enabled allows to render the image with the original colors.

To enable the CMS you have to write:

IEImage.EnableCMS = True

Enabling the CMS the loading of images with a color profile will be slow.

IEvolution includes parts of Little cms by Marti Maria.

This function encrypts current image (layer).

The image should be saved using lossless formats and in full rgb color spaces (no palette).

To decrypt use IEImage.Decrypt.

The algorithm used is TEA Tiny Encryption Algorithm with a key of 128 bits.

There is no way to know when an image is crypted, unless you insert special tags (like EXIF or IPTC) manually.

Counts the number of frames (or pages) inside the specified DCX file.

A DCX file contains multiple PCX images.

Displays a modal Windows dialog box for selecting graphics files, used for loading.

This dialog includes a rectangular preview region where all IEvolution supported file formats all displayed.

If the file is a animated GIF, AVI film or a multi page TIFF, all image will be showed in sequence: the "Play" button will be activated to animated the sequence.

The dialog displays image informations as dimensions, colors, dpi, file type, compression and file-memory sizes.

Displays a modal Windows dialog box for selecting graphics files, used for loading.

This dialog includes a rectangular preview region where all IEvolution supported file formats all displayed.

If the file is a animated GIF, AVI film or a multi page TIFF, all image will be showed in sequence: the "Play" button will be activated to animated the sequence.

The dialog displays image informations as dimensions, colors, dpi, file type, compression and file-memory sizes.

Displays a modal Windows dialog box for selecting graphics files, used for loading.

This dialog includes a rectangular preview region where all IEvolution supported file formats all displayed.

If the file is a animated GIF, AVI film or a multi page TIFF, all image will be showed in sequence: the "Play" button will be activated to animated the sequence.

The dialog displays image informations as dimensions, colors, dpi, file type, compression and file-memory sizes.

Displays a modal Windows dialog box for selecting graphics files, used for saving.

This dialog includes a rectangular preview region where all IEvolution supported file formats all displayed.

If the file is a animated GIF, AVI film or a multi page TIFF, all image will be showed in sequence: the "Play" button will be activated to animated the sequence.

The dialog displays image informations as dimensions, colors, dpi, file type, compression and file-memory sizes.

Displays a modal Windows dialog box for selecting graphics files, used for saving.

This dialog includes a rectangular preview region where all IEvolution supported file formats all displayed.

If the file is a animated GIF, AVI film or a multi page TIFF, all image will be showed in sequence: the "Play" button will be activated to animated the sequence.

The dialog displays image informations as dimensions, colors, dpi, file type, compression and file-memory sizes.

ExtractTIFFImageFile extracts the page index (starting at 0) from SourceFileName and saves it to OutFileName.

It doesn’t remove the page from source file; also it doesn’t decompress the image resulting in a very quick process.

Applies a feathering effect to the image. Feathering softens the edges of an image by applying alpha transparency at a rate that is proportional to the distance to the edge (specifically, adding a gradient in the alpha channel).

Note: Method has no effect if the image does not have an alpha channel

FreeRow frees a row obtained using IEImage.GetRow().

Does nothing if IEImage.Location is Memory or Drawable.

GetChannelOffset allows to get an offset for each channel.

At the moment GetChannelOffset works only with ie24RGB pixelformat.

GetDominantColor returns the dominant (most used) color in the image.

"color" will contain the dominant color, and the returned result will contain the percentage of the dominant color.

GetRow gets a pointer to the specified row. Returned pointer is valid until the application calls IEImage.FreeRow().

Just like IEImage.GetScanline if IEImage.Location is Memory or Drawable.

Reads hidden text from a true color image. The text must be saved using HiddenTextWrite.

Hidden information is stored inside the image (uses a pixel color modulation) and is independent of the image file format.

The hidden text will be lost if you save the image with Jpeg or if you subsample the colors.

Writes hidden text in a true color image.

Hidden information is stored inside the image (uses a pixel color modulation) and is independent of the image file format.

The hidden text will be lost if you save the image with Jpeg or if you subsample the colors.

ImportMetafile imports a WMF or EMF vectorial image.

Width and Height are required image sizes (the rectangle where the vectorial image will be painted).

To maintain image ratio set only one size, assigning -1 to the other.

InsertTIFFImageFile inserts the file InsertingFileName in SourceFileName saving all to OutFileName.

It is a fast operation because both sources and destination images are uncompressed.

Insert or append a frame in a DCX file. The file must exist and contains at least one page.

You have to specify the page number in IOParams.DCX_ImageIndex.

Insert or append a frame in a TIFF file. The stream have to contains at least one page.

You have to specify the page number in IOParams.TIFF_ImageIndex.

Insert or append a frame in a TIFF file. The file must exist and contains at least one page.

You have to specify the page number in IOParams.TIFF_ImageIndex.

Changes the value of a pixel by an amount determined by the input Red, Green and Blue channel RGB values individually, or as an averaged value.

The change is graduated starting from LoLimit, with a maximum change applied to the midpoint between LoLimit and HiLimit, then reduced again to HiLimit.

Typically this method can be used to effectively progressively brighten or darken any range of colors as requested without affecting colors outside the range.

RGB values in the range of 0 to 127 are considered as darker, and 128 to 255 as lighter.

Returns True if the size of the image is less than 2 x 2 pixels.

IsEmpty only checks the active bitmap. It does not consider multiple layers.

Compatibility Information: IEvolution v10.0.0 and older worked as IsEmpty was called as IsEmpty(False).

JpegLosslessTransform performs various useful transformations of JPEG files.

JpegLosslessTransform works by rearranging the compressed data, without ever fully decoding the image.

Therefore, its transformations are lossless: there is no image degradation at all.

This function allows to update EXIF thumbnail and orientation.

JpegLosslessTransform performs various useful transformations of JPEG files.

JpegLosslessTransform works by rearranging the compressed data, without ever fully decoding the image.

Therefore, its transformations are lossless: there is no image degradation at all.

Specifies a list of properties that are assigned to all new layers.

The properties are a list of Name=Value pairs, with names from the TIELayer Property Consts.

Notes:

- These properties apply to layers created programmatically (e.g. using LayersAdd) and by the user.

Properties:

'IELP_Width' -> Width

'IELP_Height' -> Height

'IELP_Visible' -> Visible

'IELP_VisibleBox' -> VisibleBox

'IELP_Selectable' -> Selectable

'IELP_Transparency' -> Transparency

'IELP_Opacity' -> Opacity

'IELP_PosX' -> PosX

'IELP_PosY' -> PosY

'IELP_Cropped' -> Cropped

'IELP_Locked' -> Locked

'IELP_Operation' -> Operation

'IELP_Name' -> Name

'IELP_IsMask' -> IsMask

'IELP_DrawOuter' -> DrawOuter

'IELP_AlphaEdgeFeathering,' -> AlphaEdgeFeathering

'IELP_GroupIndex' -> GroupIndex

'IELP_Selected' -> Selected

'IELP_AspectRatioLocked' -> AspectRatioLocked

'IELP_BorderColor' -> BorderColor

'IELP_BorderWidth' -> BorderWidth

'IELP_FillColor' -> FillColor

'IELP_FillColor2' -> FillColor2

'IELP_FillGradient' -> FillGradient

'IELP_Rotate' -> Rotate

'IELP_RotateCenterX' -> RotateCenterX

'IELP_RotateCenterY' -> RotateCenterY

'IELP_SoftShadowEnabled' -> SoftShadow.Enabled

'IELP_SoftShadowRadius' -> SoftShadow.Radius

'IELP_SoftShadowOffsetX' -> SoftShadow.OffsetX

'IELP_SoftShadowOffsetY' -> SoftShadow.OffsetY

'IELP_SoftShadowIntensity' -> SoftShadow.Intensity

'IELP_SoftShadowColor' -> SoftShadow.ShadowColor

'IELP_ImageResampleFilter' -> ResampleFilter

'IELP_ImageUseResampleFilter' -> UseResampleFilter

'IELP_Shape' -> Shape

'IELP_ShapeModifier' -> ShapeModifier

'IELP_LineColor' -> LineColor

'IELP_LineWidth' -> LineWidth

'IELP_LineFillColor' -> FillColor

'IELP_LabelText' -> LabelText

'IELP_LabelAlignment' -> LabelAlignment

'IELP_LabelPosition' -> LabelPosition

'IELP_LineEndShape' -> EndShape

'IELP_LineShapeSize' -> ShapeSize

'IELP_LineStartShape' -> StartShape

'IELP_LineLength' -> LineLength

'IELP_PolylinePoints' -> Points

'IELP_PolylineClosed' -> PolylineClosed

'IELP_FontName' -> Font.Name, LabelFont.Name

'IELP_FontSize' -> Font.Size, LabelFont.Size

'IELP_FontColor' -> Font.Color, LabelFont.Color

'IELP_BorderShape' -> BorderShape, LabelShape

'IELP_Text' -> Text

'IELP_AutoSize' -> AutoSize

'IELP_ReadOnly' -> ReadOnly, ReadOnly

'IELP_TextAlignment' -> Alignment

'IELP_TextLayout' -> Layout

'IELP_AntiAlias' -> AntiAlias

'IELP_SizeToFit' -> Calls either SizeToFit or SizeToText

'IELP_RestoreSize' -> Calls RestoreSize

'IELP_RestoreAspectRatio' -> Calls RestoreAspectRatio(False)

'IELP_RestorePreferredAspectRatio' -> Calls RestoreAspectRatio(True)

Removes all layers.

At the end this method creates a new layer, which will be the background layer. This because at least one layer must exist.

Changes the Kind type of the specified layer to IEImageLayer.

This will change it from a vector-based layer to a standard bitmap layer. Bitmap layers can be edited using standard image modification features, but the quality will be lost if you resize the layer.

Note:

- For text layers, a QualityFactor of 1 usually works best

Copies current layer to alpha channel of specified destination layer.

This is useful to handle alpha channel has other bitmaps, applying the same image processing algorithms.

Look also IEImage.LayersCreateFromAlpha method.

Creates a new layer with the conent of current bitmap alpha channel.

This is useful to handle alpha channel has other bitmaps, applying the same image processing algorithms.

Look also IEImage.LayersCopyToAlpha method.

Creates a new Polyline layer with a closed polyline (polygon) along the edge of the background layer.

The edge is determined by simulating a flood fill starting at the point specified by screenX and screenY (these are points within the control, not points of the bitmap).

Creates a new layer from current selection.

This is useful, for example, to implement typical copy/paste selections.

Resize the background (layer 0) to fit all layers (the image is sized, but its content is not stretched).

Note: The color of added background is specified by Background

LayersCurrent get/set the current layer. The first layer starts at 0, the last is LayersCount-1.

Making a layer current changes the bitmap properties, so it points to the current layer (allowing specification of which layer is active for input/output and image processing operations).

Merges all layers and draws the result to Destination bitmap.

This function should replace a sequence of LayersMerge calls. The destination bitmap will not have transparency channel.

This method removes the transparent border around the bitmap, for all layers.

A transparent border can be caused by multiple rotations.

This method removes the transparent border around the bitmap.

A transparent border can be caused by multiple rotations.

Rotates the bitmap associated to each layer (or the specified layer) to the actual rotation angle.

This method call IEImage.LayersFixSizes for each layer to rotate.

Rotates the bitmap associated to the specified layer to the actual rotation angle.

This method call IEImage.LayersFixSizes for each layer to rotate.

Sets the group index of layers so they selected as a group (selecting one layer of the group will select all of them).

Note: LayersGroup has no effect if multiple layer selection is not enabled

Imports layers from a file or stream in IEV, ALL or DXF format.

Notes: DXF is an Autocad vector format. DXF file can only be imported from file and only lines and ellipses objects are supported.

LayersInsert inserts a new layer in the layers list at the position Position.

The layer becomes the current layer, assumes the size of others and the pixel format of the last layer.

LayersLoad loads all layers included bitmap, position, size, etc.. from a file saved using LayersSave.

It allows IEImage to rebuild a previous saved layers configuration.

All images will be compressed to the specified format, but the file which contains all layers is an ImageEn custom file format.

LayersLoad loads all layers included bitmap, position, size, etc.. from a file saved using LayersSave.

It allows IEImage to rebuild a previous saved layers configuration.

All images will be compressed to the specified format, but the file which contains all layers is an ImageEn custom file format.

LayersMerge merges layer0 and layer1 into one layer. The new layer has the minor index of layer0 and layer1.

LayersMerge makes the new layer looking at Layers[].Transparency and at the bitmap’s alpha channels.

Call LayersMergeAll to merge all layers in one step.

This method is fast and work with all layer options, so you should use it to merge layers before print or save to disk.

Specifies the quality that is used when merging layers.

Has no effect on image layers, if they have a custom UseResampleFilter.

Merges Layer1 and Layer2 into a IEImage object.

The new bitmap will inherit the Layers[].Transparency and alpha channels.

The resulting image will always be 24 bit (RGB24).

Notes:

- If either layer is not a IEImageLayer, it will be converted to a IEImageLayer

- LayersMergeTo can merge a layer with its own layer mask (to create a layer with the transparency of the mask).

- LayersMergeFilter will specify the quality of image layers, if they do not have a custom UseResampleFilter

Returns the coverage area of all or selected layers.

The result will include any layers outside the background layer (if LayersCropped and Cropped are not set).

Notes:

- If layers extend to the left or above the background layer, then resulting IERectangle.X/Y will be less than PosX/Y of Layer 0

- If layers extend to the right or below the background layer, then resulting IERectangle.Width/Height may be greater than the dimensions of IEImage

LayersSave saves all layers included bitmap, position, size, etc.. in a unique file.

It allows IEImage to rebuild a previous saved layers configuration.

All images will be compressed to the specified format, but the file which contains all layers is an ImageEn custom file format.

Note: CompresionFormat cannot be TIFF

LayersSave saves all layers included bitmap, position, size, etc.. in a unique file.

It allows IEImage to rebuild a previous saved layers configuration.

All images will be compressed to the specified format, but the file which contains all layers is an ImageEn custom file format.

Note: CompresionFormat cannot be TIFF

Enables the Selected property of all layers.

Notes:

- Does not select the background layer (layer 0)

- Has no effect if multiple layer selection is not enabled.

Display the Layer Properties dialog for the current layer, which allows the user to modify the style and other settings.

Display the Layer Properties dialog for a layer, which allows the user to modify the style and other settings.

Resets the group index of layers so they are not selected as a group.

Note: LayersGroup has no effect if multiple layer selection is not enabled

If LegacyBitmap is True IEvolution uses a Windows Bitmap object (GDI object) to store the image, otherwise ImageEn uses an internal object.

The internal object handles images using memory mapped file (for large images) or main memory: this allows to handle large images and to include input/output and image processing in a multithreaded environment.

Set this property to True to change the control background color to the image background color (the default is False).

Not all file formats contains background color information.

LoadFromURL loads the image from the network using the http protocol, specifing the URL.

This function doesn’t support password authentication and doesn’t support secure http (https).

URL must have the syntax: 'http://domain[:port]/resource’

It is possible to set proxy parameters using ProxyAddress, ProxyUser and ProxyPassword properties.

Load an image from a file. LoadImage detects file format from extension.

If the file does not represent a recognized image format the property Aborting is True.

Load a known image format from file.

LoadImage detects file format from fileFormat parameter.

If the file does not represent a recognized image format the property Aborting is True.

Load a known image format from file, detecting automatically the image format.

This is useful when you don't know what a file contains (i.e. a test.dat could be a jpeg).

Reads image properties (Params) without load the image (and without changing current image).

LoadImageInfo auto recognizes image type from file header.

If image is unknown the IOParams.FileType has Unknown value.

Reads image properties (Params) without load the image (and without changing current image).

LoadImageInfo auto recognizes image type from file header and file name extension.

If image is unknown the IOParams.FileType has Unknown value.

Set MagicWandMaxFilter to True (default is False) to apply a maximum filter to the magic wand selection (remove black hole).

MagicWandTolerance specifies the color diference of original point and region point (default 15).

MagicWandMode specifies how magic wand selection works. Allowed values:

Inclusive : the selection is a closed polygon (default)

Exclusive : the selection includes only points that mach initial pixel, like a flood-fill

Global : the selection includes all points that mach initial pixel, looking for all pixels in the image.

Set MagicWandMaxFilter to True (default is False) to apply a maximum filter to the magic wand selection (remove black hole).

MagicWandTolerance specifies the color diference of original point and region point (default 15).

MakeSelectionFeather modifies the current selection by applying a blur effect to make borders soft.

This property works only if SelectionMaskDepth is 8.

MakeTile replicates current image for the specified columns and rows numbers.

The final image will be resized by columns*ImageWidth and rows*ImageHeight.

This is useful to create tiled images.

If ColorizeMatched is true then this method colorizes pixels that match the specified HSV (Hue, Saturation and Value) range to MatchColor color.

If ColorizeNonMatched is true, non matching pixels are set to NonMatchColor.

The method Maximum sets each pixel in the output image as the maximum value of all the current image pixel values in the neighborhood of size windowSize.

The maximum filter is typically applied to an image to remove negative outlier noise.

Returns the maximum height of all layers.

The result will include any layers outside the background layer (if LayersCropped and Cropped are not set).

Returns the maximum width of all layers.

The result will include any layers outside the background layer (if LayersCropped and Cropped are not set).

Carry out fast median filtering on images using windows from 3x3 to 19x19 maximum size. MedianFilter works only with true color images.

Filtering can be of three types:

1) substitute median if central point differs from median by a threshold amount

2) high pass sharpening

3) edge extraction

Operation:

Histogram in moving window at beginning of line is initiated. Histogram is updated after each move subtracting left column values from previous window, adding right column values. Median updated by counting up or down number of pixels less than or greater than old median. For color images, the grayscale intensity of a pixel is computed as a weighted linear combination of RGB and counted in the histogram. The pixel with the nearest (L1 norm) color to the average of all pixels in the moving window except the central point is used in place of the median.

The computation of the median for a color image has a complexity of O(N^4), Whereas this technique is only O(N^2) or less and is as good when the window size is 19x19 when the median differs only by a small amount from the mean. For smaller windows performance degrades as the mean differs from the median, but it is still satisfactory down to a 5x5 window.

Adaptive thresholding is used to preserve sharp edges. A pixel is replaced by the median or its nearast average color equivalent if it lies outside the 1st and 3rd quantile of the intensity distribution. The user may modify the position of the quantiles interactively. Defaults are the first and third quartiles. For grayscale images, the quantiles and medians are used directly. The green element of a RGB record is used as an intensity measurement. The user must provide means of detecting whether or not an image is color or grayscale.

Carry out fast median filtering on images using windows from 3x3 to 19x19 maximum size. MedianFilter works only with true color images.

Filtering can be of three types:

1) substitute median if central point differs from median by a threshold amount

2) high pass sharpening

3) edge extraction

Operation:

Histogram in moving window at beginning of line is initiated. Histogram is updated after each move subtracting left column values from previous window, adding right column values. Median updated by counting up or down number of pixels less than or greater than old median.

For color images, the grayscale intensity of a pixel is computed as a weighted linear combination of RGB and counted in the histogram. The pixel with the nearest (L1 norm) color to the average of all pixels in the moving window except the central point is used in place of the median.

The computation of the median for a color image has a complexity of O(N^4), Whereas this technique is only O(N^2) or less and is as good when the window size is 19x19 when the median differs only by a small amount from the mean. For smaller windows performance degrades as the mean differs from the median, but it is still satisfactory down to a 5x5 window.

Adaptive thresholding is used to preserve sharp edges. A pixel is replaced by the median or its nearast average color equivalent if it lies outside the 1st and 3rd quantile of the intensity distribution. The user may modify the position of the quantiles interactively. Defaults are the first and third quartiles. For grayscale images, the quantiles and medians are used directly.

The green element of a RGB record is used as an intensity measurement. The user must provide means of detecting whether or not an image is color or grayscale.

Merges pixels and alpha channel of image with the background.

Supports only 24 bit RGB pixel format.

Specifies the minimum memory needed by the image to allow use of memory mapped file.

If the memory needed by the image is less than MinFileSize, the image will be stored in memory (also if the Location is File).

If the global variable IEDefMinFileSize is not -1, it overlaps the property MinFileSize value.

The method Minimum sets each pixel in the output image as the minimum value of all the current image pixel values in the neighborhood of size WindowSize.

The minimum filter is typically applied to an image to remove positive outlier noise.

Applies contrast to the image by lightening or darkening pixels depending on whether they are above or below a threshold.

The midPoint value determines that threshold, the point at which the Change value influences the pixel value lighter or darker.

When change values are positive, Increasing the Midpoint value darkens the contrast.

When change values are negative, Increasing the Midpoint value lightens the contrast.

Transfers current image, all layers and input/output parameters to destination IEImage object.

This methods doesn't copy images, but just transfer pointers to images buffer.

Source component will be empty, and Destination previous images will be removed.

By setting this property to True, you disable the conversion of paletted images and gray scale to 24 bit.

By default, IEvolution converts all paletted images to 24 bit (true color).

Only black/white images are stored in the original format with 1 bit per pixel.

IEImage.LegacyBitmap must be False.

Note that setting NativePixelFormat=True, you will not be able to execute some image processing operations.

Stretches the pixel values in the range of 0..1.

Works only when PixelFormat is PixelFormat.ie32f.

The method Opening performs an erosion (Minimum filter with WindowSize paramter) followed by a dilation (Maximum filter with WindowSize parameter).

The opening filter operation will reduce small positive oriented regions and positive noise regions.

OpenMediaFile opens a video file using DirectShow which allows you to load AVI, Mpeg, WMV and other DirectShow supported formats.

It opens the file, but doesn’t actually get the image. To get a frame use LoadFromMediaFile method.

To close the media file use CloseMediaFile.

Specifies bitmap origin. Default is bottomleft, that is Windows compatible.

Other libraries could require topleft (like OpenCV).

PaintPenMarker emulates a pen marker over the image (that must be in true color).

PaintPenMarker doesn’t save the previous image into an Undo buffer.

PaintPenMarker emulates a pen marker over the image (that must be in true color).

PaintPenMarker doesn’t save the previous image into an Undo buffer.

Pastes an image or layer from the clipboard.

Notes:

- All uncompressed DIB formats are handled (1, 4, 8, 15, 16, 24 and 32 bits)

- Color images of 4, 8, 15, 16, 24 or 32 bits are converted to 24 bit. Monochrome images (1 bit) will remain 1 bit

Transform an image or the selected area into a pencil-sketch.

This method can be very slow for large images or for particular combination of parameters (like levelSteps and antialiasedLines).

It also requires a lot of memory and can fail processing large images.

Draws source bitmap over current layer, stretching bitmap inside four points.

It is possible to invert the image making, for example, (x0,y0) > (x1,y1).

If alphaMin>-1 and alphaMax>-1 then alpha (transparency) will be set in the specified range. This is useful to compose "cover-flow" like reflection.

Specifies which printer listed in the Printers property is the currently selected printer.

To select the default printer, set the value of PrinterIndex to -1.

Lists all printers installed in Windows.

The value of the PrinterIndex property is the currently selected printer.

PrintImage print current image, specifing margins, vertical position, horizonal position.

The size is setted to normal size (autocalculated from original image DPI).

Call PrintImage inside a PrintBegin() and PrintEnd() block.

PrintImage print current image, specifing margins, vertical position, horizonal position and size.

Call PrintImage inside a PrintBegin() and PrintEnd() block.

PrintImageAt print current image, specifing absolute position and size.

Call PrintImageAt inside a PrintBegin() and PrintEnd() block.

Draws source bitmap over current layer, performing translations, rotations and perspective transform.

This function is the base to build cover-flow like effects.

Draws source bitmap over current layer, performing translations, rotations and perspective transform.

This function is the base to build cover-flow like effects.

Fills selected pixels with random values (Gaussian distribution).

Random values are mutiplied by 255 and truncated to the range 0..255.

Fills selected pixels with random values (Gaussian distribution).

Random values are mutiplied by 255 and truncated to the range 0..255.

RemoveIsolatedPixels removes all groups of PixelCount isolated pixels.

The RemoveIsolatedPixels method works only with black/white images (1bit).

Applies a simple algorithm which helps to remove red eyes.

You can apply this function to the whole image, but it is better to select only the area which contains the eye, otherwise other parts of the image could be changed.

Resample current image. The content of the image changes (stretched to new size).

Resampling black/white (1bit) images with FilterType is not None, Resample converts the image to 24bit

ResampleTo copies a resampled instance of the current image to a Target IEImage.

The content of the destination image changes (stretched to new size).

This function rotates the image by Angle (in degrees) and crops the borders of the original bitmap.

It is useful to deskew an image knowing the rotation angle.

This function rotates the image by Angle (in degrees) and crops the borders of the original bitmap.

It is useful to deskew an image knowing the rotation angle.

Saves the image to the current open AVI file (open using CreateAVIFile).

We suggest to set BitsPerSample and SamplesPerPixel before call SaveToAVI, because AVI requires all images have same color depth.

SaveToPDF saves the current image to an open Adobe PDF file.

You can create a PDF file using CreatePDFFile then add pages using SaveToPDF and finally close the file using ClosePDFFile.

The resulting PDF file will contain only images, aligned to the upper-left side of the paper.

SaveToPS saves the current image to an open PostScript file.

You can create a PostScript file using CreatePSFile then add pages using SaveToPS and finally close the file using ClosePSFile.

The resulting PS file will contain only images, aligned to the upper-left side of the paper.

Sets the scale factor (default 1). In the common representation X:Y (ex. 1:100000) is the Y value (100000).

This value, with DPIX and DPIY (and measure unit MeasureUnit), weight the measurements of areas and line lenghts.

Loads the specified page from the last loaded multipage file, including TIFF, GIF, AVI and other video types.

This method uses IEImage.LoadImage to load the file (hence the file name extension must be provided).

Prompt the user with a dialog to select a Twain, WIA or portable device.

Note: If your location is only [ieTwain] or [ieWIA] then the default Twain/WIA selector is shown. Otherwise a custom device selector is used.

Selects all pixels having the specified color index.

Appliable only to color mapped images.

Sets the selection coordinaties base.

If SelectionBase is ClientArea all coordinates depends from actual Zoom and scrolling.

Otherwise, if SelectionBase is Bitmap (the default) all coordinates refers bitmap pixels.

The SelectionIntensity property allows specifying the selection intensity and it is valid only when SelectionMaskDepth is 8 (8 bit), otherwise this must be 1.

You can assign a value from 0 to 255 which will be applied to the next or current selection.

The SelectionMaskDepth property allows specifying the selection depth in bits.

The default is 1 bit, then a pixel can be "unselected"=0 or "selected"=1.

With setting 8 (8 bit), a pixel can be unselected=0, "semi-selected" from 1 to 254, or fully selected =255.

This allows creating soft selections or feathering selections.

Select a part of the image.

The selected area will be outlined with a white-black animated rectangle if the image is visible inside a IEViewer.

The coordinates refers bitmap pixels.

Select a part of the image.

The selected area will be outlined with a white-black animated rectangle if the image is visible inside a IEViewer.

The coordinates refers bitmap pixels.

Select rounded rectangle of the image.

The selected area will be outlined with a white-black animated rectangle if the image is visible inside a IEViewer.

The coordinates refers bitmap pixels.

SeparateObjects creates a list (IERectList) of IERect rectangles. Each rectangle encloses a found objects.

This method works well to separate photos or simple objects over a white or black background. The background cannot contain a pattern.

SeparateObjects creates a list (IERectList) of IERect rectangles. Each rectangle encloses a found objects.

This method works well to separate photos or simple objects over a white or black background. The background cannot contain a pattern.

SetChannelOffset allows to set an offset for each channel.

At the moment SetChannelOffset works only with ie24RGB pixelformat.

SetNavigator specifies a IEViewer component which works as navigator of current image.

A navigator shows a selection that controls the zoom and scroll of the main control.

SetNavigator specifies a IEViewer component which works as navigator of current image.

A navigator shows a selection that controls the zoom and scroll of the main control.

Adjust ScaleFactor to do 'pixelsCount' pixels corrispond to 'length'.

Useful to set a know length.

SetTransparentColors sets as transparent all pixels inside the MinColor and MaxColor range.

The trasparency value comes from Alpha parameter (0=fully transparent, 255=fully visible).

If you are sure of the RGB value of the transparent colors, just set MinColor and MaxColor to the same value.

If you want all colors from gray (128,128,128) to white (255,255,255) to be transparent, write SetTransparentColors(IERGB(128,128,128),IERGB(255,255,255),0).

Sets all pixels near specified color as transparent

If the SimplifiedParamsDialogs property is True (the default), the "Advanced" button of open/save dialogs will show a simplified set of parameters.

Warning: the default is True, to allow old style "advanced" dialogs set it to False.

SkewDetection estimates the orientation angle (in degrees) of the lines of text.

Apply this method only to images that contains printed text.

SkewDetection can be very slow on large images, so applications can resample analyzed image using ResampleWidth parameter to enhance performance.

No resample is performed when ResampleWidth is zero.

The angle range is 30 for default (from -15 to 15 degrees) and the precision will be 0.1.

SkewDetection estimates the orientation angle (in degrees) of the lines of text.

Apply this method only to images that contains printed text.

SkewDetection can be very slow on large images, so applications can resample analyzed image using ResampleWidth parameter to enhance performance.

No resample is performed when ResampleWidth is zero.

SkewDetectionFine estimates the orientation angle (in degrees) of the lines of text.

Apply this method only to images that contains printed text.

SkewDetectionFine doesn’t use a Hough transform (like SkewDetection), but progressive rotations to find the best orientation.

Stretches pixels value in the range of IEImage.BlackValue and IEImage.WhiteValue.

This method resets BlackValue and WhiteValue to zero.

Works only when PixelFormat is 8 bit gray scale, 16 bit gray scale, 24 bit RGB and 32 bit float point.

Applies a "Symmetric Nearest Neighbour" smoothing filter to the image.

SNN smoothing is very effective at noise reduction, while preserving edges.

When 32RGB (RGBA) pixel format is used, the A channel is not used. Alpha channel is stored in a separated plane (AlphaChannel).

To copy from A channel to Alpha channel you have to call SynchronizeRGBA with RGBAToAlpha=true.

Viceversa to copy from Alpha channel to A channel call SynchronizeRGBA with RGBAToAlpha=false.

TWainAcquireClose closes a connection opened with AcquireOpen. It is useful to do a modeless acquisition.

Whenever IEvolution gets an image the AcquireBitmap event occurs.

TWainAcquireOpen opens a connection to the selected scanner. It is useful to do a modeless acquisition.

Whenever IEvolution gets an image, the AcquireBitmap event occurs.

Use TWainParams property to control scanner acqusition.

You can enable/disable standard user interface, set pixeltype (Grayscale, RGB...), DPI, or select the acquire scanner without user interaction.

UndoLimit specifies how much images can be saved using SaveUndo method. Default is 1.

When you call SaveUndo ImageEn pushes the current image in an image stack.

Calling Undo ImageEn restore last saved image. Calling ClearUndo ImageEn removes last saved image.

This is like Undo but restores only the specified rectangle.

This is useful when you are performing interactive user drawing.