Objeto CoordinatesConverter (Interfaz ICoordinatesConverter)

Este objeto contiene información sobre las coordenadas de píxeles en la imagen en el momento en que se obtuvo del objeto ImageDocument (la propiedad CoordinatesConverter). Permite convertir las coordenadas de píxeles de un estado de Modification de imagen a otro.

Puede usar este objeto para convertir las coordenadas de píxeles entre dos etapas cualesquiera del procesamiento de imágenes. Por ejemplo:

1. Obtenga este objeto directamente después de abrir la imagen, momento en el que se habrá corregido la inclinación de la misma.
2. Aplique otras modificaciones y obtenga otra instancia de este objeto desde el ImageDocument.
3. Ahora puede convertir las coordenadas de píxeles entre el plano de la imagen con inclinación corregida inicialmente y el plano de la imagen modificada aplicando el método ConvertCoordinates dos veces:
   • convierta desde el plano de la imagen con inclinación corregida al original usando la primera instancia del CoordinatesConverter;
   • convierta el resultado desde el plano de la imagen original al plano de la imagen modificada usando la segunda instancia del CoordinatesConverter.

El objeto CoordinatesConverter es un objeto persistente. Esto significa que el estado actual del objeto puede escribirse en un almacenamiento persistente y, posteriormente, el objeto puede recrearse leyendo dicho estado desde ese almacenamiento. Los siguientes métodos proporcionan la persistencia del objeto:

Linux: SaveToFile y LoadFromFile

Windows: SaveToFile, LoadFromFile, SaveToMemory y LoadFromMemory.

​

Propiedades

Nombre	Tipo	Descripción
Application	Engine, de solo lectura	Devuelve el objeto Engine.

​

Métodos

Nombre	Descripción
ConvertCoordinates	Convierte las coordenadas de un píxel entre diferentes estados de Modification o planos de imagen del ImageDocument.
LoadFromFile	Restaura el contenido del objeto desde un archivo en disco.
LoadFromMemory	Restaura el contenido del objeto desde la memoria global. Disponible para Windows.
SaveToFile	Guarda el contenido del objeto en un archivo en disco.
SaveToMemory	Guarda el contenido del objeto en la memoria global. Disponible para Windows.

​

Objetos relacionados

Diagrama de objetos

​

Ejemplos

A continuación se muestra un ejemplo para Windows en el que este objeto se utiliza para convertir coordenadas entre dos estados de modificación diferentes:

​

C#

FREngine.IEngine engine;
FREngine.IFRDocument frDoc;
// La corrección de inclinación se realiza de forma predeterminada al agregar las imágenes al documento
frDoc.AddImageFile ("D:\\Sample.tif", null, null);
// Abra ImageDocument de la primera página
FREngine.IImageDocument imageDoc = frDoc.Pages[0].ImageDocument; 
// Cree una instantánea de las coordenadas después de abrirlo
FREngine.ICoordinatesConverter convAfterOpening = imageDoc.CoordinatesConverter;
// Transforme un poco más la imagen
imageDoc.Transform(FREngine.RotationTypeEnum.RT_Counterclockwise, false, false);
// Cree una instantánea de las coordenadas después de la transformación
FREngine.ICoordinatesConverter convAfterModification = imageDoc.CoordinatesConverter;
...
// Tras cierto procesamiento, encontrará un píxel en el plano de la imagen modificada cuyas coordenadas deberá convertir
int x, y;
convAfterModification.ConvertCoordinates(FREngine.ImageTypeEnum.IT_Base, FREngine.ImageTypeEnum.IT_Modified, ref x, ref y);
convAfterOpening.ConvertCoordinates(FREngine.ImageTypeEnum.IT_Modified, FREngine.ImageTypeEnum.IT_Base, ref x, ref y);
// ahora x, y contienen las coordenadas del punto necesario en el plano de la imagen con la inclinación corregida

Este objeto también se utiliza en el ejemplo de código de Reconocimiento de tarjetas de visita para macOS.

​

Consulte también

ImageDocument

Trabajar con imágenes

Trabajar con propiedades