메인 콘텐츠로 건너뛰기
이 시나리오의 결과물은 편집 가능한 문서 버전입니다. 이 시나리오에서는 문서 이미지를 원본 서식을 그대로 유지한 상태로 인식하고, 데이터를 편집 가능한 파일 형식으로 저장합니다. 그 결과 편집 가능한 문서 버전을 얻을 수 있으며, 이를 통해 오류를 쉽게 확인하고 수정할 수 있습니다. 또한 텍스트 전체 또는 일부를 복사해 재사용할 수도 있습니다. 문서는 여러 처리 단계를 거치며, 이 과정은 다른 일반적인 시나리오와 몇 가지 측면에서 약간 다릅니다.
  1. 스캔한 이미지 또는 사진 전처리
스캐너나 디지털 카메라로 얻은 이미지는 광학 인식을 수행하기 전에 일부 보정이 필요할 수 있습니다. 예를 들어, 노이즈가 있거나 텍스트 줄이 왜곡된 이미지는 광학 인식이 제대로 수행되도록 보정해야 합니다.
  1. 문서 구조와 서식을 완전히 복원하는 인식
문서를 인식할 때는 문서의 다양한 레이아웃 요소(텍스트, 표, 이미지, 구분선 등)를 식별합니다. 문서 합성 과정에서는 문서의 논리 구조가 복원되며, 페이지 합성을 통해 문서 서식(글꼴, 스타일 등)도 완전히 복원할 수 있습니다.
  1. 편집 가능한 형식으로 내보내기
인식된 문서는 RTF, DOCX와 같은 편집 가능한 형식으로 저장됩니다.

​
시나리오 구현

이 항목에서 제공되는 코드 샘플은 Windows 전용입니다.
아래에서는 문서를 변환할 때 ABBYY FineReader Engine 12를 사용하는 권장 방법을 자세히 설명합니다. 제안된 방법은 이 용도에 가장 적합한 처리 설정을 사용합니다.
ABBYY FineReader Engine를 사용하려면 먼저 Engine 객체를 생성해야 합니다. Engine 객체는 ABBYY FineReader Engine 객체 계층 구조의 최상위 객체로, 다양한 전역 설정과 일부 처리 메서드, 그리고 다른 객체를 생성하는 메서드를 제공합니다.엔진 객체를 생성하려면 InitializeEngine 함수를 사용하십시오. 엔진 객체를 로드하는 다른 방법(Win)도 참조하십시오.

​
C#

public class EngineLoader : IDisposable
{
    public EngineLoader()
    {
        // FREngine.dll의 전체 경로, Customer Project ID,
        // 그리고 해당하는 경우 Online License 토큰 파일 경로와 Online License 비밀번호로 이 변수들을 초기화하세요
        string enginePath = "";
        string customerProjectId = "";
        string licensePath = "";
        string licensePassword = "";
        // FREngine.dll 라이브러리 로드
        dllHandle = LoadLibraryEx(enginePath, IntPtr.Zero, LOAD_WITH_ALTERED_SEARCH_PATH);
           
        try
        {
            if (dllHandle == IntPtr.Zero)
            {
                throw new Exception("로드할 수 없습니다: " + enginePath);
            }
            IntPtr initializeEnginePtr = GetProcAddress(dllHandle, "InitializeEngine");
            if (initializeEnginePtr == IntPtr.Zero)
            {
                throw new Exception("InitializeEngine 함수를 찾을 수 없습니다");
            }
            IntPtr deinitializeEnginePtr = GetProcAddress(dllHandle, "DeinitializeEngine");
            if (deinitializeEnginePtr == IntPtr.Zero)
            {
                throw new Exception("DeinitializeEngine 함수를 찾을 수 없습니다");
            }
            IntPtr dllCanUnloadNowPtr = GetProcAddress(dllHandle, "DllCanUnloadNow");
            if (dllCanUnloadNowPtr == IntPtr.Zero)
            {
                throw new Exception("DllCanUnloadNow 함수를 찾을 수 없습니다");
            }
            // 포인터를 델리게이트로 변환
            initializeEngine = (InitializeEngine)Marshal.GetDelegateForFunctionPointer(
                initializeEnginePtr, typeof(InitializeEngine));
            deinitializeEngine = (DeinitializeEngine)Marshal.GetDelegateForFunctionPointer(
                deinitializeEnginePtr, typeof(DeinitializeEngine));
            dllCanUnloadNow = (DllCanUnloadNow)Marshal.GetDelegateForFunctionPointer(
                dllCanUnloadNowPtr, typeof(DllCanUnloadNow));
            // InitializeEngine 함수 호출
            // Online License 파일 경로와 Online License 비밀번호 전달
            int hresult = initializeEngine(customerProjectId, licensePath, licensePassword, 
                "", "", false, ref engine);
            Marshal.ThrowExceptionForHR(hresult);
        }
        catch (Exception)
        {
            // FREngine.dll 라이브러리 해제
            engine = null;
            // FreeLibrary 호출 전 모든 객체 삭제
            GC.Collect();
            GC.WaitForPendingFinalizers();
            GC.Collect();
            FreeLibrary(dllHandle);
            dllHandle = IntPtr.Zero;
            initializeEngine = null;
            deinitializeEngine = null;
            dllCanUnloadNow = null;
            throw;
        }
    }
    // Kernel32.dll 함수
    [DllImport("kernel32.dll")]
    private static extern IntPtr LoadLibraryEx(string dllToLoad, IntPtr reserved, uint flags);
    private const uint LOAD_WITH_ALTERED_SEARCH_PATH = 0x00000008;
    [DllImport("kernel32.dll")]
    private static extern IntPtr GetProcAddress(IntPtr hModule, string procedureName);
    [DllImport("kernel32.dll")]
    private static extern bool FreeLibrary(IntPtr hModule);
    // FREngine.dll 함수
    [UnmanagedFunctionPointer(CallingConvention.StdCall, CharSet = CharSet.Unicode)]
    private delegate int InitializeEngine(string customerProjectId, string licensePath, 
        string licensePassword, string tempFolder, string dataFolder, bool isSharedCPUCoresMode, 
        ref FREngine.IEngine engine);
    [UnmanagedFunctionPointer(CallingConvention.StdCall)]
    private delegate int DeinitializeEngine();
    [UnmanagedFunctionPointer(CallingConvention.StdCall)]
    private delegate int DllCanUnloadNow();
    // private 변수
    private FREngine.IEngine engine = null;
    // FREngine.dll 핸들
    private IntPtr dllHandle = IntPtr.Zero;
    private InitializeEngine initializeEngine = null;
    private DeinitializeEngine deinitializeEngine = null;
    private DllCanUnloadNow dllCanUnloadNow = null;
}

​
C++ (COM)

// 이 변수들을 FREngine.dll 경로, FineReader Engine Customer Project ID,
// 그리고 해당하는 경우 Online License 토큰 경로 및 Online License 비밀번호로 초기화하십시오.
wchar_t* FreDllPath;
wchar_t* CustomerProjectId;
wchar_t* LicensePath;  // Online License를 사용하지 않는 경우, 이 변수들에 빈 string을 할당하십시오.
wchar_t* LicensePassword;
// FREngine.dll에 대한 HANDLE
static HMODULE libraryHandle = 0;
// 전역 FineReader 엔진 객체
FREngine::IEnginePtr Engine;
void LoadFREngine()
{
    if( Engine != 0 ) {
    // 이미 로드됨
    return;
    }
    // 1단계: FREngine.dll 로드
    if( libraryHandle == 0 ) {
        libraryHandle = LoadLibraryEx( FreDllPath, 0, LOAD_WITH_ALTERED_SEARCH_PATH );
        if( libraryHandle == 0 ) {
            throw L"ABBYY FineReader Engine 로드 중 오류 발생";
        }
    }
    // 2단계: 엔진 객체 가져오기
    typedef HRESULT ( STDAPICALLTYPE* InitializeEngineFunc )( BSTR, BSTR, BSTR, BSTR, 
        BSTR, VARIANT_BOOL, FREngine::IEngine** );
    InitializeEngineFunc pInitializeEngine =
    ( InitializeEngineFunc )GetProcAddress( libraryHandle, "InitializeEngine" );
    if( pInitializeEngine == 0 || pInitializeEngine( CustomerProjectId, LicensePath, 
        LicensePassword, L"", L"", VARIANT_FALSE, &Engine ) != S_OK ) {
    UnloadFREngine();
    throw L"ABBYY FineReader Engine 로드 중 오류 발생";
    }
}
ABBYY FineReader Engine에서는 Engine 객체의 LoadPredefinedProfile 메서드를 사용해 이 시나리오에 가장 적합한 모든 처리 설정을 로드할 수 있습니다. 이 메서드는 프로필 이름을 입력 매개변수로 받습니다. 자세한 내용은 Working with Profiles를 참조하세요.ABBYY FineReader Engine은 이 시나리오에 대해 2가지 설정 옵션을 지원합니다:

프로필 이름

설명

DocumentConversion_Accuracy

정확도에 최적화된 설정입니다:

  • 최고 품질. 글꼴 스타일 감지와 문서의 논리 구조 전체 합성을 활성화합니다.

DocumentConversion_Normal

처리 속도에 최적화된 설정입니다:

  • 최고 품질. 글꼴 스타일 감지와 문서의 논리 구조 전체 합성을 활성화합니다.
  • 이미지 방향은 보정되지 않습니다.
  • 문서 분석 과정이 빨라집니다.

​
C#

// 미리 정의된 프로필 로드
engine.LoadPredefinedProfile("DocumentConversion_Normal");

​
C++ (COM)

// 미리 정의된 프로필 로드
Engine->LoadPredefinedProfile( L"DocumentConversion_Normal" );
처리 설정을 변경하려면 적절한 Parameter 객체를 사용하세요. 자세한 내용은 아래의 Additional optimization for specific tasks를 참조하세요.
ABBYY FineReader Engine은 여러 페이지로 구성된 문서를 처리할 수 있는 FRDocument 객체를 제공합니다. 이 객체를 사용하면 원본 텍스트와 단, 글꼴, 스타일 등을 유지하면서 문서의 논리적 구성을 보존할 수 있습니다.단일 문서의 이미지를 로드하고 전처리하려면 FRDocument 객체를 생성한 다음 여기에 이미지를 추가해야 합니다. 다음 방법 중 하나를 사용할 수 있습니다:

​
C#

// 이미지 파일에서 FRDocument 객체 생성
FREngine.IFRDocument frDocument = engine.CreateFRDocumentFromImage( "C:\\MyImage.tif", null );

​
C++ (COM)

// 이미지 파일에서 FRDocument 객체 생성
FREngine::IFRDocumentPtr frDocument = Engine->CreateFRDocumentFromImage( L"C:\\MyImage.tif", 0 );
로드된 DocumentConversion_Normal 프로필을 사용한 이미지 전처리에는 방향 감지가 포함되지 않습니다. 이미지 방향을 자동으로 감지하려면 추가 Parameter를 설정하고 해당 객체를 전처리 함수에 전달해야 합니다. 자세한 내용은 아래의 Additional optimization for specific tasks를 참조하세요.
문서를 인식하려면 FRDocument 객체의 분석 및 인식 메서드를 사용하는 것이 좋습니다. 이 객체는 문서 분석, 인식, 합성을 위한 다양한 메서드를 제공합니다. 문서 분석, 인식, 합성을 한 번에 수행할 수 있는 가장 편리한 메서드는 Process 메서드입니다. 또한 이 메서드는 다중 프로세서 및 멀티코어 시스템의 동시 처리 기능을 가장 효율적으로 활용합니다. 하지만 Preprocess, Analyze, Recognize, Synthesize 메서드를 사용해 전처리, 분석, 인식, 합성을 순차적으로 수행할 수도 있습니다.

​
C#

// 문서를 분석, 인식 및 합성합니다
// 추가 매개변수는 처리 프로필에서 설정되므로 필요하지 않습니다
frDocument.Process( null );

​
C++ (COM)

// 문서를 분석, 인식 및 합성합니다
// 추가 매개변수는 처리 프로필에서 설정되므로 필요하지 않습니다
frDocument->Process( 0 );
인식된 문서를 저장하려면 FRDocument 객체의 Export 메서드를 사용하고, 매개변수 중 하나로 FileExportFormatEnum 상수를 지정하면 됩니다. 해당 내보내기 객체를 사용하면 기본 내보내기 매개변수를 변경할 수 있습니다. 자세한 내용은 아래의 특정 작업을 위한 추가 최적화를 참조하십시오.FRDocument 객체 사용을 마친 후에는 이 객체가 사용한 모든 리소스를 해제하십시오. IFRDocument::Close 메서드를 사용합니다.

​
C#

// 인식된 문서를 편집 가능한 형식(예: RTF)으로 저장합니다
frDocument.Export( "C:\\MyText.rtf", FREngine.FileExportFormatEnum.FEF_RTF, null );
// FRDocument 객체를 해제합니다
frDocument.Close();

​
C++ (COM)

// 인식된 문서를 편집 가능한 형식(예: RTF)으로 저장합니다
frDocument->Export( L"C:\\MyText.rtf", FREngine::FEF_RTF, 0 );
// FRDocument 객체를 해제합니다
frDocument->Close();
ABBYY FineReader Engine 사용을 마친 후에는 Engine 객체를 언로드해야 합니다. 이를 위해 내보낸 DeinitializeEngine 함수를 사용합니다.

​
C#

public class EngineLoader : IDisposable
{
    // FineReader Engine 언로드
    public void Dispose()
    {
        if (engine == null)
        {
            // Engine이 로드되지 않음
            return;
        }
        engine = null;
        // FreeLibrary 호출 전에 모든 객체 삭제
        GC.Collect();
        GC.WaitForPendingFinalizers();
        GC.Collect();
        int hresult = deinitializeEngine();
 
        hresult = dllCanUnloadNow();
        if (hresult == 0)
        {
            FreeLibrary(dllHandle);
        }
        dllHandle = IntPtr.Zero;
        initializeEngine = null;
        deinitializeEngine = null;
        dllCanUnloadNow = null;
        // 정리 후 예외 throw
        Marshal.ThrowExceptionForHR(hresult);
    }
    // Kernel32.dll 함수
    [DllImport("kernel32.dll")]
    private static extern IntPtr LoadLibraryEx(string dllToLoad, IntPtr reserved, uint flags);
    private const uint LOAD_WITH_ALTERED_SEARCH_PATH = 0x00000008;
    [DllImport("kernel32.dll")]
    private static extern IntPtr GetProcAddress(IntPtr hModule, string procedureName);
    [DllImport("kernel32.dll")]
    private static extern bool FreeLibrary(IntPtr hModule);
    // FREngine.dll 함수
    [UnmanagedFunctionPointer(CallingConvention.StdCall, CharSet = CharSet.Unicode)]
    private delegate int InitializeEngine( string customerProjectId, string LicensePath, string LicensePassword, , , , ref FREngine.IEngine engine);
    [UnmanagedFunctionPointer(CallingConvention.StdCall)]
    private delegate int DeinitializeEngine();
    [UnmanagedFunctionPointer(CallingConvention.StdCall)]
    private delegate int DllCanUnloadNow();
    // private 변수
    private FREngine.IEngine engine = null;
    // FREngine.dll 핸들
    private IntPtr dllHandle = IntPtr.Zero;
    private InitializeEngine initializeEngine = null;
    private DeinitializeEngine deinitializeEngine = null;
    private DllCanUnloadNow dllCanUnloadNow = null;
}

​
C++ (COM)

void UnloadFREngine()
{
 if( libraryHandle == 0 ) {
  return;
 }
 // Engine 객체 해제
 Engine = 0;
 // FineReader Engine 초기화 해제
 typedef HRESULT ( STDAPICALLTYPE* DeinitializeEngineFunc )();
 DeinitializeEngineFunc pDeinitializeEngine =
  ( DeinitializeEngineFunc )GetProcAddress( libraryHandle, "DeinitializeEngine" );
 if( pDeinitializeEngine == 0 || pDeinitializeEngine() != S_OK ) {
  throw L"ABBYY FineReader Engine 언로드 중 오류가 발생했습니다";
 }
 // 이제 FREngine.dll 라이브러리를 안전하게 해제할 수 있음
 FreeLibrary( libraryHandle );
 libraryHandle = 0;
}

​
필수 리소스

애플리케이션 실행에 필요한 파일 목록은 FREngineDistribution.csv 파일을 사용해 자동으로 만들 수 있습니다. 이 시나리오로 처리하려면 5열(RequiredByModule)에서 다음 값을 선택합니다: Core Core.Resources Opening Opening, Processing Processing Processing.OCR Processing.OCR, Processing.ICR Processing.OCR.NaturalLanguages Processing.OCR.NaturalLanguages, Processing.ICR.NaturalLanguages Export Export, Processing 표준 시나리오를 수정하는 경우 이에 맞게 필요한 모듈도 변경하십시오. 또한 인터페이스 언어, 인식 언어, 그리고 애플리케이션에서 사용하는 추가 기능도 지정해야 합니다(예: PDF 파일을 열어야 하는 경우 Opening.PDF, CJK languages 텍스트를 인식해야 하는 경우 Processing.OCR.CJK). 자세한 내용은 Working with the FREngineDistribution.csv File을 참조하십시오.

​
특정 작업을 위한 추가 최적화

아래는 문서를 편집 가능한 형식으로 변환하는 여러 단계에서 설정을 사용자 지정하는 방법에 대한 추가 정보가 포함된 도움말 항목의 개요입니다.
  • 스캔 - Windows 전용
    • 스캔
      문서 스캔을 위한 ABBYY FineReader Engine 시나리오에 대한 설명입니다.
  • 인식
    • 전처리, 분석, 인식 및 합성 매개변수 조정
      분석, 인식 및 합성 매개변수 객체를 사용하여 문서 처리를 사용자 지정하는 방법을 설명합니다.
    • 손글씨 인식
      DocumentConversion_*** 프로필에는 손글씨 또는 정자체 필기 텍스트 인식이 포함되어 있지 않습니다. 손글씨를 인식해야 하는 경우 PageAnalysisParams 객체의 DetectHandwritten 속성을 TRUE로 설정하십시오.
    • PageProcessingParams 객체
      이 객체를 사용하면 분석 및 인식 매개변수를 사용자 지정할 수 있습니다. 이 객체를 사용하여 감지할 이미지 및 텍스트 특성(반전 이미지, 방향, 바코드, 인식 언어, 인식 오류 허용 범위)을 지정할 수 있습니다.
    • SynthesisParamsForPage 객체
      이 객체에는 합성 중 페이지 서식을 복원하는 데 필요한 매개변수가 포함되어 있습니다.
    • SynthesisParamsForDocument 객체
      이 객체를 사용하면 문서 합성, 즉 구조와 서식 복원을 사용자 지정할 수 있습니다.
    • MultiProcessingParams 객체 - Linux 및 Windows에서 구현됨
      많은 수의 이미지를 처리할 때는 동시 처리가 유용할 수 있습니다. 이 경우 이미지 열기 및 전처리, Layout 분석, 인식, 내보내기 과정에서 처리 부하가 프로세서 코어에 분산되므로 처리 속도를 높일 수 있습니다.
      읽기 모드(동시 또는 순차)는 MultiProcessingMode 속성을 사용하여 설정합니다. RecognitionProcessesCount 속성은 시작할 수 있는 프로세스 수를 제어합니다.
  • 내보내기
    • 내보내기 매개변수 조정
      내보내기 매개변수 객체를 사용하여 문서 내보내기를 사용자 지정하는 방법을 설명합니다.
    • RTFExportParams 객체
      이 객체를 사용하면 RTF/DOCX/ODT 저장 형식 매개변수를 사용자 지정할 수 있습니다.
    • HTMLExportParams 객체
      이 객체를 사용하면 HTML 형식으로 내보내기를 사용자 지정할 수 있습니다.
    • PPTExportParams 객체
      PPTX 저장 형식 매개변수를 사용자 지정하기 위한 객체입니다.

​
참고 자료

기본 사용 시나리오 구현