메인 콘텐츠로 건너뛰기
이 객체는 열린 이미지, 즉 “이미지 문서”에 해당합니다. 이 객체의 특성은 이미지의 특성을 반영합니다. ImageDocument 객체는 Image 객체, 즉 “이미지 평면” 컬렉션의 루트 객체입니다. 각 이미지 문서에는 흑백, 회색조, 컬러, 미리 보기의 4가지 “이미지 평면”이 포함됩니다. 이러한 이미지 평면은 해당 속성을 통해 액세스할 수 있습니다. 이 객체에는 여러 이미지 전처리 메서드가 포함되어 있습니다. 이들 메서드 중 일부는 사진에만 적합하고, 다른 일부는 모든 유형의 문서에 사용할 수 있습니다. 어떤 메서드는 인식 품질을 높이고, 어떤 메서드는 이미지의 시각적 표현만 개선하지만 인식 품질을 떨어뜨릴 수 있습니다. 후자의 메서드는 인식 후에만 사용해야 합니다. 특정 메서드를 현재 시나리오에서 사용할 수 있는지 확인하려면 각 메서드의 설명을 주의 깊게 읽어 보십시오. 아래에는 이미지 전처리 메서드의 권장 사용 순서가 나와 있습니다(목록에서 현재 시나리오에 적합한 메서드만 사용하십시오).
  • 인식 품질을 개선하려면:
    1. 이미지 자르기
    2. 국부 대비 향상
    3. 방향 교정(필요한 매개변수와 함께 Transform 메서드 사용)
    4. 이미지 반전 또는 좌우 반전(필요한 매개변수와 함께 Transform 메서드 사용)
    5. 기울어짐 교정
    6. 맞은편 두 페이지 분할(FRDocument 객체의 SplitPages 메서드 사용)
    7. 기하학적 왜곡 제거
    8. 잡음 제거
    9. 노이즈 제거
    10. 모션 블러 제거
    11. 컬러 객체 억제
    12. 컬러 객체 제거
  • 이미지 모양을 개선하려면:
    1. 밝기를 균일하게 조정하고 배경을 흰색으로 만들기
    2. 이미지 질감 평활화
    3. 이미지 디더링
이 모든 전처리 메서드는 열린 이미지에 적용해야 합니다. 이미지의 일부 수정은 이미지를 여는 과정의 더 이른 단계에서 적용할 수도 있습니다. 이미지를 여는 동안 수행되는 이미지 전처리에 대해 자세히 알아보려면 PrepareImageModePagePreprocessingParams 객체의 설명을 참조하십시오. ImageDocument 객체는 소위 “연결 가능한 객체”입니다. Windows용 FRE의 Visual Basic에서는 WithEvents로 선언할 수 있습니다. C++(지원되는 모든 운영 체제)에서는 이것이 IConnectionPointContainer 인터페이스를 지원한다는 뜻입니다. 처리 중 알림 이벤트를 받으려면 C++ 사용자는 IImageDocumentEvents 인터페이스에서 파생된 객체를 만들고 다음을 수행해야 합니다.
  • Linux 및 macOS: AdviseFREngineObject 전역 함수를 호출하여 해당 객체를 ImageDocument 객체에 등록합니다.
  • Windows: 표준 COM 방식으로 객체와 ImageDocument 객체에 구현된 이벤트 소스 사이의 연결을 설정합니다.
Windows: ImageDocument 객체의 메서드는 특수한 송신 인터페이스를 통해 페이지 처리 진행 상황 정보를 보고합니다. 이러한 인터페이스는 IImageDocumentEvents(C++용)와 dispinterface DIImageDocumentEvents(Visual Basic용)입니다. Visual Basic 사용자는 이 개발 플랫폼에서 이벤트 인터페이스를 쉽게 처리할 수 있는 수단을 제공하므로, 구현 세부 사항은 신경 쓰지 않아도 됩니다.

속성

,read-only

객체를 반환합니다.

,read-only

현재 ImageDocument 객체의흑백이미지 플레인에 접근합니다.

,read-only

현재 ImageDocument 객체의컬러이미지 플레인에 접근합니다.

,read-only

현재 ImageDocument 객체의회색조이미지 플레인에 접근합니다.

, read-only

이미지 문서의 ID를 저장합니다.

, read-only

이미지 문서의 각 컬러 플레인은 고유한 컬러 유형을 가집니다. 이 속성은 전체 이미지 문서의 컬러 유형을 각 컬러 플레인(흑백, 회색조, 컬러)의 대응 값 중 최댓값으로 지정합니다.

, read-only

이미지 문서가 메모리에만 저장되어 있는지, 아니면 디스크의 폴더로도 표현되는지를 지정합니다.

SaveTo메서드를 호출한 후에도 이 속성의 값은 변경되지 않습니다. 이미지 문서를 다시 로드하려면LoadImageDoc메서드를 호출해야 합니다.

, read-only

디스크에 있는 객체의 내부 표현 폴더 경로를 저장합니다. IsInMemory 속성의 값이 TRUE이면 이 속성은 빈 문자열을 포함합니다.

SaveTo메서드를 호출한 후에도 이 속성의 값은 변경되지 않습니다. 이미지 문서를 다시 로드하려면LoadImageDoc메서드를 호출해야 합니다.

,읽기 전용

현재 수정 상태의 픽셀 좌표 정보를 포함하는객체를 반환합니다.

이 속성은 이미지 처리 중 두 상태 간의 좌표를 변환해야 할 때 유용합니다.

, 읽기 전용

ImageDocument 객체가 메모리에 로드된 이후 또는 마지막으로메서드를 호출한 이후 수정 사항이 있는지 여부를 나타냅니다.

, 읽기 전용

이미지를 연 이후 수행된 회전을 나타냅니다.

, 읽기 전용

이 속성이 TRUE로 설정된 경우, 이미지를 연 이후 이미지 색상이 반전되었음을 나타냅니다.

, 읽기 전용

이 속성이 TRUE로 설정된 경우, 이미지를 연 이후 이미지가 수직 축을 기준으로 미러링되었음을 나타냅니다.

, 읽기 전용

이미지 열기, 전처리 또는메서드 호출 중에 이미지 기울기가 완전히 보정되었는지 여부를 나타냅니다.

보정된 기울기 각도의 탄젠트 값은 SkewAngle 속성에 저장됩니다.

, 읽기 전용

이미지 열기, 전처리 또는메서드 호출 중에 감지되어 보정된 기울기 각도의 탄젠트 값을 저장합니다. 기울기 각도가 음수이면 이미지가 시계 방향으로 회전된 것이고, 양수이면 반시계 방향으로 회전된 것입니다. 이미지는 임의의 점을 기준으로 회전될 수 있습니다. 기울기가 보정된 이미지의 크기는 항상 원본 이미지보다 큽니다.

이미지를 추가로 수정하면 이 속성 값이 0으로 초기화됩니다. 보정된 기울기 각도 값이 필요한 경우, 이미지를 편집하는 다른 메서드를 호출하기 전에 해당 값을 저장해 두십시오.

, 읽기 전용

ImageDocument 객체가 텍스트를 포함하는 파일로부터 생성되었는지 여부를 나타냅니다. 예를 들어, PDF 파일에는 텍스트 레이어가 있을 수 있습니다.

, 읽기 전용

ImageDocument 객체가 사진 파일로부터 생성되었는지 여부를 나타냅니다.

, 읽기 전용

현재 ImageDocument 객체의 소스 이미지 파일 형식에 대한 정보를 제공합니다. 이 정보를 사용할 수 없거나 이미지가 스캐너에서 수신된 경우, 이 속성의 값은 IFF_UnknownFormat입니다.

, 읽기 전용

이미지 획득에 사용된 스캐너에 대한 정보를 제공합니다. 소스 이미지 매개변수에 대한 정보를 사용할 수 없거나 이미지가 파일에서 수신된 경우, 이 속성의 값은 빈 문자열입니다.

, 읽기 전용

현재 ImageDocument 객체의 스캔 강도 임계값에 대한 정보를 제공합니다. 소스 이미지 매개변수에 대한 정보를 사용할 수 없거나 이미지가 파일에서 가져온 경우, 이 속성의 값은 -1입니다.

, 읽기 전용

현재 ImageDocument 객체의 소스 이미지 수평 해상도에 대한 정보를 제공합니다. 소스 이미지 매개변수에 대한 정보를 사용할 수 없는 경우, 이 속성의 값은 0입니다.

, 읽기 전용

현재 ImageDocument 객체의 소스 이미지 수직 해상도에 대한 정보를 제공합니다. 소스 이미지 매개변수에 대한 정보를 사용할 수 없는 경우, 이 속성의 값은 0입니다.

메서드

이름설명
ApplySigmaFilter이 메서드는 이미지에 노이즈를 줄이는 필터를 적용합니다. 주로 사진에 유용합니다.
ChangeResolution이미지의 해상도를 변경합니다.
CorrectShadowsAndHighlights이미지의 과도한 그림자와 하이라이트를 보정합니다.
CorrectSkew이미지의 기울어짐을 보정합니다.
CropImage이미지에서 문서의 경계를 찾은 다음 이미지를 자릅니다.
DitherImageFloyd–Steinberg 또는 Bayer(ordered) 디더링 알고리즘을 사용해 이미지를 디더링합니다.
EnhanceLocalContrast이미지의 국부 대비를 높입니다.
EqualizeBrightness이미지 밝기를 보정합니다. 이 메서드는 회색조 이미지와 컬러 이미지에만 사용할 수 있습니다.
FindBlackSquares이미지에서 검은 사각형을 찾습니다.
GetPreviewImage현재 ImageDocument 객체의 94 * 60 미리보기 이미지 평면에 액세스합니다. 이 크기의 미리보기가 아직 생성되지 않은 경우, 이 호출 중에 생성되며 이 작업에는 다소 시간이 걸립니다.
GetPreviewImageSpecificSize현재 ImageDocument 객체의 preview 이미지 평면에 액세스하고 크기를 지정할 수 있습니다. 해당 크기의 preview가 아직 생성되지 않았다면 이 호출 중에 생성되며, 다소 시간이 걸릴 수 있습니다.
GetTextBackgroundColor이미지의 지정된 사각형에서 텍스트와 배경의 색상을 감지합니다.
Modify이미지를 수정할 수 있습니다. 이 메서드는 Transform 메서드보다 더 고급 수정 기능을 제공합니다.
RemoveColorObjects이미지 전체 또는 일부 영역에서 지정된 컬러 객체를 제거합니다. 이 메서드는 컬러 이미지에만 사용할 수 있습니다.
RemoveColorObjectsEx이미지에서 지정된 색조의 모든 컬러 객체를 제거하고 지정된 색상으로 대체합니다. 제거된 객체는 별도의 이미지로 저장할 수 있습니다.
RemoveGarbage이미지에서 잡음(일정 크기보다 작은 불필요한 점)을 제거합니다.
RemoveGeometricalDistortions이미지의 기하학적 왜곡(예: 페이지 가장자리 근처의 휘어진 선)을 제거합니다.
RemoveMotionBlur이미지의 모션 블러를 제거합니다.
RemoveNoise이미지의 노이즈를 줄입니다.
SaveImageRegionTo이미지의 일부를 디스크의 폴더에 저장합니다. 저장된 이미지는 ABBYY FineReader Engine 내부 형식입니다.
SaveModified현재 ImageDocument 객체에 적용된 모든 수정 사항을 디스크의 폴더에 저장합니다.
SaveToImageDocument 객체의 콘텐츠를 디스크의 폴더에 저장합니다. 이미지는 ABBYY FineReader Engine의 내부 형식으로 저장됩니다.
SaveToFileImageDocument 객체의 콘텐츠를 파일로 저장합니다.
SaveToMemory <Note> Windows에서만 사용 가능. </Note>ImageDocument 객체의 콘텐츠를 전역 메모리에 저장합니다.
SmoothImage이미지를 평활화할 수 있습니다. 이 메서드는 회색조 및 컬러 이미지에서만 사용할 수 있습니다.
SmoothTexture비선형 필터를 사용해 이미지를 평활화합니다. 텍스처가 있는 이미지에 유용합니다. 이 메서드는 각 차원이 3픽셀 이상인 회색조 및 컬러 이미지에서만 사용할 수 있습니다.
Transform이미지에 제한된 transformation 집합을 적용합니다.
ImageDocument 객체 다이어그램

출력 매개변수

이 객체는 엔진 객체의 다음 메서드 LoadImageDocFromFile, LoadImageDocFromMemory (Windows 전용), LoadImageDoc, OpenBitmap, OpenDib, OpenBitmapBits, OpenImageFileFromMemory의 출력 매개변수입니다.

입력 매개변수

이 객체는 다음 메서드의 입력 매개변수로 전달됩니다.

예제

이 객체는 다음 코드 예제에서 사용됩니다: Linux: CommandLineInterfaceBCR macOS: 명함 인식 Windows: CommandLineInterface; 및 데모 도구: 엔진 미리 정의된 처리 프로필

참고 항목

IImageDocumentEvents 이미지 작업하기 Working with Connectable Objects 속성 작업하기