Chinese Simplified (简体中文)
Preprocess Method of the FRDocument Object
This method performs preprocessing of all pages in the document: corrects page orientation, inversion, geometrical distortions, performs page splitting if necessary. Preprocessing is performed before layout analysis.
Syntax
C++
HRESULT Preprocess(
IPagePreprocessingParams* PreprocessingParams,
IObjectsExtractionParams* ExtractionParams,
IRecognizerParams* RecognizerParams
);
C#
void Preprocess(
IPagePreprocessingParams PreprocessingParams,
IObjectsExtractionParams ExtractionParams,
IRecognizerParams RecognizerParams
);
Visual Basic .NET
Sub Preprocess( _ [PreprocessingParams As IPagePreprocessingParams = Nothing], _ [ExtractionParams As IObjectsExtractionParams = Nothing], _ [RecognizerParams As IRecognizerParams = Nothing] _ )
Parameters
- PreprocessingParams
- [in] Refers to the PagePreprocessingParams object that stores parameters of preprocessing. This parameter may be 0. In this case, the pages are preprocessed with default parameters, or, if a profile has been loaded, the parameters set by this profile are used.
- ExtractionParams
- [in] Refers to the ObjectsExtractionParams object that stores parameters of objects extraction. This parameter may be 0. In this case, the objects are extracted with default parameters, or, if a profile has been loaded, the parameters set by this profile are used.
- RecognizerParams
- [in] Refers to the RecognizerParams object that stores recognition parameters necessary for preprocessing (e.g., recognition language). This parameter may be 0. In this case, the default parameters are used, or, if a profile has been loaded, the parameters set by this profile are used.
Return values
If page preprocessing is interrupted by the user, this method will return E_ABORT. It also returns the standard return codes of ABBYY FineReader Engine functions.
Remarks
- This method may report events to the listeners attached to the IConnectionPointContainer interface of the FRDocument object.
- Depending on the value of the IEngine::MultiProcessingParams property, ABBYY FineReader Engine can distribute preprocessing of multi-page documents to CPU cores.
See also
Tuning Parameters of Preprocessing, Analysis, Recognition, and Synthesis
11/7/2025 12:48:30 PM