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

​
속성

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

​
메서드

이름설명
ConvertCoordinatesImageDocument의 서로 다른 수정 상태나 이미지 평면 간에 픽셀 좌표를 변환합니다.
LoadFromFile디스크에 있는 파일에서 객체의 내용을 복원합니다.
LoadFromMemory <Note> Windows에서 사용할 수 있습니다. </Note>전역 메모리에서 객체의 내용을 복원합니다.
SaveToFile객체의 내용을 디스크에 있는 파일에 저장합니다.
SaveToMemory <Note> Windows에서 사용할 수 있습니다. </Note>객체의 내용을 전역 메모리에 저장합니다.
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 이미지 다루기 속성 다루기