메인 콘텐츠로 건너뛰기
이 시나리오는 문서에서 가능한 모든 데이터를 추출해 구조화된 형태로 저장하는 데 사용됩니다. 결과물은 문서 구조를 나타내는 JSON 파일입니다. 이 파일에는 인쇄 텍스트와 손글씨 텍스트, 표, 바코드, 체크마크, 이미지 등 문서의 모든 객체가 위치 정보와 속성과 함께 저장됩니다. 이 형식은 후속 처리, 데이터베이스 저장, 또는 다른 애플리케이션과의 통합에 적합합니다. 이 시나리오에서 문서는 여러 처리 단계를 거칩니다.
  1. 스캔한 이미지 또는 사진의 전처리
스캐너나 디지털 카메라로 얻은 이미지는 광학 인식을 수행하기 전에 일부 보정이 필요할 수 있습니다. 예를 들어, 노이즈가 있거나 텍스트 줄이 왜곡된 이미지는 광학 인식이 제대로 이루어지도록 보정해야 합니다.
  1. 문서의 모든 데이터를 구조화된 방식으로 추출
레이아웃 분석 과정에서는 이미지에서 다양한 객체를 감지해 해당 유형의 블록으로 분류합니다. 각 블록은 해당 유형에 가장 적합한 설정으로 인식됩니다. 합성 과정에서는 문서의 논리적 구조를 일관된 방식으로 복원합니다. 복잡한 레이아웃에서도 텍스트 순서는 사람이 읽는 방식과 비슷하게 유지됩니다. 따라서 동일한 문서를 다시 인식하더라도 텍스트 순서는 동일하게 유지됩니다.
  1. 구조화된 형식으로 내보내기
인식된 문서는 JSON 또는 XML로 저장됩니다.

시나리오 구현

이 항목에 제공된 코드 샘플은 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를 사용하지 않는 경우 이 변수들에 빈 문자열을 할당하십시오.
wchar_t* LicensePassword;
// FREngine.dll에 대한 HANDLE
static HMODULE libraryHandle = 0;
// 전역 FineReader Engine 객체
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를 참조하세요.이 시나리오에 필요한 설정은 미리 정의된 DataExtraction 프로필에 포함되어 있습니다.
  • 레이아웃 분석과 인식에서 속도보다 정확도를 우선합니다.
  • 손글씨 텍스트와 품질이 낮은 작은 텍스트 영역을 포함해 이미지의 모든 텍스트를 감지합니다.
  • 표, 체크마크, 바코드를 감지합니다.
  • 문서의 논리 구조를 완전히 재구성합니다.

C#

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

C++ (COM)

// 미리 정의된 프로필 로드
Engine->LoadPredefinedProfile( L"DataExtraction" );
처리 설정을 변경하려면 해당 Parameter 객체를 사용하세요. 자세한 내용은 아래의 Additional optimization 섹션을 참조하세요.
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 );
문서를 인식하려면 FRDocument 객체의 분석 및 인식 메서드를 사용하는 것이 좋습니다. 이 객체는 문서 분석, 인식, 합성을 위한 다양한 메서드를 제공합니다. 문서 분석, 인식, 합성을 한 번에 수행하는 가장 편리한 메서드는 Process 메서드입니다. 또한 이 메서드는 다중 프로세서 및 멀티코어 시스템의 동시 처리 기능을 가장 효율적으로 활용합니다. 하지만 Preprocess, Analyze, Recognize, Synthesize 메서드를 사용해 전처리, 분석, 인식, 합성을 순차적으로 수행할 수도 있습니다.

C#

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

C++ (COM)

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

C#

// 인식된 문서를 구조화된 형식으로 저장합니다
frDocument.Export( "C:\\Data.json", FREngine.FileExportFormatEnum.FEF_JSON, null );
// FRDocument 객체를 해제합니다
frDocument.Close();

C++ (COM)

// 인식된 문서를 구조화된 형식으로 저장합니다
frDocument->Export( L"C:\\Data.json", FREngine::FEF_JSON, 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 언어 텍스트를 인식해야 하는 경우 Processing.OCR.CJK). 자세한 내용은 Working with the FREngineDistribution.csv File을 참조하십시오.

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

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

참고 항목

기본 사용 시나리오 구현하기