Passer au contenu principal
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

NomTypeDescription
ApplicationEngine, lecture seuleRenvoie l’objet Engine.

​
Méthodes

NomDescription
ConvertCoordinatesConvertit les coordonnées d’un pixel entre différents états de modification ou plans d’image de l’ImageDocument.
LoadFromFileRestaure le contenu de l’objet depuis un fichier sur le disque.
LoadFromMemory <Note> Disponible pour Windows. </Note>Restaure le contenu de l’objet depuis la mémoire globale.
SaveToFileEnregistre le contenu de l’objet dans un fichier sur le disque.
SaveToMemory <Note> Disponible pour Windows. </Note>Enregistre le contenu de l’objet dans la mémoire globale.
CoordinatesConverter 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