ConvertCoordinates Method of the CoordinatesConverter Object
This method converts coordinates of a pixel between different modification states or image planes of the ImageDocument.
Syntax
C++
HRESULT ConvertCoordinates( ImageTypeEnum FromPage, ImageTypeEnum ToPage, int* X, int* Y );
C#
void ConvertCoordinates( ImageTypeEnum FromPage, ImageTypeEnum ToPage, out int X, out int Y );
Visual Basic .NET
Sub ConvertCoordinates( _ FromPage As ImageTypeEnum, _ ToPage As ImageTypeEnum, _ ByRef X As Integer, _ ByRef Y As Integer _ )
Parameters
- FromPage
- [in] This variable of the ImageTypeEnum type specifies the image page from which the coordinates of pixel are to be converted.
- ToPage
- [in] This variable of the ImageTypeEnum type specifies the image page to which the coordinates of pixel are to be converted.
- X
- [in, out] This variable stores the horizontal coordinate of the pixel relative to the source image page before the method call, and the horizontal coordinate of the pixel relative to the target image page after the method call.
- Y
- [in, out] This variable stores the vertical coordinate of the pixel relative to the source image page before the method call, and the vertical coordinate of the pixel relative to the target image page after the method call.
Return values
This method has no specific return values. It returns the standard return values of ABBYY FineReader Engine functions.
Remarks
- The coordinates of pixels on the black-and-white image page and the color image page are the same.
- The method will return an error if you attempt to convert coordinates to or from a preview image plane that hasn't been created yet.
Important! An image modification, automatic or manual, may reset the preview image plane created earlier, and you will not be able to convert coordinates to or from that preview. Before converting coordinates, call the GetPreviewImage method again if the image was modified.
See also
07.11.2025 12:48:30