- To improve recognition quality:
- Crop image
- Enhance local contrast
- Correct orientation (use the Transform method with necessary parameters)
- Invert or mirror image (use the Transform method with necessary parameters)
- Correct skew
- Split double page spread (use the SplitPages method of the FRDocument object)
- Remove geometrical distortions
- Remove garbage
- Remove noise
- Remove motion blur
- Suppress color objects
- Remove color objects
- To improve image appearance:
- Equalize brightness and make the background white
- Smooth image texture
- Dither image
- In Linux and macOS: advise the object to the ImageDocument object by calling the AdviseFREngineObject global function.
- In Windows: set up the connection between the object and the events source implemented in the ImageDocument object by standard COM means.
Properties
Name | Type | Description |
|---|---|---|
Application | Returns the Engine object. | |
Main attributes | ||
Provides access to the black-and-white image plane of the current ImageDocument object. | ||
Provides access to the color image plane of the current ImageDocument object. | ||
Provides access to the gray image plane of the current ImageDocument object. | ||
Id | int, read-only | Stores the ID of the image document. |
ImageColorTypeEnum, read-only | Each color plane of the image document is characterized by its own color type. This property specifies the color type for the whole image document as the maximum of the corresponding values for its color planes (black-and-white, gray, color). | |
VARIANT_BOOL, read-only | Specifies if the image document is stored in memory only or it is also represented as a folder on disk. After the call to the SaveTo method the value of this property is not changed. You need to re-load the image document by the call to the LoadImageDoc method. | |
BSTR, read-only | Stores the path to the folder with object’s internal representation on disk. The property contains an empty string, if the value of the IsInMemory property is TRUE. After the call to the SaveTo method the value of this property is not changed. You need to re-load the image document by the call to the LoadImageDoc method. | |
Returns the CoordinatesConverter object that contains information about pixel coordinates in the current modification state. This property is useful whenever you need to convert coordinates between two states during image processing. | ||
Image modification | ||
VARIANT_BOOL, read-only | Specifies if any modifications were made upon the ImageDocument object since it was loaded in memory or from the last call of the SaveModified method. | |
RotationTypeEnum, read-only | Specifies rotation that was performed upon the image since opening. | |
VARIANT_BOOL, read-only | This property set to TRUE specifies that the image colors were inverted since opening. | |
VARIANT_BOOL, read-only | This property set to TRUE specifies that the image was mirrored around the vertical axis since opening. | |
IsSkewCorrected | VARIANT_BOOL, read-only | This property provides information about whether the image skew was fully corrected during opening, preprocessing or the CorrectSkew method call. The tangent of skew angle which was corrected is stored in the SkewAngle property. |
SkewAngle | double, read-only | Stores the tangent of skew angle that was detected for the image and corrected during opening, preprocessing or the CorrectSkew method call. If the skew angle is negative the image is rotated clockwise; if the angle is positive the image is rotated counter-clockwise. The image can be rotated around any point. The size of the deskewed image is always larger than the size of the original image. When you perform further modifications of the image, this property value is reset to 0. Save the value of corrected skew angle, if you need it, before calling any other methods to edit the image. |
Source file information | ||
VARIANT_BOOL, read-only | Tells you if the ImageDocument object was created from a file which contains text. For example, PDF files can have text layer. | |
VARIANT_BOOL, read-only | Tells you if the ImageDocument object was created from a file which is a photo. | |
ImageFileFormatEnum, read-only | Provides information about format of the source image file of the current ImageDocument object. If this information is not available or image was received from scanner, the value of this property is IFF_UnknownFormat. | |
SourceImageScannerInfo | BSTR, read-only | Provides information about scanner used to acquire the image. If information about source image parameters is not available or image was received from file, the value of this property is empty string. |
SourceImageScanThreshold | int, read-only | Provides information about scanning intensity threshold for the current ImageDocument object. If information about source image parameters is not available or image was obtained from file, the value of this property is -1. |
SourceImageXResolution | int, read-only | Provides information about horizontal resolution of the source image of the current ImageDocument object. If information about source image parameters is not available, the value of this property is 0. |
SourceImageYResolution | int, read-only | Provides information about vertical resolution of the source image of the current ImageDocument object. If information about source image parameters is not available, the value of this property is 0. |
Methods
| Name | Description |
|---|---|
| ApplySigmaFilter | This method applies a noise reducing filter to the image. It is mostly useful for photographs. |
| ChangeResolution | Changes resolution of the image. |
| CorrectShadowsAndHighlights | Corrects excessive shadows and highlighting on the image. |
| CorrectSkew | Corrects the image skew. |
| CropImage | Finds the edges of a document on the image and then crops the image. |
| DitherImage | Dithers the image using either Floyd–Steinberg, or Bayer (ordered) dithering algorithm. |
| EnhanceLocalContrast | Increases the local contrast of the image. |
| EqualizeBrightness | Equalizes the image brightness. This method can be used for gray and color images only. |
| FindBlackSquares | Finds black squares on the image. |
| GetPreviewImage | Provides access to the 94 \* 60 preview image plane of the current ImageDocument object. If the preview of this size has not been created yet, it will be created during this call, which will take some time. |
| GetPreviewImageSpecificSize | Provides access to the preview image plane of the current ImageDocument object and lets you specify the size. If the preview of this size has not been created yet, it will be created during this call, which may take some time. |
| GetTextBackgroundColor | Detects colors of text and background in the specified rectangle on image. |
| Modify | Allows you to modify the image. This method provides advanced modifications as compared with the Transform method. |
| RemoveColorObjects | Removes specified color objects from the whole image or its parts. This method can be used for color images only. |
| RemoveColorObjectsEx | Removes all color objects of the specified hues from the image and replaces them with the specified color. The removed objects can be saved into a separate image. |
| RemoveGarbage | Removes garbage (excess dots that are smaller than a certain size) from the image. |
| RemoveGeometricalDistortions | Removes the geometrical distortions of the image (such as curving lines near the edge of a page). |
| RemoveMotionBlur | Removes motion blur from the image. |
| RemoveNoise | Reduces the noise on the image. |
| SaveImageRegionTo | Saves the parts of the image into a folder on disk. The saved image is in ABBYY FineReader Engine internal format. |
| SaveModified | Saves all modifications that were performed upon the current ImageDocument object into the folder on disk. |
| SaveTo | Saves the contents of the ImageDocument object into a folder on disk. The image is saved in ABBYY FineReader Engine internal format. |
| SaveToFile | Saves the contents of the ImageDocument object into a file. |
| SaveToMemory <Note> Windows only. </Note> | Saves the contents of the ImageDocument object into the global memory. |
| SmoothImage | Allows you to smooth the image. This method can be used for gray and color images only. |
| SmoothTexture | Smoothes the image using a nonlinear filter. Useful for images with texture. This method can be used only for gray and color images which measure no less than 3 pixels in each dimension. |
| Transform | Applies a limited set of transformations to the image. |
Related objects
Object Diagram
Output parameter
This object is the output parameter of the following methods LoadImageDocFromFile, LoadImageDocFromMemory (Windows only), LoadImageDoc, OpenBitmap, OpenDib, OpenBitmapBits, OpenImageFileFromMemory of the Engine object.Input parameter
This object is passed as an input parameter to the following methods:- AddImageDocument method of the FRDocument object
- SetImageData method of the TrainingImage object