DetectResolution Method of the FRPage Object

DetectResolution method of the FRPage Object in the ABBYY FineReader Engine API — Estimates the best recognition resolution from a specified range; does not change the page resolution (use IImageDocument.ChangeResolution for that).

This method selects the best resolution from the specified range. It is intended to estimate the best resolution for recognition. The result of this method’s work can be unreliable if the image contains little or no text.

The method does not change resolution of the page image. To change resolution to the selected one, use the IImageDocument::ChangeResolution method.

Syntax

C++

HRESULT DetectResolution(
  IObjectsExtractionParams* ExtractionParams,
  int                       MinResolution,
  int                       MaxResolution,
  int*                      NewResolution
);

C#

void DetectResolution(
  IObjectsExtractionParams ExtractionParams,
  int                      MinResolution,
  int                      MaxResolution,
  out int                  NewResolution
);

Visual Basic .NET

Sub DetectResolution( _
  ExtractionParams As IObjectsExtractionParams, _
  MinResolution As Integer, _
  MaxResolution As Integer, _
  ByRef NewResolution As Integer
)

Parameters

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.

MinResolution

[in] Specifies the minimum resolution which can be selected.

MaxResolution

[in] Specifies the maximum resolution which can be selected.

NewResolution

[out] Receives the best resolution of the page image. If ABBYY FineReader Engine cannot select resolution from the specified range (MinResolution to MaxResolution), -1 is returned.

Return values

This method has no specific return values. It returns the standard return values of ABBYY FineReader Engine functions.

See also

FRPage

IPagePreprocessingParams::OverwriteResolutionMode

IImageDocument::ChangeResolution

Working with Profiles