SynthesizePages Method of the FRDocument Object

This method performs document synthesis of the specified pages in the document.

Syntax

C++

HRESULT SynthesizePages(
  IIntsCollection*             PageIndices,
  ISynthesisParamsForDocument* SynthesisParamsForDocument
);
    

C#

void SynthesizePages(
  IIntsCollection             PageIndices,
  ISynthesisParamsForDocument SynthesisParamsForDocument
);
    

Visual Basic .NET

Sub SynthesizePages( _
  PageIndices As IIntsCollection, _
  [SynthesisParamsForDocument As ISynthesisParamsForDocument = Nothing] _
)
    

Parameters

PageIndices
[in] This parameter refers to the IntsCollection object that contains the indices of pages to be synthesized.
SynthesisParamsForDocument
[in] The SynthesisParamsForDocument object that stores parameters of document synthesis. This parameter may be 0. In this case, the pages are synthesized with default parameters, or, if a profile has been loaded, the parameters set by this profile are used.

Return values

If synthesis is interrupted by the user, this method will return E_ABORT. It also returns the standard return codes of ABBYY FineReader Engine functions.

Remarks

  • You may omit the stage of document synthesis in the following cases:
    • If you are going to export recognized text to TXT format. When exporting to this format, synthesis information is not used.
    • If you are going to export document to PDF ImageOnly format. The recognized text and layout information are not used in this mode.

In all other cases, document synthesis must be performed. Omitting document synthesis will cause errors.

  • Methods having the word "Process" in their names (e.g., IFRDocument::Process, IFRDocument::ProcessPages) include the stage of document synthesis. Processing methods of the FRPage object do not include it, so after using them and before export you must explicitly call some method which performs document synthesis.
  • You may speed up the stage of document synthesis and decrease memory usage. If you set the ISynthesisParamsForPage::DetectFontFormattingAtPageLevel property to TRUE during page synthesis, you can then turn off the detection of font parameters and document structure during document synthesis (ISynthesisParamsForDocument::DetectFontFormatting and ISynthesisParamsForDocument::DetectDocumentStructure). Nevertheless, the quality may deteriorate.
  • This method may report events to the listeners attached to the IConnectionPointContainer interface of the FRDocument object.

See also

FRDocument

Synthesize

Working with Profiles

24.03.2023 8:51:52

Usage of Cookies. In order to optimize the website functionality and improve your online experience ABBYY uses cookies. You agree to the usage of cookies when you continue using this site. Further details can be found in our Privacy Notice.