Skip to main content
This object contains different attributes specifying how an image will be prepared during conversion to the internal format. All properties of a newly created object of this type are set to reasonable defaults. To know about the default value of this or that property, see its description. The sequence of the transformations upon the prepared image is the following: first the rotation is performed, and then the image is mirrored. The PrepareImageMode 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

NameTypeDescription
ApplicationEngine, read-onlyReturns the Engine object.
CompressImageModeCompressImageModeEnumSpecifies if the image should be compressed during conversion to the internal format. Applies only to color and gray images, black and white images are always compressed with lossless compression. By default, this property is set to CIM\_Auto, which currently means that born-digital images (eg. obtained from PDF files) will use lossless, while others images use max compression.
DocumentTypeDocumentTypeEnumSpecifies the type of the document on the image. If you know the document type for certain, you can set this property to bypass the document classifier and save time. By default, this property is DT\_Auto, which means that FineReader Engine should run the document classifier to determine document type.
ImageSourceTypeImageSourceTypeEnumSpecifies the image origin. For example, a photo and a screenshot with some text will need different preprocessing techniques. By default, this property is IST\_Auto, which means that FineReader Engine should detect the image origin automatically.
OfficeConversionSettings <Note> Linux and Windows only. </Note>OfficeConversionSettings, read-onlyProvides access to the settings for importing digital documents using the same methods that open the images.
RasterizeFreeText <Note> This property is not supported in ABBYY FineReader Engine 12 for macOS . </Note>VARIANT\_BOOLSpecifies whether Free Text annotations from the input PDF document should be retained. By default, this property is set to TRUE. <Warning> In Linux , before using this property, make sure the Arial or Liberation Sans font is available on your workstation. </Warning>

Methods

NameDescription
CopyFromInitializes properties of the current object with values of similar properties of another object.
LoadFromFileRestores the object contents from a file on disk.
LoadFromMemory <Note> : Windows only. </Note>Restores the object contents from the global memory.
SaveToFileSaves the object contents into a file on disk.
SaveToMemory <Note> : Windows only. </Note>Saves the object contents into the global memory.

Linux and Windows

PrepareImageMode Object Diagram

Output parameter

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

Input parameter

This object is passed as an input parameter to the following methods:

Samples

The object is used in the following code samples:

See also

Working with Images Working with Properties