Objet CoordinatesConverter (interface ICoordinatesConverter)

Cet objet contient des informations sur les coordonnées en pixels de l’image au moment où il a été obtenu à partir de l’objet ImageDocument (propriété CoordinatesConverter). Il permet de convertir les coordonnées en pixels d’un état de modification de l’image à un autre.

Vous pouvez utiliser cet objet pour convertir les coordonnées en pixels entre deux étapes quelconques du traitement de l’image. Par exemple :

1. Obtenez cet objet juste après l’ouverture de l’image, lors de laquelle l’inclinaison de l’image a été corrigée.
2. Appliquez plusieurs autres modifications et obtenez une autre instance de cet objet à partir de l’ImageDocument.
3. Vous pouvez maintenant convertir les coordonnées en pixels entre le plan de l’image initialement redressée et le plan de l’image modifiée en appliquant deux fois la méthode ConvertCoordinates :
   • convertissez du plan de l’image redressée vers l’image d’origine à l’aide de la première instance de CoordinatesConverter ;
   • convertissez le résultat du plan de l’image d’origine vers le plan de l’image modifiée à l’aide de la deuxième instance de CoordinatesConverter.

L’objet CoordinatesConverter est un objet persistant. Cela signifie que l’état actuel de l’objet peut être enregistré dans un stockage persistant. Par la suite, l’objet peut être recréé en relisant son état à partir de ce stockage persistant. Les méthodes suivantes assurent la persistance de l’objet :

Linux: SaveToFile, et LoadFromFile

Windows: SaveToFile, LoadFromFile, SaveToMemory, et LoadFromMemory.

​

Propriétés

Nom	Type	Description
Application	Engine, lecture seule	Renvoie l’objet Engine.

​

Méthodes

Nom	Description
ConvertCoordinates	Convertit les coordonnées d’un pixel entre différents états de modification ou plans d’image de l’ImageDocument.
LoadFromFile	Restaure le contenu de l’objet depuis un fichier sur le disque.
LoadFromMemory	Restaure le contenu de l’objet depuis la mémoire globale. Windows uniquement.
SaveToFile	Enregistre le contenu de l’objet dans un fichier sur le disque.
SaveToMemory	Enregistre le contenu de l’objet dans la mémoire globale. Windows uniquement.

​

Objets associés

Diagramme d’objets

​

Exemples

Voici un exemple pour Windows dans lequel cet objet est utilisé pour convertir des coordonnées entre deux états de modification différents :

​

C#

FREngine.IEngine engine;
FREngine.IFRDocument frDoc;
// La correction de l'inclinaison est appliquée par défaut lors de l'ajout des images au document
frDoc.AddImageFile ("D:\\Sample.tif", null, null);
// Ouvre l'ImageDocument de la première page
FREngine.IImageDocument imageDoc = frDoc.Pages[0].ImageDocument; 
// Crée un instantané des coordonnées après l'ouverture
FREngine.ICoordinatesConverter convAfterOpening = imageDoc.CoordinatesConverter;
// Applique une transformation supplémentaire à l'image
imageDoc.Transform(FREngine.RotationTypeEnum.RT_Counterclockwise, false, false);
// Crée un instantané des coordonnées après la transformation
FREngine.ICoordinatesConverter convAfterModification = imageDoc.CoordinatesConverter;
...
// Après un certain traitement, vous trouvez un pixel sur le plan de l'image modifiée dont vous devez convertir les coordonnées
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);
// x et y contiennent maintenant les coordonnées du point requis sur le plan de l'image redressée

Cet objet est également utilisé dans l’exemple de code Reconnaissance des cartes de visite sous macOS.

​

Voir aussi

ImageDocument

Travailler avec des images

Travailler avec les propriétés