ImageProcessingParams Object (IImageProcessingParams Interface)

ImageProcessingParams object (IImageProcessingParams interface) in the ABBYY FineReader Engine API — Specifies how an image will be preprocessed before analysis and recognition; supports rotation and mirroring; persistent object savable to file/memory.

This object specifies how an image will be preprocessed before analysis and recognition. Most types of blocks have child objects of the ImageProcessingParams type that are available through the corresponding properties. Image processing parameters should be set for each block that is to be recognized, if any non-trivial image preprocessing upon that block is needed.

The ImageProcessingParams object may specify image rotation and its mirroring around the vertical axis. Rotation is the first operation in sequence of geometrical transformation, and mirroring is the second one. All properties of a newly created object of this type are set to reasonable defaults. To get info on the default value of this or that property see its description.

The ImageProcessingParams object is a persistent object. This means that the object’s current state can be written to persistent storage. Later, the object can be re-created by reading the object’s state from the persistent storage. The following methods provide persistence of the object:

Linux: SaveToFile, and LoadFromFile

Windows: SaveToFile, LoadFromFile, SaveToMemory, and LoadFromMemory.

Properties

Name	Type	Description
Application	Engine, read-only	Returns the Engine object.
InvertImage	VARIANT_BOOL	Specifies if the image colors in the block are inverted. If this property is TRUE, ABBYY FineReader Engine will invert the image of a block before recognition. This property is FALSE by default.
MirrorImage	VARIANT_BOOL	Specifies if the image in the block is mirrored around the vertical axis. If this property is TRUE, ABBYY FineReader Engine will mirror the image of a block before recognition. This property is FALSE by default.
RotationType	RotationTypeEnum	Specifies the orientation of a text in a block relative to the normal reading position. This property cannot be set to RT_UnknownRotation. This property is RT_NoRotation by default, which means that the orientation is normal.

Methods

Name	Description
CopyFrom	Initializes properties of the current object with values of similar properties of another object.
LoadFromFile	Restores the object contents from a file on disk.
LoadFromMemory	Restores the object contents from the global memory. Windows only.
SaveToFile	Saves the object contents into a file on disk.
SaveToMemory	Saves the object contents into the global memory. Windows only.

Related objects

Object Diagram

Output parameter

This object is the output parameter of the CreateImageProcessingParams method of the Engine object.

See also

BarcodeBlock

TextBlock

CheckmarkBlock

Tuning Parameters of Preprocessing, Analysis, Recognition, and Synthesis

Working with Properties