IEImage object is the main container for bitmaps.

It allows the application to load and save single images (BMP,PCX,TIFF,JPEG...), performs image processing, acquires image from scanner.

IEImage can store images in memory mapped files (for big images), in memory (fast access) or can encapsulate DIB objects (for Graphics drawing and compatibility).

When IEImage is created at runtime with "new" statement, it should be manually disposed calling Dispose() method. For example:

CopyC#
IEImage myImage = new IEImage();
...do something with myImage...
myImage.Dispose();  // this is required

Namespace: HiComponents.IEvolution
Assembly: IEvolution2 (in IEvolution2.dll) Version: 10.0.0.0

Syntax

         
 C#  Visual Basic  Visual C++ 
public class IEImage : IDisposable
Public Class IEImage _
	Implements IDisposable
public ref class IEImage : IDisposable

Members

               
 All Members  Constructors   Fields   Properties   Methods  
 Public

 Protected
 Instance

 Static 
 Declared

 Inherited
 XNA Framework Only 

 .NET Compact Framework Only 

 MemberDescription
IEImage()()()()
Constructor for standalone version (not encapsulated in IEViewer)
IEImage(String)
Creates a new IEImage object from specified file.
IEImage(IEImage)
Creates a new IEImage cloning specified image.
IEImage(Int32, Int32, IEImage..::..PixelFormat)
Creates a new IEImage from specified size and pixel format.
Aborting

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.

Acquire()()()()
Performs image acquisition from selected scanner. This is the same of AcquireFromWIA().
AcquireFromTWain()()()()
Performs image acquisition from TWain scanners.
AcquireFromWIA()()()()
Performs image acquisition from WIA scanners. This is the same of Acquire().
AcquireParams
AcquireParams is a powerful interface that provides generic access to all image acquistion APIs, Twain, WIA and DCIM Retrieval.
AddExtIOPlugin(String)
Adds an external library (dll) which contains a file format plugin. The dll must be compatible with IEvolution/ImageEn specifications.
AddInnerShadow(Double, Int32, Int32, IERGB)
Add inner shadow (Gaussian Shadow) to the image. The intensity comes from radius parameter (>0), and the light effect from offsetX and offsetY.
AddSelectionBreak()()()()
AddSelectionBreak breaks current selection to begin a new selection.
AddSelectionPoint(Int32, Int32)

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.

AddSoftShadow(Double, Int32, Int32)

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.

AddSoftShadow(Double, Int32, Int32, Boolean)

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.

AddSoftShadow(Double, Int32, Int32, Boolean, IERGB)

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.

AddSoftShadow(Double, Int32, Int32, Boolean, IERGB, Int32)

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.

AdjustBrightnessContrastSaturation(Int32, Int32, Int32)
This method adjust brightness, contrast and color saturation in one step.
AdjustGainOffset()()()()
Adjust image luminosity calculating the min and max pixels values and stretching colors to the maximum allowed value.
AdjustLevels(Int32, Int32, Int32, Int32, Int32)

Perform level adjustment with midtone.

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

AdjustLumSatHistogram(Double, Double)
Adjusts Saturation, Luminance and the histogram.
AdjustSaturation(Int32)
AdjustSaturation adjusts color saturation.
AdjustTemperature(Int32)
Adjust image temperature.
AdjustTint(Int32)
AdjustTint adjusts color tint.
Allocate(Int32, Int32, IEImage..::..PixelFormat)

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.

Annotations
Returns the IEAnnotations object. It contains all vectorial objects.
ApplyFilter(IEImage..::..PresetFilter)
Applies a preset filter to the current image.
ApplyImageToSelection(IEImage, Boolean, Boolean, Boolean)
Applies an image to the selected region, stretching the image to the selection size.
AssignRect(IEImage, Int32, Int32, Int32, Int32)
Copies a rectangle from source image.
AsyncMode

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.

AsyncRunning
AsyncRunning returns how many threads are running.
AutoAdjustDPI

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.

AutoCalcBlackWhiteValues()()()()
Set automatically BlackValue and WhiteValue properties to view correctly the image.
AutoConvertFormat

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.

AutoCrop(Int32, IERGB, Boolean)
AutoCrop removes the border with color like Background from the image borders.
AutoCrop2(Double, Boolean)

AutoCrop2 automatically removes the border using a density analysis algorithm.

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

AutoEqualizeHistogram()()()()
Equalizes colors histogram of the current selection.
AutoImageEnhance1()()()()

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.

AutoImageEnhance1(Int32, Int32, Int32, Int32)

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.

AutoImageEnhance2()()()()
AutoImageEnhance2 performs complex operations on the image to simulate how humans see the world to make the image to have better contrast and colors.
AutoImageEnhance2(Int32, Int32, Double, Int32, Boolean)
AutoImageEnhance2 performs complex operations on the image to simulate how humans see the world to make the image to have better contrast and colors.
AutoImageEnhance3()()()()

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.

AutoImageEnhance3(Double, Int32)
Enhance luminosity applying a local adaptation tone mapping algorithm (thanks to Prof. Irwin Scollar).
AutoSharp()()()()
AutoSharp enhances image sharpness, increasing the sharping of detected objects contours.
AutoSharp(Int32, Double)
AutoSharp enhances image sharpness, increasing the sharping of detected objects contours.
AutoUndo
If True all image processing and load operations automatically call SaveUndo method.
BackColor

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.

BeginPostFrames(IEImage, Int32, Int32)

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.

BitAlignment

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.

BlackValue
The initial black value. Used with WhiteValue to display only a range of gray scales.
Blank()()()()
Blank frees memory allocated for current image.
Blur(Double)
Performs a Gaussian Blur filter with specified radius (>0).
CalcAverageRGB(Int32)
Returns the average RGB values of the selection.
CalcImageColorCount()()()()

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).

CalcJpegFileQuality(String)
This function estimates the quality of a Jpeg file. The returned value can be used with the IOParams.JPEG_Quality property.
CalcOrientation()()()()

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.

CanCopyToClipboard(IEImage..::..IECopyPasteType)

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.

CanCutToClipboard(IEImage..::..IECopyPasteType)

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.

CanPasteFromClipboard(IEImage..::..IECopyPasteType, Boolean)

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

CanRedo
CanRedo is True when the Redo buffer contains an image.
CaptureFromScreen(IEImage..::..CaptureSource)
CaptureFromScreen captures current desktop or active window
CastAlpha(Int32, Int32, Int32, Int32)
Performs a flood-fill starting at x,y coordinates. newAlpha is the transparent value used to fill the area.
CastColor(Int32, Int32, IERGB, Int32)
Performs a flood-fill starting at specified coordinates.
CastColorRange(IERGB, IERGB, IERGB)
Use this method to force all colors included in the range BeginColor and EndColor to be equal to CastColor.
ChangeResolution(Int32, IEResampleFilter)
ChangeResolution changes the DPI of the image, resamping it and setting new DPI values.
ChromaKeyOptions
Options for selection of images making use of a Chroma-Key background (e.g. green screen). A ChromaKey image contains a solid color block that is removed so that it can be applied to a background. E.g. in the following image the key color is neon green (R=0/G=254/B=0).
Clear()()()()
Clear fills current image with Background color.
ClearAll()()()()
Removes all content from the control, by removing all layers (with LayersClear) and resetting the background image (with Blank).
ClearAllRedo()()()()
Clear the Redo list
ClearAllUndo()()()()
Clear the Undo list
ClearRedo()()()()
Remove last saved image from Redo list
ClearSelection()()()()
ClearSelection fills selected region with current background color.
ClearUndo()()()()
Remove last saved image from Undo list
CloseAVIFile()()()()
CloseAVIFile closes the AVI file open with OpenAVIFile.
CloseMediaFile()()()()
CloseMediaFile closes a video file open with OpenMediaFile.
ClosePDFFile()()()()

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()()()()

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.

Closing(Int32)

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(Int32, Int32, Double)

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);

Compare(IEImage)

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.

Compare(IEImage, IEImage)

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.

CompareHistogramWith(IEImage, IEImage..::..IECmpMode, Boolean)
Compares histograms of current image with another image.
ConvertTo(IEImage..::..PixelFormat, IEImage..::..PaletteType, IEImage..::..DitherAlgorithm, Boolean)
Changes image pixel format using a combination of palette type and dithering algorithm when necessary.
ConvertTo(IEImage..::..PixelFormat, array<IERGB>[]()[][], IEImage..::..DitherAlgorithm, Boolean)
Changes image pixel format using a combination of palette colors and dithering algorithm when necessary.
ConvertToBlackWhite(IEImage..::..DitherType)
Converts a true color image (24 bit) to black/white (1 bit)
ConvertToBlackWhite(IEImage..::..DitherType, Int32)
Converts a true color image (24 bit) to black/white (1 bit)
ConvertToBlackWhite_localThreshold()()()()
Converts a true color image (24 bit) to black/white (1 bit) using local threshold algorithms (use mean algorithm).
ConvertToBlackWhite_localThreshold(Int32, IEThreshMode, Int32)
Converts a true color image (24 bit) to black/white (1 bit) using local threshold algorithms (mean, median, min/max mean).
ConvertToGray()()()()
Converts current selection to gray levels.
ConvertToTrueColor()()()()
Converts a black/white (pf1bit) image to true color (pf24bit).
ConvExtensionToFileFormat(String)
Converts a file extension ('gif','jpeg',etc) to IEFileFormats value.
Convolve(array<Double>[]()[][], Int32, Int32, Double)
Convolves the specified kernel over the selected region.
CopyAlphaImageTo(IEImage, Int32, Int32)

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

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

CopyAndConvertFormat(IEImage)

Copies from specified source image converting to current pixel format.

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

CopyFromDIB(IntPtr)
Copies the specified DIB to the current image
CopyFromImage(Image)
Gets the image from a System.Drawing.Image object
CopyFromMemory(IntPtr, Int32, Int32, IEImage..::..PixelFormat, IEImage..::..BitmapOrigin, Int32)
Copies an image from memory buffer.
CopyImageTo(IEImage)
Copy the bitmap to another IEImage object
CopyRect(IEImage, Int32, Int32, Int32, Int32, Int32, Int32, Boolean)
Copy the specified rectangle to a destination IEImage object.
CopySelectedImageTo(IEImage)
Copy current selection to the specified image.
CopyToClipboard(IEImage..::..IECopyPasteType)
Copies current selection (or the whole image) to the clipboard.
CreateAVIFile(String)
Creates a new AVI file with no compression and a rate of 25 frames per second.
CreateAVIFile(String, Double, String)

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.

CreateBitmap()()()()
Creates an .Net Bitmap (System.Drawing.Bitmap) object from current IEImage
CreateDIB()()()()

Creates a new DIB object from current image.

You have to destroy the DIB using DestroyDIB.

CreateDIB(Int32, Int32, Int32, Int32)

reates a new DIB from specified area of current image.

You have to destroy the DIB using DestroyDIB.

CreatePDFFile(String)

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(String)

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.

Crop(Int32, Int32, Int32, Int32)
Crop gets as current image the specified rectangle, cutting off the remaining image.
Crop(Int32, Int32, Int32, Int32, Double, AntialiasMode)
Rotate and replace the current image with that within the specified rectangle (i.e. keep only the specified region).
Crop(Double, Double, Double, Double, Double, Double, Double, Double)
Crops to the specified quadrilateral and applies forward perspective mapping. Useful to adjust perspective distortion.
CropSelection()()()()
CropSelection cuts selected region and copy as current image, without use clipboard.
CurrentLayer
Gets access to the current layer info.
CutToClipboard(IEImage..::..IECopyPasteType, Boolean)
Copies the selected region, image or layer to the clipboard and then removes it.
CutTransparentBorder()()()()
Removes transparent border, resizing the resulting image to the visible rectangle.
Decrypt(String, IEImage..::..EncryptAlgorithm)

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

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

DefaultMinFileSize

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.

Deinterlace(DeinterlaceMode)
Deinterlaces current image with the specified algorithm.
DeleteDCXFrame(String, Int32)
Remove a page/frame from specified file.
DeleteGIFFrame(String, Int32)
Remove a frame from a GIF.
DeleteTIFFPage(String, Int32)
Remove a page from a TIFF.
DestroyDIB(IntPtr)
Destroys the specified DIB created with CreateDIB.
DisplayContrast

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.

Dispose()()()()
The destructor
DisposeChannels(String)
This method changes the channels order from BGR (default) to the specified one.
DoFileFormatsPreviews(IOPages)
Executes file format parameters preview dialog.
DoImageProcessingPreviews(IEImage..::..ImProcPages)
Executes image processing preview dialog.
DoImageProcessingPreviews(IEImage..::..ImProcPages, Boolean, Int32, Int32)
Executes image processing preview dialog. Allows to specify form size.
DpiX
Specified the horizontal DPI of the viewed image. This is not synchronized with the source image Dpi.
DpiY
Specified the vertical DPI of the viewed image. This is not synchronized with the source image Dpi.
EdgeDetect_ShenCastan()()()()

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).

EdgeDetect_ShenCastan(Double, Double, Int32, Int32, Boolean)

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).

EdgeDetect_Sobel()()()()

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.

EnableCMS

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.

Encrypt(String, IEImage..::..EncryptAlgorithm)

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.

EndPostFrames(IEImage)
Stops to send current image to target IEImage. Use IEImage.BeginPostFrames to begin frame sending.
EndSelect()()()()
EndSelect terminates a selection specified by code using AddSelectionPoint and AddSelectionBreak methods.
EnumDCXFrames(String)

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

A DCX file contains multiple PCX images.

EnumGIFFrames(String)
Returns the number of frames (images) that a GIF file contains.
EnumICOPages(String)
Returns the number of pages (images) that a ICO file contains.
EnumTIFFPages(String)
Returns the number of pages (images) that a TIFF file contains.
Equals(Object)
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
ExecuteOpenDialog()()()()

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.

ExecuteOpenDialog(String, String, Boolean, Int32)

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.

ExecuteOpenDialog(String, String, Boolean, Int32, String, String, String)

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.

ExecuteSaveDialog()()()()
ExecuteSaveDialog(String, String, Boolean, Int32)

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.

ExecuteSaveDialog(String, String, Boolean, Int32, String, String, String)

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(String, String, Int32)

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.

FeatherAlphaEdges(Int32)

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

FileFormatRemove(Int32)
Removes an internal or external (dll) file format.
FileFormatRemove(IEFileFormats)
Removes an internal file format. For example it is useful when you want replace internal RAW with dcrawlib.dll, you should call FileFormatRemove(IEFileFormats.RAW).
Fill(Color)
Fill sets all colors of the selected area with specified color.
Fill(Int32)
Fill sets all colors of the selected area with specified color. Works only with black/white images
Fill(IERGB)
Fill sets all colors of the selected area with specified color. For black/white images FillColor can be only (0,0,0) for black and (255,255,255) for white.
Finalize()()()()
The destructor
(Overrides Object..::..Finalize()()()().)
FindFileFormat(Stream)
FindFileFormat reads the stream and try to recognize the image format from image header.
FindFileFormat(String, IEImage..::..FindFormatMethod)
Returns the file format of the specified file by reading the file and trying to recognize the file header. Some formats cannot be detected by content alone. Sony ARW and Kodak DCR are TIFF internally so will return as TIFF. WBMP and Implicit Dicom will return as ioUnknown.
FindFileFormat(String, Boolean)
FindFileFormat reads the file and try to recognize file format from file header.
Flip(IEImage..::..FlipDir)
Flips the current image to horizontal or vertical.
Format
Get/Set pixel format of the bitmap
FreeRow(Int32)

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

Does nothing if IEImage.Location is Memory or Drawable.

FTClearZone(Int32, Int32, Int32, Int32, Boolean)
Performs the same task of FFT dialog (see also IEImage.DoImageProcessingPreviews()).
Full
Full is true all pixels are 1 (or white).
GammaCorrect(Double)
GammaCorrect performs a gamma correction.
GammaCorrect(Double, Boolean, Boolean, Boolean)
GammaCorrect performs a gamma correction to the specified channels.
GetAlpha(Int32, Int32)
Get alpha value
GetBitmapAlphaHandle()()()()
Returns the HBITMAP handle of current layer alpha channel.
GetBitmapHandle()()()()
Returns the HBITMAP handle of current layer.
GetChannelOffset(Int32)

GetChannelOffset allows to get an offset for each channel.

At the moment GetChannelOffset works only with ie24RGB pixelformat.

GetDominantColor(IERGB%)

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.

GetFileFramesCount(String)
This is a generic way to get number of frames in a multipage file (GIF,TIFF,AVI,MPEG...) or a single page (JPEG,...).
GetGraphics()()()()
Returns a Graphics object to allow GDI+ drawing
GetHash(IEImage..::..HashAlgorithm)
Calculates the hash (using the specified hash algorithm) of the bitmap.
GetHashCode()()()()
Serves as a hash function for a particular type.
(Inherited from Object.)
GetLayer(Int32)
GetLayer returns a IELayer object which allows you to control the specified layer properties, as position, transparency, etc.
GetNetAlphaImage()()()()
Creates a .Net Image object from current layer alpha channel.
GetNetImage()()()()
Creates a .Net Image object from current layer.
GetPaletteItem(Int32)
If the image has a palette, GetPaletteItem allows to get palette colors.
GetPixel(Int32, Int32, IECMYK%)
Gets pixel value for CMYK images.
GetPixel(Int32, Int32, IERGB48%)
Gets pixel value for RGB 48 bit images.
GetPixel(Int32, Int32, IERGBA%)
Get pixel value for color images
GetPixel(Int32, Int32, Byte%)
Get pixel value for 8 bit paletted (256 colors) or 8 bit gray scale (256 gray levels) images
GetPixel(Int32, Int32, Int32%)
Get pixel value for black/white images
GetPixel(Int32, Int32, Single%)
Gets pixel value for 32 bit float point images
GetPixel(Int32, Int32, UInt16%)
Get pixel value for 16 bit gray scale (65536 gray levels) images
GetRedoCaption(Int32)
For each item in the Redo stack, IEvolution will include a relevant description of the function that has occured. This is useful to display a list of the available redo changes to the user.
GetRow(Int32)

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.

GetScanline(Int32)
Provides indexed access to each line of pixels.
GetType()()()()
Gets the Type of the current instance.
(Inherited from Object.)
GetUndoCaption(Int32)
For each item in the Undo stack, ImageEn will include a relevant description of the function that has occured. This is useful to display a list of the available undo changes to the user.
GuessChromaKeyColor()()()()
Analyzes a ChromaKey image to guess its key color (by examining nine areas of the image and using the one with the least hue variance). If a selection is active it only analyzes the selection.
GuessChromaKeyColor(Double%)
Analyzes a ChromaKey image to guess its key color (by examining nine areas of the image and using the one with the least hue variance). If a selection is active it only analyzes the selection. This overload will return a level of Tolerance that would remove all the background color from the selection. If this is used without a selection it is likely to return a level that is too low (a default tolerance of 0.21 is usually better).
HasAlphaChannel
Returns true if current image has the alpha channel.
Height
Get/Set the bitmap height
HiddenTextClear()()()()
This method removes the text added using HiddenTextWrite.
HiddenTextDataSpace()()()()
Returns the available hidden space inside the current image (in bytes).
HiddenTextRead()()()()

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.

HiddenTextWrite(String)

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.

IELayer_Pos_Bottom
IELayer_Pos_Bottom
IELayer_Pos_HCenter
IELayer_Pos_HCenter
IELayer_Pos_Left
IELayer_Pos_Left
IELayer_Pos_Right
IELayer_Pos_Right
IELayer_Pos_Top
IELayer_Pos_Top
IELayer_Pos_VCenter
IELayer_Pos_VCenter
ImageLocation
Specifies where the image is located (memory, file or Windows object)
ImportMetaFile(String, Int32, Int32, Boolean, IERGB, Boolean)

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.

InjectJpegEXIF(String)
InjectJpegEXIF replaces EXIF information of the nf Jpeg file with EXIF current in memory without loading or modifying the original image.
InjectJpegIPTC(String)
InjectJpegIPTC replaces IPTC information of a Jpeg file with IPTC currently in memory without load or modify original image.
InjectTIFFEXIF(String, Int32)
InjectTIFFEXIF replaces EXIF meta-tags of fileName with EXIF currently in memory without loading or modifying the original image. InjectTIFFEXIF works only with TIFF and Microsoft HDPhoto file formats.
InjectTIFFEXIF(String, String, Int32)
InjectTIFFEXIF replaces EXIF meta-tags of InputStream with EXIF currently in memory without loading or modifying the original image. InjectTIFFEXIF works only with TIFF and Microsoft HDPhoto file formats. The method returns false if it fails.
InsertTIFFImageFile(String, String, String, Int32)

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

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

InsertToDCX(String)

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.

InsertToTIFF(Stream)

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.

InsertToTIFF(String)

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.

Intensity(Int32, Int32, Int32, Boolean, Boolean, Boolean, Boolean)

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.

InvertSelection()()()()
InvertSelection inverts current selection.
IOParams
The IOParams object contains the input/ouput file format parameters
IPDialogParams
Allows to get/set image processing dialog parameters.
IsAnimatedGIF(String)
Returns True if the GIF image has the animated flag setted ("NETSCAPE2.0" string). If the file doesn't exists or the image hasn't the flag setted returns False.
isBlank()()()()
Return true if the image is empty or contains only one color (e.g. all white or all black).
IsClipboardAvailable()()()()
Check if clipboard contains valid image data for IEvolution.
IsEmpty()()()()
IsEmpty returns True if the image is empty.
IsKnownFileFormat(String)
Test a file name to know if it is supported format
IsPointInsideSelection(Int32, Int32)
IsPointInsideSelection returns true if the point specified with x,y is inside current selection.
JpegLosslessTransform(String, String, IEImage..::..JpegTransform, Boolean)

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(String, String, IEImage..::..JpegTransform, Boolean, IEImage..::..JpegCopyMarkers, Rectangle)

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.

Language
Specifies the language for Input/output previews dialog and image processing previews dialog.
LayerDefaults

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)

LayersAdd(IEImage)
Appends a new layer and creates a copy of specified image.
LayersAdd(IELayerKind)
LayersAdd appends a new layer in the layers list. The layer becomes the current layer, assumes the size of others and the pixel format of the last layer.
LayersAdd(Int32, Int32, IEImage..::..PixelFormat)
Appends a new layer and creates a bitmap of specified width, height and pixel format.
LayersAdd(String, Int32, Int32)
Appends a new layer and creates a bitmap from specified file.
LayersAdd(IEShape, Int32, Int32, Int32, Int32)
Appends a new IEShapeLayer layer to the layers list. The new layer will become the current layer.
LayersAdd(String, Int32, IERGB, String, Int32, Int32)
Appends a new IETextLayer layer to the layers list. The new layer will become the current layer.
LayersAlign(IEImage..::..IEAlignLayers, Int32)
Aligns all selected layers relative to the image or other layers.
LayersAutoUndo
Allows auto undo for layers modifications made by user actions like moving and resizing.
LayersClear()()()()

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.

LayersConvertToImageLayers(Int32, Double, Boolean, Boolean)

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

LayersCopyToAlpha(Int32)

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.

LayersCount
LayersCount returns the number of layers.
LayersCreateFromAlpha()()()()

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.

LayersCreateFromClipboard()()()()
Creates a new layer with the content of clipboard.
LayersCreateFromEdge(Int32, Int32, Int32, Boolean)

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).

LayersCreateFromFile(String)
Loads an image from a file and adds it as a new image layer.
LayersCreateFromSelection()()()()

Creates a new layer from current selection.

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

LayersCropBackground(Boolean, Int32, Boolean, Boolean)

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

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).

LayersDeselectAll()()()()
Sets the Selected property of all layers to false.
LayersDrawTo(IEImage)

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.

LayersFixBorders()()()()

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

A transparent border can be caused by multiple rotations.

LayersFixBorders(Int32)

This method removes the transparent border around the bitmap.

A transparent border can be caused by multiple rotations.

LayersFixRotations()()()()

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.

LayersFixRotations(Int32)

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

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

LayersFixSizes()()()()
Resizes the bitmap associated to each layer to the actual layer size.
LayersFixSizes(Int32)
Resizes the bitmap associated to specified layer to the actual layer size.
LayersGroup(Boolean)

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

LayersImport(String, IEFileFormats, Boolean)

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(Int32, IEImage)
Inserts a new image layer into the layers list at the specified position. The new layer will become the current layer.
LayersInsert(Int32, IELayerKind)

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.

LayersInsert(Int32, String, Int32, Int32)
Inserts a new image layer into the layers list at the specified position. The new layer will become the current layer.
LayersInsert(Int32, IEShape, Int32, Int32, Int32, Int32)
Inserts a new shape layer into the layers list at the specified position. The new layer will become the current layer.
LayersInsert(Int32, Int32, Int32, IEImage..::..PixelFormat, Int32, Int32)
Inserts a new image layer into the layers list at the specified position. The new layer will become the current layer.
LayersInsert(Int32, String, Int32, IERGB, String, Int32, Int32)
Inserts a new text layer into the layers list at the specified position. The new layer will become the current layer.
LayersLoad(Stream)

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(String)

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()()()()
Merge all selected layers
LayersMerge(array<Int32>[]()[][])
Merge specified layers
LayersMerge(Int32, Int32, Boolean)

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.

LayersMergeAll(Boolean)

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.

LayersMergeFilter

Specifies the quality that is used when merging layers.

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

LayersMergeTo(Int32, Int32, IEImage)

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

LayersMove(Int32, Int32)
LayersMove moves curIndex layer to the position specified in newIndex.
LayersRect(Boolean, Boolean)

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

LayersRemove(Int32)
LayersRemove removes the specified layer and frees the related bitmap. At the least one layer must be present.
LayersRepositionAll(Int32, Int32, Boolean, Boolean)
Updates PosX and PosY of all layers (or just selected if selectedOnly = True) to move them to a new position.
LayersRotateAll(Double, Boolean, Boolean)
Rotates all layers (or just selected if selectedOnly = True) by the specified angle (negative or positive degrees counter-clockwise). This method updates Rotate.
LayersRotationFilter
Specifies the rotation filter to use when layers rotation has finished and stabilizied.
LayersSave(Stream, IEFileFormats)

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(String, IEFileFormats)

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

LayersSelCount(Boolean)
If multiple layer selection is enabled then it counts any layer that has Selected set to true. Otherwise it just checks whether LayersCurrent is not -1.
LayersSelectAll(Boolean)

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.

LayersSync
Deprecated
LayersUngroup(Boolean)

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

LegacyBitmap

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.

LoadChangesBackgroundColor

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.

LoadFromAVI(Int32)
LoadFromAVI read the FrameIndex frame from the AVI open with OpenAVIFrame method.
LoadFromMediaFile(Int32)
LoadFromMediaFile loads the specified frame from a media file open using OpenMediaFile.
LoadFromURL(String)

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.

LoadImage(Stream)
Loads an image from a stream discovering the image format. Cannot be used in asynchronous mode.
LoadImage(String)

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.

LoadImage(Stream, IEFileFormats)
Loads an image from a stream. Cannot be used in asynchronous mode.
LoadImage(String, IEFileFormats)

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.

LoadImage(String, Boolean)

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).

LoadImage(IntPtr, Int32, IEFileFormats)
Loads an image from the specified buffer.
LoadImage(String, String, String, IEFileFormats)
Loads the specified image resource from PE files like EXE, DLL, OCX, ICL, BPL, etc..
LoadImageInfo(Stream)

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.

LoadImageInfo(String)

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.

LoadImageInfo(Stream, IEFileFormats)
Fills IOParams reading an image from stream, but doesn't load the image in the component.
LoadImageInfo(String, IEFileFormats)
Fills IOParams reading an image from file, but doesn't load the image in the component.
LoadImageInfo(IntPtr, Int32, IEFileFormats)
Loads an image parameters (but not the actual image) from the specified buffer.
LockUpdate()()()()
LockUpdate disables all calls to the Update method. LockUpdate and UnLockUpdate are useful when resampling multiple layers.
LZWSupport
Enable LZW support for GIF and TIFF.
MagicWandMaxFilter

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

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.

MagicWandTolerance

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(Double)

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

This property works only if SelectionMaskDepth is 8.

MakeTile(Int32, Int32)

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.

MatchHSVRange(Int32, Int32, Int32, Int32, Int32, Int32)
Calculates number of pixels matching the specified HSV range.
MatchHSVRange(Int32, Int32, Int32, Int32, Int32, Int32, IERGB)
If ColorizeMatched is true then this method colorizes pixels that match the specified HSV (Hue, Saturation and Value) range to MatchColor color.
MatchHSVRange(Int32, Int32, Int32, Int32, Int32, Int32, IERGB, IERGB)

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.

MaxImageEMFSize
Specifies the maximum width or height of imported EMF/WMF image.
Maximum(Int32)

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.

MaxLayerHeight

Returns the maximum height of all layers.

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

MaxLayerWidth

Returns the maximum width of all layers.

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

MedianFilter()()()()

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.

MedianFilter(Int32, Int32, Int32, Int32, Int32, Int32, IEImage..::..MedianOperationType)

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.

MemberwiseClone()()()()
Creates a shallow copy of the current Object.
(Inherited from Object.)
MergeMetaFile(String, Int32, Int32, Int32, Int32)
MergeMetaFile loads a metafile and draw it at the specified position.
MergeWithAlpha(IEImage, Int32, Int32, Int32, Int32, Int32, IEResampleFilter, RenderOperation)

Merges pixels and alpha channel of image with the background.

Supports only 24 bit RGB pixel format.

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 variable IEDefMinFileSize is not -1, it overlaps the property MinFileSize value.

Minimum(Int32)

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.

ModifyContrast(Double)
Changes contrast of current selection.
ModifyContrast2(Double)
This is another contrast adjustment function.
ModifyContrast3(Int32, Int32, Boolean, Boolean, Boolean)

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.

ModifyHSL(Int32, Int32, Int32)
Changes Hue, Saturation and Luminosity of the current selection.
ModifyHSV(Int32, Int32, Int32)
Changes Hue, Saturation and Value of the current selection.
ModifyIntensity(Int32, Int32, Int32)
Change the RGB channels of the current image (or of the current selection).
MotionBlur(Double)
Applies motion blur effect.
MotionBlur(Double, Int32, Int32)
Applies motion blur effect.
MoveContentTo(IEImage)

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.

MoveRect(Int32, Int32, Int32, Int32, Int32, Int32)
Moves a rectangle inside the current image.
MoveRect(Int32, Int32, Int32, Int32, Int32, Int32, IERGB, Int32)
Moves a rectangle inside the current image.
MoveSelection(Int32, Int32)
MoveSelection moves current selection by the specified horizontal and vertical offsets.
NativePixelFormat

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.

Negative()()()()
Negative method inverts all color of the current selection.
Normalize()()()()

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

Works only when PixelFormat is PixelFormat.ie32f.

OpenAVIFile(String)
OpenAVIFile open an AVI file, without read frames.
Opening(Int32)

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(String)

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.

OptimizeGIF(String, String)
This method optimizes a GIF animations (or multipage) discovering differences among frames and saving in the new GIF only the differences.
Origin

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

Other libraries could require topleft (like OpenCV).

PaintMark(Int32, IERGB)
PaintMark paints a pixel of Color every Frequency pixels, over the selected area.
PaintPenMarker(Int32, Int32)

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(Int32, Int32, Int32, IERGB, IERGB, Int32)

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.

PaletteLength
Returns the items count of palette (usually 256).
PaletteUsed
Get/set the number of used colors of palette.
PasteFromClipboard(Boolean)
PasteFromClipboard gets the current image in the clipboard
PasteFromClipboard(Int32, Int32)
PasteFromClipboard gets the current image in the clipboard
PasteFromClipboard(IEImage..::..IECopyPasteType, Boolean, Boolean, Boolean)

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

PencilSketch(Boolean, Int32, Int32, Int32, Double, Double, Double, Double, Double, Double, Boolean)

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.

PerspectiveDraw(IEImage, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

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.

Pixelize(Double)
Pixelize filter renders the selected area using large color blocks. It is very similar to the effect seen on television when obscuring faces.
PreviewFont
If PreviewFontEnabled is set to True then PreviewFont specifies the font used in the DoImageProcessingPreviews dialog. Ensure the size of the font matches the length of labels.
PreviewFontEnabled
If you set PreviewFontEnabled to True then you can use PreviewFont to specify a custom font for the DoImageProcessingPreviews dialogs.
PreviewParams
Specifies the previews options.
PreviewsLog
Returns a log of operations performed in the Image Processing Dialog (DoImageProcessingPreviews).
PrintAbort()()()()
Inside a PrintBegin() and PrintEnd() block, aborts the printing.
PrintBegin()()()()
Begins the printing preparation.
PrintCopies
Specifies the number of copies to print.
PrintDlgMeasureUnit
DialogsMeasureUnit specifies the measure unit used in print preview dialog.
PrintEnd()()()()
Ends the printing preparation. Start the printing.
PrinterIndex

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.

Printers(Int32)

Lists all printers installed in Windows.

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

PrinterSetup()()()()
Shows the printer select and setup system dialog
PrintersGetCount
Returns the number of items in Printers method.
PrintImage(Double, Double, Double, Double, IEImage..::..PrintVerticalPos, IEImage..::..PrintHorizontalPos, Double)

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(Double, Double, Double, Double, IEImage..::..PrintVerticalPos, IEImage..::..PrintHorizontalPos, IEImage..::..PrintSize, Double, Double, Double)

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

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

PrintImageAt(Double, Double, Double, Double, Double)

PrintImageAt print current image, specifing absolute position and size.

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

PrintingFilterOnSubsampling
Specifies a filter when the image needs to be printed and it must be resampled. Filtering enhances the image quality but slows processing.
PrintNewPage()()()()
Inside a PrintBegin() and PrintEnd() block, starts a new page.
PrintOrientation
Indicates the orientation of pages when printing.
PrintPreviewDialog(IEImage..::..PrintDialogs)
PrintPreviewDialog shows the print preview dialog.
PrintPreviewDialog(IEImage..::..PrintDialogs, String, Boolean)
PrintPreviewDialog shows the print preview dialog. Supports Imaging Annotations.
PrintPreviewDialog(IEImage..::..PrintDialogs, String, Boolean, String)
PrintPreviewDialog shows the print preview dialog. Supports Imaging Annotations.
PrintPreviewParams
Allows to get/set print preview parameters when PrintPreviewDialog is called.
PrintTitle(String)
Determines the text that is listed in the Print Manager and on network header pages.
ProjectDraw(IEImage, Int32, Int32, Double, Double, Int32, Int32, Double, Double, Int32, Int32)

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

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

ProjectDraw(IEImage, Int32, Int32, Int32, Int32, Double, Int32, Int32, Double, Double, Int32, Int32)

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

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

ProxyAddress
ProxyAddress specifies the proxy address and port when using LoadFromURL method. The syntax is: ‘domain:port’.
ProxyPassword
ProxyPassword specifies the proxy password when using LoadFromURL method.
ProxyUser
ProxyUser specifies the proxy userid when using LoadFromURL method.
RadialStretch(Double, Double, Double, Double, Double, Double, Double, Double, Double, Double, Double, Double)
This functions performs a radial stretch for each color component (R,G,B). This allows manual correction of Barrel Distortion and Pincushion distortion (lens distortion, underwater distortion).
Random()()()()

Fills selected pixels with random values (Gaussian distribution).

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

Random(Double, Double)

Fills selected pixels with random values (Gaussian distribution).

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

Redo(Boolean)
Copy last Redo image to current one
RedoCount
RedoCount returns the image count in Redo stack
ReduceColor(Int32, IEImage..::..DitherMethod)
ConvertTo reduces number of colors.
Reflection(Int32, Int32)
Extends image vertically to simulate a reflection (like reflection of "cover flow" presentations).
Reflection(Int32, Int32, Int32)
Extends image vertically to simulate a reflection (like reflection of "cover flow" presentations).
RemoveAlphaChannel()()()()
This removes alpha channel and the memory allocated for it. RemoveAlphaChannel sets HasAlphaChannel to false.
RemoveAlphaChannel(Boolean)
This removes alpha channel and the memory allocated for it. RemoveAlphaChannel sets HasAlphaChannel to false.
RemoveChromaKey(IERGB, Double, Int32, Int32, Int32, Boolean)
ChromaKey is the removal of a background for a source image so it can be replaced by an alternative image. RemoveChromaKey removes the KeyColor of an image and sets it to transparent. Although KeyColor is a single color, RemoveChromaKey will remove a range of colors that are similar to cope with light variance in photography.
RemoveChromaKey(Int32, Int32, Double, Int32, Int32, Int32, Boolean)
ChromaKey is the removal of a background for a source image so it can be replaced by an alternative image. RemoveChromaKey removes the KeyColor of an image and sets it to transparent. Although KeyColor is a single color, RemoveChromaKey will remove a range of colors that are similar to cope with light variance in photography.
RemoveIsolatedPixels()()()()
Removes all groups of 2 white pixels.
RemoveIsolatedPixels(Int32, Int32)

RemoveIsolatedPixels removes all groups of PixelCount isolated pixels.

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

RemoveNoise()()()()
RemoveNoise removes noise pixels using the Kfill algorithm. The RemoveNoise method works only with black/white images (1bit).
RemoveNoise(Int32, Boolean)
RemoveNoise removes noise pixels using the Kfill algorithm. The RemoveNoise method works only with black/white images (1bit).
RemoveRedEyes()()()()

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.

Render(IEImage, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, IEResampleFilter, RenderOperation, Double)
Render the bitmap to a destination image. The destination image must have the right size and must have ie24RGB pixelformat.
RenderToGraphics(Graphics, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, IEResampleFilter, RenderOperation)
Draws the specified source rectangle inside the destination rectangle of Graphics object.
ReplaceTIFF(String)
This function saves current image replacing to the specified multi-page TIFF file, replacing only the image at index specified with IOParams.TIFF_ImageIndex.
Resample(Int32, Int32, IEResampleFilter, Boolean)

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(IEImage, Int32, Int32, IEResampleFilter)

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

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

Resize(Int32, Int32)
Resizes current image. The content of the image doesn't change (no stretch).
Resize(Int32, Int32, HorizAlign, VertAlign)
This method resizes the current image to newWidth and newHeight. The content of the image doesn't change (no stretch).
Resize(Int32, Int32, HorizAlign, VertAlign, Int32)
This method resizes the current image to newWidth and newHeight. The content of the image doesn't change (no stretch).
Rotate(Double, Boolean)
Rotates current image
Rotate(Double, Boolean, AntialiasMode)
Rotates current image
Rotate(Double, Boolean, AntialiasMode, IERGB)
Rotates current image.
RotateAndCrop(Double)

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.

RotateAndCrop(Double, Boolean, AntialiasMode)

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.

RotateAndCrop(Double, AntialiasMode, Double, CropAlgorithm)
Rotates the image by the specified angle and crops the borders of the original bitmap. It is useful to deskew an image if you know the rotation angle.
RoundImage(Int32, Int32)
Makes corners rounded.
RowLen()()()()
Gets the count of bytes in a row. For default a row is double word aligned (32bit).
SaveAsText(String, IEFileFormats, IETextFileFormat)
Saves current image in the specified text format.
SaveImage(Stream, IEFileFormats)
Saves an image to a stream. Cannot be used in asynchronous mode.
SaveImage(String, IEFileFormats)
Saves the current image to a file. SaveImage detects file format from extension.
SaveRedo()()()()
Add current image to Redo list
SaveRedo(UndoSource)
Add the specified object (image, selection or vectorial object) to redo stack.
SaveToAVI()()()()

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()()()()

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()()()()

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.

SaveUndo()()()()
Add current image to Undo list
SaveUndo(UndoSource)
Add the specified object (image, selection or vectorial object) to undo stack.
ScaleFactor

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.

Seek(IEImage..::..IESeekDestination, String)

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).

SelectAcquireSource(Boolean, Boolean, Boolean)

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.

SelectChromaKey(IEImage..::..SelOp)
Uses a ChromaKey algorithm to select all pixels of a particular hue. A ChromaKey image contains a solid color block that is removed so that it can be applied to a background. SelectChromaKey uses the options in ChromaKeyOptions.
SelectChromaKey(Int32, Int32, IEImage..::..SelOp)
Uses a ChromaKey algorithm to select all pixels of a particular hue. A ChromaKey image contains a solid color block that is removed so that it can be applied to a background.
SelectColors(Int32, IEImage..::..SelOp)

Selects all pixels having the specified color index.

Appliable only to color mapped images.

SelectColors(IERGB, IEImage..::..SelOp)
Selects all pixels having the specified color.
SelectColors(IERGB, IERGB, IEImage..::..SelOp)
Selects all pixels having the specified color range.
SelectedBoundingBox
Returns the bounding box of the selected area
SelectEllipse(Int32, Int32, Int32, Int32, IEImage..::..SelOp)
SelectEllipse makes an elliptical selection, centered at CenterX and CenterY, and with size specified by Width and Height.
SelectionBase

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.

SelectionIntensity

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.

SelectionMaskDepth

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.

SelectMagicWand(Int32, Int32, IEImage..::..SelOp)
Select an irregular region that has similiar colors.
SelectNonAlpha(IEImage..::..SelOp)
Selects all pixels based on the alpha channel. Pixels of Alpha value 0 will be unselected, 255 will be selected, and 1 - 254 partially selected.
SelectRectangle(Rectangle, IEImage..::..SelOp)

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.

SelectRectangle(Int32, Int32, Int32, Int32, IEImage..::..SelOp)

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.

SelectRoundRectangle(Int32, Int32, Int32, Int32, Int32, Int32, IEImage..::..SelOp)

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.

SelectTWainSource()()()()
Shows a dialog where the user can select the TWain scanner device.
SelectWIASource()()()()
Shows a dialog where the user can select the WIA scanner device.
SelPasteFromClipboard()()()()
This method pastes the contents of the Clipboard inside the selected area. The image will be stretched to the selection size.
SeparateObjects(Int32, Boolean)

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(Int32, Boolean, IERGB, IERGB)

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.

SetAlpha(Int32, Int32, Int32)
Set alpha value
SetAlphaRangePixelsColor(Int32, Int32, IERGB)
SetAlphaRangePixelsColor sets all pixels that have an alpha channel value between alphaMin and alphaMax to the specified color.
SetChannelOffset(Int32, Int32)

SetChannelOffset allows to set an offset for each channel.

At the moment SetChannelOffset works only with ie24RGB pixelformat.

SetNavigator(IEViewer)

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(IEViewer, NavigatorOptions)

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.

SetPaletteItem(Int32, IERGB)
If the image has a palette, SetPaletteItem allows to set palette colors.
SetPixel(Int32, Int32, IECMYK)
Sets pixel value for CMYK images.
SetPixel(Int32, Int32, IERGB48)
Sets pixel value for RGB 48 bit images.
SetPixel(Int32, Int32, IERGBA)
Set pixel value for color images
SetPixel(Int32, Int32, Byte)
Set pixel value for 8 bit paletted (256 colors) or 8 bit gray scale (256 gray levels) images
SetPixel(Int32, Int32, Int32)
Set pixel value for black/white images
SetPixel(Int32, Int32, Single)
Set pixel value for 32 bit float point images
SetPixel(Int32, Int32, UInt16)
Set pixel value for 16 bit gray scale (65536 gray levels) images
SetScaleFromPixels(Int32, Double)

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

Useful to set a know length.

SetScaleFromSelectionLen(Double)
Adjust ScaleFactor to do current selection corrispond to 'length'
SetSelectedAreaAlpha(Int32)
SetSelectedAreaAlpha sets specified Alpha (alpha channel, transparency) value for all pixels inside current selection.
SetSelectedPixelsColor(IERGB)
SetSelectedPixelsColor sets selected pixels to the specified color.
SetTransparentColors(IERGB, IERGB, Int32)

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).

SetTransparentColors(IERGB, Int32, Int32)

Sets all pixels near specified color as transparent

Sharpen(Int32)
Performs a sharpening filter on the image with neighbourhood=4.
Sharpen(Int32, Int32)
Performs a sharpening filter on the image.
ShiftChannel(Int32, Int32, Int32, Int32)
ShiftChannel moves the specified channel by an offset filling blank position with a color.
SimplifiedParamsDialogs

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()()()()

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(Int32, Int32, Double, Boolean)

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(Double, Double, Int32, Boolean)

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.

StretchValues()()()()

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.

SymmetricNearestNeighbour(Int32)

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

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

SyncFull()()()()
SyncFull sets IEImage.Full to True if all values of the image are 255.
SynchronizeRGBA(Boolean)

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.

ThreadsCount
Returns the count of currently active threads. Valid only if AsyncMode is True.
Threshold(IERGB, IERGB, IERGB, IERGB)
The Threshold method assigns the DownVal color to all colors smaller or equal to DownLimit, and UpVal to all colors greater than UpLimit.
Threshold2(Int32, Int32, Boolean, Boolean, Boolean)
This is a variant of original Threshold algorithm.
ToString()()()()
Returns a string with image information
(Overrides Object..::..ToString()()()().)
TWainAcquireClose()()()()

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()()()()

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.

TWainParams

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.

Undo()()()()
Copy last Undo image to current one
Undo(Boolean)
Copy last Undo image to current one
UndoCount
UndoCount returns the image count in Undo stack
UndoLimit

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.

UndoRect(Int32, Int32, Int32, Int32)

This is like Undo but restores only the specified rectangle.

This is useful when you are performing interactive user drawing.

UnlockUpdate()()()()
UnLockUpdate re-Enables all calls to the Update method, after a call to LockUpdate. LockUpdate and UnLockUpdate are useful when you need to resample multiple layers.
UnsharpMask(Int32, Double, Double)
Substracts the image to its gaussian blurred version.
UseCMYKProfile
When true IEvolution uses an internal ICC profile to convert from CMYK to RGB and viceversa.
WaitThreads(Boolean)
WaitThreads waits until all threads complete when IEImage is in async mode.
WallisFilter()()()()
WallisFilter works only with true color images.
WallisFilter(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Boolean)
WallisFilter works only with true color images.
WhiteBalance(Double, Double, Double)
This method applies specified coefficients to each pixel of the image. Coefficients (Red, Green, Blue) are values in the range 0 to 1.
WhiteBalanceAutoWhite()()()()
Adjust image colors adjusting the white range. This method is like WhiteBalanceWhiteAt, but try to find the white automatically.
WhiteBalanceGrayWorld()()()()
Adjust image colors applying the white balance algorithm named Gray World.
WhiteBalanceWhiteAt(Int32, Int32)
Adjust image colors adjusting the white range.
WhiteValue
The final white value. Used with BlackValue to display only a range of gray scales.
Width
Get/Set the bitmap width

Inheritance Hierarchy

System..::..Object
  HiComponents.IEvolution..::..IEImage

See Also