메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt

Use this file to discover all available pages before exploring further.

이 객체에는 ImageDocument 객체(CoordinatesConverter 속성)에서 가져온 시점의 이미지상 픽셀 좌표 정보가 포함되어 있습니다. 이 객체를 사용하면 한 이미지 수정 상태의 픽셀 좌표를 다른 상태로 변환할 수 있습니다. 이 객체를 사용하면 이미지 처리의 임의의 두 단계 간에 픽셀 좌표를 변환할 수 있습니다. 예를 들면 다음과 같습니다.
  1. 이미지 열기 직후, 이미지 기울어짐이 보정된 상태에서 이 객체를 가져옵니다.
  2. 다른 수정을 여러 개 적용한 다음, ImageDocument에서 이 객체의 또 다른 인스턴스를 가져옵니다.
  3. 이제 ConvertCoordinates 메서드를 두 번 적용하여 처음 기울어짐이 보정된 이미지 평면과 수정된 이미지 평면 사이에서 픽셀 좌표를 변환할 수 있습니다.
    • 첫 번째 CoordinatesConverter 인스턴스를 사용하여 기울어짐이 보정된 이미지 평면에서 원본 이미지 평면으로 변환합니다.
    • 두 번째 CoordinatesConverter 인스턴스를 사용하여 원본 이미지 평면의 결과를 수정된 이미지 평면으로 변환합니다.
CoordinatesConverter 객체는 영속 객체입니다. 즉, 객체의 현재 상태를 영구 저장소에 쓸 수 있습니다. 나중에 영구 저장소에서 객체 상태를 읽어 객체를 다시 생성할 수 있습니다. 다음 메서드는 객체의 영속성을 지원합니다. Linux: SaveToFile 및 LoadFromFile Windows: SaveToFile, LoadFromFile, SaveToMemory 및 LoadFromMemory.

​
속성

이름유형설명
Application엔진, 읽기 전용엔진 객체를 반환합니다.

​
메서드

이름설명
ConvertCoordinatesImageDocument의 서로 다른 수정 상태나 이미지 평면 간에 픽셀 좌표를 변환합니다.
LoadFromFile디스크에 있는 파일에서 객체의 내용을 복원합니다.
LoadFromMemory전역 메모리에서 객체의 내용을 복원합니다.
Windows용으로 구현되었습니다.
SaveToFile객체의 내용을 디스크에 있는 파일에 저장합니다.
SaveToMemory객체의 내용을 전역 메모리에 저장합니다.
Windows용으로 구현되었습니다.
CoordinatesConverter 객체 다이어그램

​
샘플

다음은 이 객체를 사용해 서로 다른 두 수정 상태 사이에서 좌표를 변환하는 Windows용 샘플입니다:

​
C#

FREngine.IEngine engine;
FREngine.IFRDocument frDoc;
// 이미지를 문서에 추가할 때는 기본적으로 기울어짐 보정이 수행됩니다
frDoc.AddImageFile ("D:\\Sample.tif", null, null);
// 첫 번째 페이지의 ImageDocument를 엽니다
FREngine.IImageDocument imageDoc = frDoc.Pages[0].ImageDocument; 
// 연 직후의 좌표 스냅샷을 생성합니다
FREngine.ICoordinatesConverter convAfterOpening = imageDoc.CoordinatesConverter;
// 이미지를 한 번 더 변환합니다
imageDoc.Transform(FREngine.RotationTypeEnum.RT_Counterclockwise, false, false);
// 변환 후의 좌표 스냅샷을 생성합니다
FREngine.ICoordinatesConverter convAfterModification = imageDoc.CoordinatesConverter;
...
// 일부 처리 후 좌표를 변환해야 하는 픽셀을 수정된 이미지 평면에서 찾습니다
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, y에는 기울어짐이 보정된 이미지 평면에서 필요한 지점의 좌표가 들어 있습니다
이 객체는 macOS용 명함 인식 코드 샘플에서도 사용됩니다.

​
참고 항목

ImageDocument 이미지 다루기 속성 다루기