IEImageList handles a list of images.

The images can be stored fully, as thumbnails (a sub-resampled image of the original), or loaded when displayed (you have to specify only the file name), or upon request (whenever an image is to be shown, an event is generated).

It is possible to load/save multipage TIFF, GIF, MPEG, AVI, etc... and export as PDF or PS, or acquire multiple pages from TWain or WIA devices.

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

Syntax

         
 C#  Visual Basic  Visual C++ 
public class IEImageList
Public Class IEImageList
public ref class IEImageList

Members

            
 All Members  Constructors   Properties   Methods  
 Public

 Protected
 Instance

 Static 
 Declared

 Inherited
 XNA Framework Only 

 .NET Compact Framework Only 

 MemberDescription
IEImageList()()()()
Constructor used to standalone version (not linked to IEViewer object)
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 AcquireFromTWain().
AcquireFromTWain()()()()
Performs image acquisition from selected scanner. This is the same of Acquire().
AcquireFromWIA()()()()
Performs image acquisition from WIA scanners.
AcquireParams
AcquireParams is a powerful interface that provides generic access to all image acquistion APIs, Twain, WIA and DCIM Retrieval.
AllowMalformedPages

If true malformed pages (for example loading a corrupted or out of standard TIFF), if possible, will be loaded anyway.

Default is False (stop loading).

AppendImage()()()()
Appends a new image at last position and returns the new image position. AppendImage doesn't create the bitmap.
AppendImage(String)
Append a new image loaded from file at last position and returns the new image position.
AppendImage(IEImage)
Appends a new image cloning the specified one.
AppendImage(Int32, Int32, IEImage..::..PixelFormat)
Appends a new image with specified size and pixelformat at last position and returns the new image position.
AppendSplit(IEImage, Int32, Int32)
Splits source image in cell of specified size and add each cell.
AppendSplit(IEImage, Int32, Int32, Int32)
Splits source image in cell of specified size and add each cell.
AutoAdjustDPI

When AutoAdjustDPI is True and last loaded/scanned image has horizontal DPI not equal to vertical DPI, IEvolution resizes the image making DPIX=DPIY.

The default is False.

Clear()()()()
Clear removes all images.
CopyTo(Int32, IEImage)
Copy an image to the specified IEImage object.
CreateMorphingSequence(IEImage, IEImage, Int32)

This method creates a sequence of frames which are the transformation of the source image to target image. Images pixelFormat must be 24 bit RGB (true color) and have the same size.

Also source and target must contains IEObjectLine objects (the same number) which describe the transformation. You should create line objects in the same order on boths IEImage components.

DeleteImage(Int32)
Deletes Index image. Free bitmap memory.
Dispose()()()()
The destructor
DoFileFormatsPreviews(Int32, IOPages)
Executes file format parameters preview dialog.
DuplicateCompressionInfo()()()()
DuplicateCompressionInfo clones the compression information of page 0 to all pages.
EnableAdjustOrientation
When this property is True all images which have orientation information (like jpeg with EXIF) will be automatically orientated.
EnableLoadEXIFThumbnails
If true (default) when you request to load thumbnails, ImageEn try to load EXIF thumbnails instead of resampled version of the full image.
Equals(Object)
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
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, Boolean)

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

FillFromDirectory(String)

FillFromDirectory automatically loads all known images inside Directory.

Sets FileName property with the image full path and BottomText with the file name.

FillFromDirectory(String, Boolean)

FillFromDirectory automatically loads all known images inside Directory.

Sets FileName property with the image full path and BottomText with the file name.

FillFromDirectory(String, Boolean, Boolean)

FillFromDirectory automatically loads all known images inside Directory.

Sets FileName property with the image full path and BottomText with the file name.

FillFromDirectory(String, Boolean, Boolean, String)

FillFromDirectory automatically loads all known images inside Directory.

Sets FileName property with the image full path and BottomText with the file name.

Finalize()()()()
The destructor
(Overrides Object..::..Finalize()()()().)
GetHashCode()()()()
Serves as a hash function for a particular type.
(Inherited from Object.)
GetImage(Int32)

GetImage creates a IEImage object from the image contained at specified index.

Each changement you make in the bitmap will be visible after you have called Update() method.

You have to call ReleaseImage to free the IEImage object.

GetImageInfo(Int32)
Returns an ImageInfoClass object that contains some thumbnail information
GetImagesOnDemand(String, Boolean)

Open a video file getting each frame on demand, when it needs to be displayed or used.

All DirectShow formats are supported (avi, mpeg, wmv,...).

GetImageToFile(Int32, String)
Saves the specifies frame (image) to file. The file format is given by the name extension.
GetIOParams(Int32)
The GetIOParams return IOParams object that contains the input/ouput file format parameters
GetType()()()()
Gets the Type of the current instance.
(Inherited from Object.)
ImageCacheSize

ImageCacheSize contains how much images are stored in memory instead of memory mapped file.

For example if you know that IEMulti will contain only 20 images the ImageCacheSize should be 20.

The default value is 10.

ImageCacheUseDisk

When true (default) a disk file is used to cache images and view. Otherwise system memory is used.

This is useful if you have low disk space or you don't want ImageEn writes on disk.

Chaning this property has as side effect the call to IEImageList.Clear method.

ImageCount
ImageCount is the number of images stored.
ImageHash(Int32)
Returns the MD5 Hash of image.
InsertImage(Int32)
Inserts a new image in Index position (0 is the first). InsertImage doesn't create the bitmap.
Language
Specifies the language for Input/output previews dialog.
LoadFromFiles(String)
Loads multiple files separated by '|' character. This is the same of LoadFromFiles with autoDetect=false and loadWhenViewed=false.
LoadFromFiles(String, Boolean, Boolean)
Loads multiple files separated by '|' character.
LoadFromURL(String)

LoadFromURL loads a multipage file from the network using the http protocol, specifing the URL.

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

LoadIconOnUnknownFormat Obsolete.

If true, when FileName contains an unknown format IEvolution loads the default file icon (it gets the icon using ShGetFileInfo shellapi function).

If false, a question mark is displayed.

LoadImages(String)

LoadImages loads a multi image from file.

It detects file format from extension.

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

LoadImages(Stream, IEFileFormats)
Loads a multipage TIFF or GIF from a Stream.
LoadImages(String, IEFileFormats)
Loads a supported multipage file, specifying the image format.
LoadImages(String, Boolean)
Loads an image from file. To detect file format it doesn’t look at the file extension, but at the file content.
LoadImages(IntPtr, Int32, IEFileFormats)
Loads an image or a multipage image from the specified buffer.
LoadImagesFromMediaFile(String)

Loads a video using DirectShow. When load AVI format using LoadImages fails, you should try this method.

Also use LoadFromMediaFile to load DirectShow supported files, like wmv, mpeg, avi.

LoadOnlyByFileEx
By default, file types are determined by analyzing the message header. A quicker method is to use the file extension to determine the file type. Though this means that images with incorrect or invalid file extensions will not load.
LoadSnapshot(String)

Loads images, caches, texts and thumbnails size from the specified stream or file, saved using SaveSnapshot.

This is useful to create caching mechanism like Windows .db files, to load quickly an entire directory of images.

LockUpdate()()()()
The LockUpdate method increases the lock counter's value.
LockUpdateCount

Returns lock update state. 0=no lock, >0 locking.

LockUpdate increases LockUpdateCount, UnLockUpdate decreases it.

MemberwiseClone()()()()
Creates a shallow copy of the current Object.
(Inherited from Object.)
MoveImage(Int32, Int32)

Moves image Index to Destintation. MoveImage doesn’t move associated input/output parameters.

If destination index is equal or major of image count the Index image is moved after last image.

MoveSelectedImagesTo(Int32)

Moves selected images before the specified image.

To move images after last image set beforeImage equal to IEImage.ImageCount.

PrepareSpaceFor(Int32, Int32, Int32, Int32)

PrepareSpaceFor allocates enought space on a temporary file for ImageCount images of size Width*Height*BitCount.

Call this method to improve performance only when you plan to add a lot of images of the some size.

PreviewParams
PreviewParams sets/gets the parameters for preview dialogs.
PrinterSetup()()()()
Shows the printer select and setup system dialog
PrintImage(Int32, Double, Double, Double, Double, IEImage..::..PrintVerticalPos, IEImage..::..PrintHorizontalPos, IEImage..::..PrintSize, Double, Double, Double)

PrintImage prints an image, specifing margins, vertical position, horizonal position and size.

Call PrintImage inside a PrintBegin() and PrintEnd() block (static members of IEImage class).

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

PrintImageAt prints an image, specifing absolute position and size.

Call PrintImageAt inside a PrintBegin() and PrintEnd() block (static members of IEImage class).

PrintImages(Int32, Int32)

PrintImages prints all images or only selected images.

You can specify number of columns and rows, spaces between images and margins. It is possible also to draw box around images, shadows and text.

PrintImages(Int32, Int32, Double, Double, Boolean, Double, Double, Double, Double, Boolean, Boolean, Boolean)

PrintImages prints all images or only selected images.

You can specify number of columns and rows, spaces between images and margins. It is possible also to draw box around images, shadows and text.

PrintingFilterOnSubsampling
Specifies a filter when the image needs to be printed and it must be resampled. Filtering enhances the image quality but slows processing.
PrintPreviewDialog()()()()
Executes the multi-page print preview dialog. This function is like PrintPreviewDialog of IEImage, but allows working with multiple pages.
PrintPreviewDialog(String, Boolean)

Executes the multi-page print preview dialog. This function is like PrintPreviewDialog of IEImage, but allows working with multiple pages.

Supports Imaging Annotations.

PrintPreviewDialog(String, Boolean, String)

Executes the multi-page print preview dialog. This function is like PrintPreviewDialog of IEImage, but allows working with multiple pages.

Supports Imaging Annotations.

PrintPreviewParams
Allows to get/set print preview parameters when PrintPreviewDialog is called.
ReleaseImage(IEImage, Int32, Boolean)

ReleaseImage releases the image created with GetImage method.

Applications don't need to call Dispose() for the image object.

ReloadImage(Int32)
This method reloads an image. This works only with on demand image (where you set FileName of ID).
RemoveBlankPages(Double, Boolean, Boolean)
Detects images with a single color (ie a blank page) and remove them.
RemoveCorrupted
If RemoveCorrupted is True ImageEn removes automatically all corrupted images from the grid.
ResampleFilter

ResampleFilter specifies the filter to use when application add a new thumbnail.

This enhances the image quality but could slow down the application.

For default is FastLinear

ResetPrinter
If true each printing operation resets the printer. Useful when you have problems printing IEvolution images.
SaveImages(String)
SaveImages saves a multi image to file. It detects file format from extension.
SaveImages(Stream, IEFileFormats)
Saves a multipage TIFF or GIF to a Stream.
SaveImages(String, Boolean)
SaveImages saves a multi image to file. It detects file format from extension.
SaveImages(String, String)

SaveImages saves a multi image file as AVI, specifing the compression codec.

Codec examples:

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

SaveSnapshot(String)

Saves all images, caches, texts and thumbnails size in the specified stream or file.

This is useful to create caching mechanism like Windows .db files, to load quickly an entire directory of images.

You can reload a saved snapshot using LoadSnapshot.

It is like SaveSnapshot with saveCache=true and compressed=false.

SaveSnapshot(String, Boolean, Boolean)

Saves all images, caches, texts and thumbnails size in the specified stream or file.

This is useful to create caching mechanism like Windows .db files, to load quickly an entire directory of images.

You can reload a saved snapshot using LoadSnapshot.

SaveSnapshot(String, Boolean, Boolean, Boolean)

Saves all images, caches, texts and thumbnails size in the specified stream or file.

This is useful to create caching mechanism like Windows .db files, to load quickly an entire directory of images.

You can reload a saved snapshot using LoadSnapshot.

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.

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.
SetImage(Int32, IEImage)
SetImage sets the image assigned to index. The image is copied internally, therefore you can free image after SetImage.
SetImage(Int32, Stream)
SetImage loads an image from Stream and assign it to index
SetImage(Int32, String)
SetImage loads an image and assign it to index
SetImage(Int32, IEImage, Boolean)
SetImage sets the image assigned to index. The image is copied internally, therefore you can free image after SetImage.
SetImage(Int32, String, Int32)
SetImage loads an image and assign it to index, specifying the index of source multipage file.
SetImage(Int32, Int32, Int32, IEImage..::..PixelFormat)
Creates an empty images at the specified position.
SetImage(Int32, IEImage, Int32, Int32, Int32, Int32)

SetImage sets the image assigned to index.

The rectangle x1,y1,x2,y2 of image is copied internally. After SetImage you can free the image.

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.

ThreadPoolSize
ThreadPoolSize specifies how many threads can be created to load images. If it is 0 all images are loaded in the main thread.
ToString()()()()
Returns a string that represents the current object.
(Inherited from Object.)
TWainAcquireClose()()()()

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

Whenever ImageEn 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 ImageEn 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.

UnLockUpdate()()()()

Use the UnLockUpdate method to decrease the lock counter's value locked using LockUpdate.

If the lock count is zero, then the Update method is called.

UpdateImages()()()()
Updates display.

Inheritance Hierarchy

System..::..Object
  HiComponents.IEvolution..::..IEImageList

See Also