English (English)
FindPageSplitPosition Method of the FRPage Object
This method finds the position of splitting the image on pages, if it exists. It is used to detect the possibility of splitting dual pages in a book.
To find the position where the image can be split:
- Detect orientation of the image using the IFRPage::DetectOrientation method.
- Pass the returned TextOrientation object to the FindPageSplitPosition method.
The split position is defined by two lines, the coordinates of which are returned in the startSplitPosition and endSplitPosition parameters. The image area between these two lines should be removed when splitting image on pages. This area usually contains some garbage.
Syntax
C++
HRESULT FindPageSplitPosition( IObjectsExtractionParams* ExtractionParams, ITextOrientation* TextOrientation, PageSplitDirectionEnum* SplitDirection, int* StartSplitPosition, int* EndSplitPosition );
C#
void FindPageSplitPosition( IObjectsExtractionParams ExtractionParams, ITextOrientation TextOrientation, out PageSplitDirectionEnum SplitDirection, out int StartSplitPosition, out int EndSplitPosition );
Visual Basic .NET
Sub FindPageSplitPosition( _ ExtractionParams As IObjectsExtractionParams, _ TextOrientation As TextOITextOrientationrientation, _ ByRef SplitDirection As PageSplitDirectionEnum, _ ByRef StartSplitPosition As Integer, _ ByRef EndSplitPosition As Integer _ )
Parameters
- ExtractionParams
- [in] 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.
- TextOrientation
- [in] Refers to the TextOrientation object that specifies orientation of the text on the image. If this parameter is 0, ABBYY FineReader Engine presumes that the image has normal orientation.
- SplitDirection
- [out] This variable receives the type of possible split: vertical split, horizontal split, or no split. Refer to the PageSplitDirectionEnum description for details.
- StartSplitPosition
- [out] The coordinate of the first line which defines split position (if a split is possible). The meaning of this value depends on the value of the splitDirection variable. If the possibility of vertical split is detected, it contains the horizontal coordinate of the split line. If the possibility of horizontal split is detected, it contains the vertical coordinate of the split line. Coordinate is given against the deskewed black-and-white page of the image.
- EndSplitPosition
- [out] The coordinate of the second line which defines split position (if a split is possible). The meaning of this value depends on the value of the splitDirection variable. If the possibility of vertical split is detected, it contains the horizontal coordinate of the split line. If the possibility of horizontal split is detected, it contains the vertical coordinate of the split line. Coordinate is given against the deskewed black-and-white page of the image.
Return values
This method has no specific return values. It returns the standard return values of ABBYY FineReader Engine functions.
Samples
C# code
The method is used in the following demo tools: Image Preprocessing.
See also
9/17/2024 3:14:40 PM