Pular para o conteúdo principal
Este objeto contém informações sobre as coordenadas de pixel na imagem no momento em que ela foi obtida do objeto ImageDocument (a propriedade CoordinatesConverter). Ele permite converter coordenadas de pixel de um estado de modificação da imagem para outro. Você pode usar este objeto para converter coordenadas de pixel entre quaisquer dois estágios do processamento da imagem. Por exemplo:
  1. Obtenha este objeto logo após a abertura da imagem, durante a qual a inclinação da imagem foi corrigida.
  2. Aplique várias outras modificações e obtenha outra instância deste objeto do ImageDocument.
  3. Agora, você pode converter coordenadas de pixel entre o plano da imagem inicialmente corrigido quanto à inclinação e o plano da imagem modificada aplicando o método ConvertCoordinates duas vezes:
    • converter do plano da imagem corrigido quanto à inclinação para o original usando a primeira instância do CoordinatesConverter;
    • converter o resultado do plano da imagem original para o plano da imagem modificada usando a segunda instância do CoordinatesConverter.
O objeto CoordinatesConverter é um objeto persistente. Isso significa que o estado atual do objeto pode ser gravado em armazenamento persistente. Mais tarde, o objeto pode ser recriado lendo-se seu estado do armazenamento persistente. Os métodos a seguir fornecem persistência ao objeto: Linux: SaveToFile, e LoadFromFile Windows SaveToFile, LoadFromFile, SaveToMemory, e LoadFromMemory.

​
Properties

NameTypeDescription
ApplicationEngine, somente leituraRetorna o objeto Engine.

​
Métodos

NomeDescrição
ConvertCoordinatesConverte as coordenadas de um pixel entre diferentes estados de modificação ou planos de imagem do ImageDocument.
LoadFromFileRestaura o conteúdo do objeto a partir de um arquivo em disco.
LoadFromMemory <Note> Disponível para Windows. </Note>Restaura o conteúdo do objeto a partir da memória global.
SaveToFileSalva o conteúdo do objeto em um arquivo em disco.
SaveToMemory <Note> Disponível para Windows. </Note>Salva o conteúdo do objeto na memória global.
CoordinatesConverter Diagrama de objetos

​
Exemplos

Aqui está um exemplo no Windows em que esse objeto é usado para converter coordenadas entre dois estados diferentes de modificação:

​
C#

FREngine.IEngine engine;
FREngine.IFRDocument frDoc;
// A correção de inclinação é realizada por padrão ao adicionar as imagens ao documento
frDoc.AddImageFile ("D:\\Sample.tif", null, null);
// Abrir o ImageDocument da primeira página
FREngine.IImageDocument imageDoc = frDoc.Pages[0].ImageDocument; 
// Criar um instantâneo das coordenadas após a abertura
FREngine.ICoordinatesConverter convAfterOpening = imageDoc.CoordinatesConverter;
// Aplicar mais transformações à imagem
imageDoc.Transform(FREngine.RotationTypeEnum.RT_Counterclockwise, false, false);
// Criar um instantâneo das coordenadas após a transformação
FREngine.ICoordinatesConverter convAfterModification = imageDoc.CoordinatesConverter;
...
// Após algum processamento, você localiza um pixel no plano da imagem modificada cujas coordenadas precisam ser convertidas
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);
// agora x, y contêm as coordenadas do ponto desejado no plano da imagem corrigida quanto à inclinação
Este objeto também é usado no exemplo de código de Reconhecimento de Cartões de Visita para o macOS.

​
Veja também

ImageDocument Trabalhando com imagens Trabalhando com Properties