메인 콘텐츠로 건너뛰기
이 메서드는 Linux 및 Windows용 FRE에서 구현됩니다.
이 메서드는 클라이언트 측에서 구현됩니다. 이 메서드는 소스의 이미지 처리 대기열에서 다음 이미지 파일을 반환합니다.
Windows에서는 이미 메모리에 로드된 이미지로 작업하는 경우(예: Engine 객체의 OpenBitmap 또는 OpenDib 메서드를 사용하는 경우) GetNextImageDocument를 구현하십시오.
GetNextImageFile 메서드 구현에는 다음 이미지 파일을 기다리는 시간이 포함될 수 있습니다. 하지만 FineReader Engine은 멀티스레드를 지원하지 않으므로 긴 대기 시간을 구현하는 것은 권장되지 않습니다. 다음 파일을 기다리는 동안 Engine은 인식 프로세스의 메시지를 처리하지 못하고, 특정 페이지가 처리되었다는 알림도 받을 수 없습니다. 긴 대기 시간을 반드시 지정해야 하는 경우 GetNextImageFile 메서드는 0을 반환할 수 있습니다. 이 경우 Engine은 인식 프로세스의 메시지를 계속 처리하고 인식된 이미지를 계속 제공하며, 잠시 후 이미지 대기열이 비어 있는지 확인합니다. 대기열이 비어 있지 않으면(즉, IImageSource::IsEmpty가 FALSE를 반환하면) Engine은 GetNextImageFile 메서드를 다시 호출합니다. 하지만 GetNextImageFile 메서드가 0을 반환하고 더 이상 처리할 페이지가 없으면 FineReader Engine은 사용자에게 제어를 반환합니다. 즉, IBatchProcessor::GetNextProcessedPage 메서드가 0을 반환합니다.

구문

C++

HRESULT GetNextImageFile( IFileAdapter** Result );

C#

IFileAdapter GetNextImageFile();

Visual Basic .NET

Function GetNextImageFile() As IFileAdapter

매개변수

Result [out, retval] 대기열의 다음 이미지 파일에 액세스할 수 있게 해 주는 IFileAdapter* 포인터 변수에 대한 포인터입니다.

반환 값

[C++ 전용] 이 메서드가 S_OK 이외의 값을 반환하면 클라이언트 측 오류가 발생했음을 의미합니다.

비고

  • 이 메서드의 클라이언트 구현은 메서드 내부에서 발생하는 모든 예외를 반드시 포착하고 처리해야 하며, 어떤 예외도 메서드 외부로 전파되지 않도록 해야 합니다. 예외가 메서드 외부로 전파되면 예측할 수 없는 결과(예: 프로그램 종료)가 발생할 수 있습니다.
  • 라이선스에 Office 형식 열기 모듈이 포함되어 있으면, 이 메서드를 사용하여 지원되는 형식의 디지털 문서를 열 수도 있습니다.

샘플

// 이미지 파일 대기열을 관리하는 사용자 지정 이미지 소스의 샘플 구현
public class ImageSourceCallback : FREngine.IImageSource
{
   public ImageSourceCallback( string imageFilesDirectory )
   {
       imageFiles = ImageSourceHelper.LoadFilesNames( imageFilesDirectory );
       nextFileIndex = 0;
   }
   public bool IsEmpty()
   {
       return nextFileIndex >= imageFiles.Length;
   }
   public FREngine.IFileAdapter GetNextImageFile()
   {
       if( !IsEmpty() ) {
           return new FileAdapterCallback( imageFiles[nextFileIndex++] );
       }
       return null;
   }
   public FREngine.IImageDocument GetNextImageDocument()
   {
       ...
   }
   private string[] imageFiles;
   private int nextFileIndex;
}
public class FileAdapterCallback : FREngine.IFileAdapter
{
    ...
}
public class ImageSourceHelper
{
    ...
}

참고 항목

IImageSource GetNextImageDocument IsEmpty IFileAdapter