메인 콘텐츠로 건너뛰기
이 메서드는 지정된 이미지 파일을 열고 해당 파일에 대해 전처리, 레이아웃 분석, 인식, 페이지 및 문서 합성을 수행한 다음, 인식된 텍스트를 선택한 출력 형식으로 내보냅니다. RecognizeImageFile 메서드는 여러 페이지로 구성된 이미지를 처리하고 인식 결과를 단일 파일로 내보낼 수 있습니다.

​
구문

​
C++

HRESULT RecognizeImageFile(
  BSTR                         ImageFileName,
  IPrepareImageMode            PrepareMode,
  IDocumentProcessingParams*   DocumentProcessingParams,
  FileExportFormatEnum         ExportFormat,
  IUnknown*                    ExportParams,
  IImagePasswordCallback*      PasswordCallback,
  BSTR                         OutputFileName
);

​
C#

void RecognizeImageFile(
  string                   ImageFileName,
  IPrepareImageMode         PrepareMode,
  IDocumentProcessingParams DocumentProcessingParams,
  FileExportFormatEnum     ExportFormat,
  object                   ExportParams,
  IImagePasswordCallback   PasswordCallback,
  string                   OutputFileName
);

​
Visual Basic .NET

Sub RecognizeImageFile( _
  ImageFileName As String, _
  PrepareMode As IPrepareImageMode, _
  DocumentProcessingParams As IDocumentProcessingParams, _
  ExportFormat As IFileExportFormatEnum, _
  ExportParams As Object, _
  PasswordCallback As IImagePasswordCallback, _
  OutputFileName As String _
)

​
매개변수

ImageFileName [in] 인식할 이미지 파일의 전체 경로를 포함합니다. 이 파일이 ABBYY FineReader Engine 내부 형식이 아닌 경우 PrepareImageMode 속성의 기본값을 사용해 준비합니다. 또는 profile이 로드된 경우에는 해당 프로필에 설정된 매개변수를 사용합니다. PrepareMode [in] 내부 형식으로 이미지를 변환하기 위한 매개변수를 저장하는 PrepareImageMode 객체를 참조하는 변수입니다. 이 매개변수는 0일 수 있으며, 이 경우 이미지 준비 모드의 기본 매개변수가 사용됩니다. 또는 profile이 로드된 경우에는 해당 프로필에 설정된 매개변수를 사용합니다. DocumentProcessingParams [in] 모든 처리 매개변수를 저장하는 DocumentProcessingParams 객체를 참조합니다. 이 매개변수는 0일 수 있습니다. 이 경우 문서는 기본 매개변수로 처리됩니다(모든 처리 매개변수는 기본값으로 설정되며 인식 언어는 영어임). 또는 profile이 로드된 경우에는 해당 프로필에 설정된 매개변수를 사용합니다. ExportFormat [in] FileExportFormatEnum 형식의 이 변수는 인식된 텍스트를 내보낼 출력 파일의 형식을 지정합니다. ExportParams [in] 이 입력 매개변수를 통해 파일 형식에 해당하는 내보내기 매개변수 객체를 전달합니다. 예를 들어 RTF 파일을 생성하는 경우 RTFExportParams 객체를 만들고 필요한 매개변수를 설정한 다음 exporterParams 입력 매개변수로 이 메서드에 전달합니다. 이 매개변수는 선택 사항이며 0일 수 있습니다. 이 경우 내보내기 매개변수에는 기본값이 사용됩니다. 또는 profile이 로드된 경우에는 해당 프로필에 설정된 매개변수를 사용합니다.
Linux에서 ABBYY FineReader Engine을 프로세스 외부(out-of-process)로 로드해 작업하는 경우 이 매개변수에는 반드시 NULL을 전달해야 합니다.
PasswordCallback [in] PDF 형식 이미지에 액세스할 때 발생할 수 있는 암호 요청을 처리하는 데 사용되는 ImagePasswordCallback 형식의 사용자 구현 객체 인터페이스를 참조합니다. 이 매개변수는 선택 사항이며 0일 수 있습니다. 이 경우 암호로 보호된 파일은 처리할 수 없습니다. OutputFileName [in] 인식된 텍스트를 내보낼 출력 파일의 전체 경로를 포함합니다. 이 위치에 이미 파일이 있으면 확인 메시지 없이 덮어쓰거나, 내보내기 모드에 따라 인식된 텍스트를 파일 끝에 추가합니다.

​
반환 값

사용자가 인식을 중단하면 이 메서드는 E_ABORT를 반환합니다. 사용자가 패턴 학습을 중단하면 이 메서드는 FREN_E_PATTERN_TRAINING_ABORTED를 반환합니다. 또한 ABBYY FineReader Engine 함수의 표준 반환 코드도 반환합니다.

​
비고

Linux 및 Windows에서 IEngine::MultiProcessingParams 속성 값에 따라 ABBYY FineReader Engine은 여러 페이지로 된 문서의 처리를 CPU 코어에 분산할 수 있습니다.

​
참고 항목

엔진 IImagePasswordCallback 프로필 사용