Saltar al contenido principal
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 modificación 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 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

NombreTipoDescripción
ApplicationEngine, de solo lecturaDevuelve el objeto Engine.

​
Métodos

NombreDescripción
ConvertCoordinatesConvierte las coordenadas de un píxel entre diferentes estados de Modification o planos de imagen del ImageDocument.
LoadFromFileRestaura el contenido del objeto desde un archivo en disco.
LoadFromMemory <Note> Disponible para Windows. </Note>Restaura el contenido del objeto desde la memoria global.
SaveToFileGuarda el contenido del objeto en un archivo en disco.
SaveToMemory <Note> Disponible para Windows. </Note>Guarda el contenido del objeto en la memoria global.
CoordinatesConverter 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