Chinese Simplified (简体中文)

CoordinatesConverter Object (ICoordinatesConverter Interface)

This object contains information about the pixel coordinates on the image at the moment when it was obtained from the ImageDocument object (the CoordinatesConverter property). It allows you to convert the pixel coordinates from one image modification state to another.

You can use this object to convert the pixel coordinates between any two stages in the image processing. For example:

  1. Obtain this object directly after image opening, during which image skew was corrected.
  2. Apply a number of other modifications and obtain another instance of this object from the ImageDocument.
  3. Now you can convert pixel coordinates between the initially deskewed image plane and the modified image plane by twice applying the ConvertCoordinates method:
    • convert from the deskewed image plane to the original using the first instance of the CoordinatesConverter;
    • convert the result from the original image plane to the modified image plane using the second instance of the CoordinatesConverter.

The CoordinatesConverter object is a persistent object. This means that the object's current state can be written to persistent storage on disk. Later, the object can be re-created by reading the object's state from persistent storage. The following methods provide persistence of the object: SaveToFile, and LoadFromFile.

Properties

Name Type Description
Application Engine, read-only Returns the Engine object.

Methods

Name Description
ConvertCoordinates Converts coordinates of a pixel between different modification states or image planes of the ImageDocument.
LoadFromFile Restores the object's contents from a file on disk.
SaveToFile Saves the object's contents into a file on disk.

Related objects

Object Diagram

Samples

This object is used in the BCR code sample.

See also

ImageDocument

Working with Images

Working with Properties

03.07.2024 8:50:25

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.