SourceContentReuseModeEnum

SourceContentReuseModeEnum in the ABBYY FineReader Engine API — Modes for reusing source PDF and Office document contents during processing (Office documents not supported on macOS).

SourceContentReuseModeEnum enumeration constants describe available modes for reusing source PDF file and Office document contents.

Office documents are not supported for macOS.

typedef enum {
 CRM_Auto,
 CRM_DoNotReuse,
 CRM_ContentOnly,
 CRM_ContentAndPictures
} SourceContentReuseModeEnum;

Elements

Name	Description
CRM\_Auto	ABBYY FineReader Engine automatically selects the appropriate mode for processing PDF files or Office documents. If the result of this mode’s work does not meet the expectations or document type and the corresponding mode of reusing are known in advance, then the mode may be selected manually.
CRM\_ContentAndPictures	ABBYY FineReader Engine automatically selects the mode of using the text and the images for the parts of every page of the source PDF file or Office document. It means that both the source file contents and rasterized images are used for processing. If the text from the source file is considered to be good, then it is used; otherwise, the text from the raster of this part is used.
CRM\_ContentOnly	ABBYY FineReader Engine uses both text and images of the source PDF file or Office document. Using the text contents of the source file will speed up processing, but if you choose this mode and there is no text layer, an error will occur. We recommend using this mode for the source file with the visible text, which is encoded using Unicode, ASCII, or another character encoding standard and has the correct settings of fonts and sizes. If your source file is of another type, use CRM\_Auto, CRM\_ContentAndPictures, or CRM\_DoNotReuse. This mode is not available when processing the documents in parallel (MultiProcessingParams::MultiProcessingMode = MPM\_Parallel) in memory.
CRM\_DoNotReuse	ABBYY FineReader Engine rasterizes the pages of the source PDF file or Office document and processes them. The contents of the source file are ignored.

Use the IsPdfWithTextualContent method to find out if the file contains a text layer.

Remarks

Recognition of document contents is performed along with the process of determining the type of word model (see IWord::ModelType). This process depends on the selected mode of contents reusing:

• CRM_DoNotReuse — a type of word model is always determined.
• CRM_Auto, CRM_ContentAndPictures — determination of a type of word model depends on the use of document contents recognition.
• CRM_ContentOnly — a type of word model is never determined.

Used in

IObjectsExtractionParams::SourceContentReuseMode