Vai al contenuto principale
Questo oggetto contiene informazioni sulle coordinate dei pixel nell’immagine nel momento in cui è stato ottenuto dall’oggetto ImageDocument (proprietà CoordinatesConverter). Consente di convertire le coordinate dei pixel da uno stato di modifica dell’immagine a un altro. È possibile usare questo oggetto per convertire le coordinate dei pixel tra due qualsiasi fasi dell’elaborazione dell’immagine. Ad esempio:
  1. Ottenere questo oggetto subito dopo l’apertura dell’immagine, durante la quale è stata corretta l’inclinazione dell’immagine.
  2. Applicare altre modifiche e ottenere un’altra istanza di questo oggetto da ImageDocument.
  3. A questo punto è possibile convertire le coordinate dei pixel tra il piano immagine inizialmente raddrizzato e il piano immagine modificato applicando due volte il metodo ConvertCoordinates:
    • convertire dal piano immagine raddrizzato a quello originale usando la prima istanza di CoordinatesConverter;
    • convertire il risultato dal piano immagine originale al piano immagine modificato usando la seconda istanza di CoordinatesConverter.
L’oggetto CoordinatesConverter è un oggetto persistente. Ciò significa che lo stato corrente dell’oggetto può essere scritto in una memoria persistente. In seguito, l’oggetto può essere ricreato leggendo il suo stato dalla memoria persistente. I metodi seguenti supportano la persistenza dell’oggetto: Linux: SaveToFile, e LoadFromFile Windows SaveToFile, LoadFromFile, SaveToMemory, e LoadFromMemory.

​
Proprietà

NomeTipoDescrizione
ApplicationEngine, di sola letturaRestituisce l’oggetto Engine.

​
Metodi

NomeDescrizione
ConvertCoordinatesConverte le coordinate di un pixel tra diversi stati di modifica o piani immagine di ImageDocument.
LoadFromFileRipristina il contenuto dell’oggetto da un file su disco.
LoadFromMemory <Note> Disponibile per Windows. </Note>Ripristina il contenuto dell’oggetto dalla memoria globale.
SaveToFileSalva il contenuto dell’oggetto in un file su disco.
SaveToMemory <Note> Disponibile per Windows. </Note>Salva il contenuto dell’oggetto nella memoria globale.
CoordinatesConverter Diagramma degli oggetti

​
Esempi

Ecco un esempio per Windows in cui questo oggetto viene usato per convertire le coordinate tra due stati di modifica diversi:

​
C#

FREngine.IEngine engine;
FREngine.IFRDocument frDoc;
// La correzione dell'inclinazione viene applicata per impostazione predefinita durante l'aggiunta delle immagini al documento
frDoc.AddImageFile ("D:\\Sample.tif", null, null);
// Apri l'ImageDocument della prima pagina
FREngine.IImageDocument imageDoc = frDoc.Pages[0].ImageDocument; 
// Crea un'istantanea delle coordinate dopo l'apertura
FREngine.ICoordinatesConverter convAfterOpening = imageDoc.CoordinatesConverter;
// Trasforma ulteriormente l'immagine
imageDoc.Transform(FREngine.RotationTypeEnum.RT_Counterclockwise, false, false);
// Crea un'istantanea delle coordinate dopo la trasformazione
FREngine.ICoordinatesConverter convAfterModification = imageDoc.CoordinatesConverter;
...
// Dopo alcune elaborazioni, trovi un pixel sul piano dell'immagine modificata le cui coordinate devi convertire
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);
// ora x, y contengono le coordinate del punto richiesto sul piano dell'immagine corretta per l'inclinazione
Questo oggetto viene utilizzato anche nell’esempio di codice Riconoscimento Biglietto da Visita per macOS.

​
Vedi anche

ImageDocument Lavorare con le immagini Lavorare con le proprietà