ABBYY FineReader 엔진과 IronOCR 비교: .NET OCR

실제 언어 패키지 분할 현상

언어별로 패키지를 하나씩 사용하는 방식은 프로젝트 파일에 구체적인 변화를 가져옵니다. 예를 들어 5개 유럽 언어로 된 문서를 처리하는 애플리케이션의 경우, 패키지 매니페스트는 다음과 같습니다.

<PackageReference Include="RasterEdge.XImage.OCR" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.English" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.German" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.French" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.Spanish" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.Italian" Version="12.4.0" />

<PackageReference Include="RasterEdge.XImage.OCR" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.English" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.German" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.French" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.Spanish" Version="12.4.0" />
<PackageReference Include="XImage.OCR.Language.Italian" Version="12.4.0" />

코어 패키지와 언어 패키지 간의 버전 불일치는 런타임 초기화 오류를 발생시킵니다. RasterEdge.XImage.OCR이 12.4.0에 있고 XImage.OCR.Language.English이 12.3.0에 있을 때 - 부분 업데이트 후 현실적인 시나리오 - 라이브러리는 버전 동기화를 원인으로 명확히 식별되지 않는 오류와 함께 런타임에 실패합니다. 이제 CI/CD 파이프라인에는 6개의 개별 복원 작업과 6개의 독립적인 장애 지점이 있습니다. 글로벌 배포를 위해 아시아 언어를 추가하면 CJK 패키지가 추가됩니다. 중국어 간체, 중국어 번체, 일본어, 한국어 각각에 별도의 패키지가 필요하므로 10개 언어를 지원하는 애플리케이션은 11개의 개별 NuGet 종속성을 갖게 됩니다.

상세 기능 비교

XImage.OCR 접근 방식

XImage.OCR은 각 언어를 별도의 NuGet 패키지로 배포합니다. 핵심 설치 명령은 OCR 엔진만 설치합니다. 그런 다음 필요한 각 언어를 설치합니다.

# XImage.OCR: Install sequence for a multilingual application
dotnet add package RasterEdge.XImage.OCR
dotnet add package XImage.OCR.Language.English
dotnet add package XImage.OCR.Language.German
dotnet add package XImage.OCR.Language.French
dotnet add package XImage.OCR.Language.Spanish
dotnet add package XImage.OCR.Language.Italian
dotnet add package XImage.OCR.Language.Portuguese
dotnet add package XImage.OCR.Language.ChineseSimplified
dotnet add package XImage.OCR.Language.ChineseTraditional
dotnet add package XImage.OCR.Language.Japanese
# 10 languages = 11 package commands

# XImage.OCR: Install sequence for a multilingual application
dotnet add package RasterEdge.XImage.OCR
dotnet add package XImage.OCR.Language.English
dotnet add package XImage.OCR.Language.German
dotnet add package XImage.OCR.Language.French
dotnet add package XImage.OCR.Language.Spanish
dotnet add package XImage.OCR.Language.Italian
dotnet add package XImage.OCR.Language.Portuguese
dotnet add package XImage.OCR.Language.ChineseSimplified
dotnet add package XImage.OCR.Language.ChineseTraditional
dotnet add package XImage.OCR.Language.Japanese
# 10 languages = 11 package commands

코드 자체도 같은 복잡성을 반영합니다. 다국어 OCR을 설정하려면 모든 언어 패키지가 이미 설치되어 있어야 합니다. 라이브러리는 컴파일 시점에 이를 검증할 수 없습니다.

// XImage.OCR: Language codes must match installed packages exactly
// If XImage.OCR.Language.German is not installed, this fails at runtime

var ocrHandler = new OCRHandler();

// 라이선스 활성화 required before any OCR operation
RasterEdge.XImage.OCR.License.LicenseManager.SetLicense("your-license-key");

// Set multiple languages — each requires its own NuGet package installed
ocrHandler.Languages = new[] { "eng", "deu", "fra", "spa", "ita" };

string result = ocrHandler.Process(imagePath);

// XImage.OCR: Language codes must match installed packages exactly
// If XImage.OCR.Language.German is not installed, this fails at runtime

var ocrHandler = new OCRHandler();

// 라이선스 활성화 required before any OCR operation
RasterEdge.XImage.OCR.License.LicenseManager.SetLicense("your-license-key");

// Set multiple languages — each requires its own NuGet package installed
ocrHandler.Languages = new[] { "eng", "deu", "fra", "spa", "ita" };

string result = ocrHandler.Process(imagePath);

' XImage.OCR: Language codes must match installed packages exactly
' If XImage.OCR.Language.German is not installed, this fails at runtime

Dim ocrHandler As New OCRHandler()

' 라이선스 활성화 required before any OCR operation
RasterEdge.XImage.OCR.License.LicenseManager.SetLicense("your-license-key")

' Set multiple languages — each requires its own NuGet package installed
ocrHandler.Languages = New String() {"eng", "deu", "fra", "spa", "ita"}

Dim result As String = ocrHandler.Process(imagePath)

언어 패키지가 누락되었거나 버전이 잘못된 경우, 오류는 컴파일 시간이나 패키지 복원 시간이 아닌 OCR 호출 중 런타임에 발생합니다. 배포 파이프라인에서 이는 개발자 컴퓨터가 아닌 프로덕션 또는 사전 프로덕션 환경에서 문제를 발견하는 것을 의미합니다.

IronOCR 접근법

IronOCR 단일 패키지로 설치됩니다. 일반적인 서양 언어에 대한 언어 지원은 기본적으로 포함되어 있습니다. 추가 언어 팩은 동일한 단일 패키지 패턴을 따르는 선택적 패키지로 설치되지만, 처음부터 제대로 작동하는 상태에서 시작할 수 있다는 장점이 있습니다.

# IronOCR: Install everything in one command
dotnet add package IronOcr
# English included. Add specific language packs only when needed.
dotnet add package IronOcr.Languages.German

# IronOCR: Install everything in one command
dotnet add package IronOcr
# English included. Add specific language packs only when needed.
dotnet add package IronOcr.Languages.German

다중 언어 OCR 코드에서는 잘못된 언어 식별자로 인한 런타임 오류를 제거하는 문자열 코드가 아닌 타입 안전한 OcrLanguage 열거형 값을 사용합니다:

// IronOCR: Type-safe languages, single package
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.English;
ocr.AddSecondaryLanguage(OcrLanguage.German);
ocr.AddSecondaryLanguage(OcrLanguage.French);

var result = ocr.Read("multilingual-document.jpg");
Console.WriteLine(result.Text);

// IronOCR: Type-safe languages, single package
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.English;
ocr.AddSecondaryLanguage(OcrLanguage.German);
ocr.AddSecondaryLanguage(OcrLanguage.French);

var result = ocr.Read("multilingual-document.jpg");
Console.WriteLine(result.Text);

Imports IronOcr

' IronOCR: Type-safe languages, single package
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"

Dim ocr As New IronTesseract()
ocr.Language = OcrLanguage.English
ocr.AddSecondaryLanguage(OcrLanguage.German)
ocr.AddSecondaryLanguage(OcrLanguage.French)

Dim result = ocr.Read("multilingual-document.jpg")
Console.WriteLine(result.Text)

IronTesseract 설정 가이드에서는 언어 설정을 자세히 다룹니다. 이 다국어 사용법 안내는 여러 언어가 혼합된 문서에서 기본 언어와 보조 언어를 결합하는 방법을 설명합니다.

10개의 언어를 사용하는 응용 프로그램에 대해: XImage.OCR은 11개의 패키지가 필요하며, .csproj에 11개의 줄이 필요하며, 업데이트가 있을 때 11개의 모든 버전을 동기화하는 것이 필요합니다. IronOCR은 .csproj에서 1개의 패키지만 필요하며, 필요할 때 선택적으로 언어별 팩을 추가로 설치할 수 있습니다. 그러한 차이는 팀마다 더욱 커집니다.

XImage.OCR 접근 방식

XImage.OCR은 이미지를 Tesseract로 직접 전달합니다. 스캔된 송장은 2도 기울어져 있고, 스캐너 노이즈가 있으며, 해상도는 150 DPI입니다. 이 경우 스캔된 송장은 그대로 처리됩니다. OCRHandler에 이미지 수정에 대한 메서드가 없습니다:

// XImage.OCR: 아니요 preprocessing available
// A skewed, noisy, low-DPI scan goes straight to Tesseract

var ocrHandler = new OCRHandler();
ocrHandler.Language = "eng";

// Direct OCR on problematic image — skew, noise, and low resolution
// all degrade accuracy with no mitigation available in the library
string result = ocrHandler.Process(imagePath);

// To improve results, you would need:
// - External library (OpenCV.NET, ImageSharp, etc.)
// - 100-200 lines of deskew and noise-reduction code
// - Per-document-type tuning
// - Image processing expertise your OCR developer may not have

// XImage.OCR: 아니요 preprocessing available
// A skewed, noisy, low-DPI scan goes straight to Tesseract

var ocrHandler = new OCRHandler();
ocrHandler.Language = "eng";

// Direct OCR on problematic image — skew, noise, and low resolution
// all degrade accuracy with no mitigation available in the library
string result = ocrHandler.Process(imagePath);

// To improve results, you would need:
// - External library (OpenCV.NET, ImageSharp, etc.)
// - 100-200 lines of deskew and noise-reduction code
// - Per-document-type tuning
// - Image processing expertise your OCR developer may not have

' XImage.OCR: 아니요 preprocessing available
' A skewed, noisy, low-DPI scan goes straight to Tesseract

Dim ocrHandler As New OCRHandler()
ocrHandler.Language = "eng"

' Direct OCR on problematic image — skew, noise, and low resolution
' all degrade accuracy with no mitigation available in the library
Dim result As String = ocrHandler.Process(imagePath)

' To improve results, you would need:
' - External library (OpenCV.NET, ImageSharp, etc.)
' - 100-200 lines of deskew and noise-reduction code
' - Per-document-type tuning
' - Image processing expertise your OCR developer may not have

해결 방법은 별도의 이미지 처리 라이브러리를 가져와서 전처리 코드를 직접 작성하고, 라이브러리 업데이트 시에도 해당 코드를 유지 관리하는 것입니다. 이미 RasterEdge 생태계에 깊이 관여하고 있는 팀의 경우, 다른 RasterEdge SDK 구성 요소를 통해 일부 도구를 사용할 수 있지만, 이를 위해서는 추가 제품을 구매하고 통합해야 합니다.

IronOCR 접근법

IronOCR은 문서 로딩과 OCR 실행 사이에서 OcrInput에 체인 가능한 메서드로 전처리를 적용합니다. 외부 라이브러리가 필요하지 않습니다.

// IronOCR: 내장 전처리 기능 pipeline
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");

// Apply corrections in sequence
input.Deskew();              // Detect and correct rotation angle
input.DeNoise();             // Remove scanner artifacts and noise
input.Contrast();            // Enhance contrast for faded text
input.Binarize();            // Convert to clean black-and-white
input.EnhanceResolution(300); // Scale low-DPI images to 300 DPI

var result = new IronTesseract().Read(input);
Console.WriteLine(result.Text);
Console.WriteLine($"Confidence: {result.Confidence}%");

// IronOCR: 내장 전처리 기능 pipeline
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");

// Apply corrections in sequence
input.Deskew();              // Detect and correct rotation angle
input.DeNoise();             // Remove scanner artifacts and noise
input.Contrast();            // Enhance contrast for faded text
input.Binarize();            // Convert to clean black-and-white
input.EnhanceResolution(300); // Scale low-DPI images to 300 DPI

var result = new IronTesseract().Read(input);
Console.WriteLine(result.Text);
Console.WriteLine($"Confidence: {result.Confidence}%");

Imports IronOcr

' IronOCR: 내장 전처리 기능 pipeline
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"

Using input As New OcrInput()
    input.LoadImage("low-quality-scan.jpg")

    ' Apply corrections in sequence
    input.Deskew()              ' Detect and correct rotation angle
    input.DeNoise()             ' Remove scanner artifacts and noise
    input.Contrast()            ' Enhance contrast for faded text
    input.Binarize()            ' Convert to clean black-and-white
    input.EnhanceResolution(300) ' Scale low-DPI images to 300 DPI

    Dim result = New IronTesseract().Read(input)
    Console.WriteLine(result.Text)
    Console.WriteLine($"Confidence: {result.Confidence}%")
End Using

이미지 품질 보정 가이드는 전체 전처리 필터 세트를 다룹니다. 방향별 보정을 위해 이미지 방향 보정 가이드 와 페이지 회전 감지 기능이 다양한 각도의 문서를 처리합니다.

문서 전처리 과정이 실제 문서에 미치는 실질적인 영향은 매우 큽니다. Tesseract를 사용하여 150 DPI 해상도에 5도 기울어진 스캔 문서를 전처리 없이 분석할 경우, 60~75% 범위의 정확도를 얻을 수 있습니다. 기울기 보정 및 해상도 향상을 통해 300 DPI 해상도의 동일한 문서를 회전 보정하면 93~97%의 정확도를 달성할 수 있습니다. XImage.OCR은 외부 코드 없이는 그 격차를 해소할 수 없습니다.IronOCR 5번의 메서드 호출로 이를 종료합니다.

자유로운 대안의 격차

NuGet 에서 제공되는 charlesw/tesseract 래퍼는 800만 건 이상의 다운로드를 기록했으며, 활발한 유지 관리가 이루어지고 있고, Apache 2.0 라이선스가 적용되어 상업적 용도로 무료로 사용할 수 있습니다. 두 프로그램 모두 동일한 Tesseract 엔진을 사용하기 때문에 본질적으로 XImage.OCR과 동일한 OCR 출력 결과를 제공합니다. 차이점은 다음과 같습니다.

• 언어 지원: 무료 tessdata는 100개 이상의 언어를 지원합니다. XImage.OCR은 유료 패키지로 약 15가지 기능을 지원합니다.
• 커뮤니티: charlesw/tesseract에는 3,000개 이상의 Stack Overflow 질문과 방대한 커뮤니티 문서가 있습니다. XImage.OCR에는 100개 미만의 항목이 있습니다.
• 전처리: 두 라이브러리 모두 내장된 전처리 기능을 제공하지 않으며, 이미지를 테서랙트에 직접 전달합니다.
• 스레딩: 둘 다 동일한 스레드 안전성 제약 조건(스레드별 인스턴스 필요)을 갖습니다.

상용 제품이 무료 대안과 마찬가지로 지원하는 언어 수가 적고 , 커뮤니티 규모 가 작으며 , 전처리 기능의 한계와 스레딩 모델이 동일하다면, 벤더 지원 및 RasterEdge 생태계 통합 외에는 상용 제품의 가치를 명확하게 설명하기 어렵습니다.

IronOCR 상업적 대안으로서의 가능성을 제시합니다.

IronOCR 자동 전처리, 네이티브 PDF 지원, 스레드 안전 설계 및 크로스 플랫폼 배포와 같은 XImage.OCR이나 무료 래퍼에서 제공하지 않는 기능을 통해 상용 가격을 정당화합니다. $999 Lite 라이선스는 일회성 영구 구매입니다. 문제는 상용 OCR에 비용을 지불할 가치가 있는지 여부가 아닙니다. 상용 OCR은 종종 그만한 가치가 있습니다. 문제는 그 돈으로 무엇을 얻을 수 있느냐는 것입니다.

// What theIronOCR Lite license buys vs what commercial pricing buys with XImage.OCR

// IronOCR: Preprocessing, PDF, thread safety, cross-platform in one call
var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadPdf("scanned-invoice.pdf");   // Native PDF — no extra SDK
input.Deskew();                          // Built-in preprocessing
input.DeNoise();                         // 아니요 external library needed
var result = ocr.Read(input);
result.SaveAsSearchablePdf("output.pdf"); // Searchable PDF output
Console.WriteLine($"Confidence: {result.Confidence}%");

// XImage.OCR: Same Tesseract core, no preprocessing, no PDF, not thread-safe
// Requires purchasing and integrating RasterEdge PDF SDK for PDF operations

// What theIronOCR Lite license buys vs what commercial pricing buys with XImage.OCR

// IronOCR: Preprocessing, PDF, thread safety, cross-platform in one call
var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadPdf("scanned-invoice.pdf");   // Native PDF — no extra SDK
input.Deskew();                          // Built-in preprocessing
input.DeNoise();                         // 아니요 external library needed
var result = ocr.Read(input);
result.SaveAsSearchablePdf("output.pdf"); // Searchable PDF output
Console.WriteLine($"Confidence: {result.Confidence}%");

// XImage.OCR: Same Tesseract core, no preprocessing, no PDF, not thread-safe
// Requires purchasing and integrating RasterEdge PDF SDK for PDF operations

Imports IronOcr

' What theIronOCR Lite license buys vs what commercial pricing buys with XImage.OCR

' IronOCR: Preprocessing, PDF, thread safety, cross-platform in one call
Dim ocr As New IronTesseract()
Using input As New OcrInput()
    input.LoadPdf("scanned-invoice.pdf")   ' Native PDF — no extra SDK
    input.Deskew()                         ' Built-in preprocessing
    input.DeNoise()                        ' 아니요 external library needed
    Dim result = ocr.Read(input)
    result.SaveAsSearchablePdf("output.pdf") ' Searchable PDF output
    Console.WriteLine($"Confidence: {result.Confidence}%")
End Using

' XImage.OCR: Same Tesseract core, no preprocessing, no PDF, not thread-safe
' Requires purchasing and integrating RasterEdge PDF SDK for PDF operations

이미지에서 텍스트를 읽는 튜토리얼 과 C# Tesseract OCR 가이드 문서에는 모든 기능이 자세히 설명되어 있습니다.IronOCR기본적인 Tesseract 래퍼보다 특히 더 나은 이유를 평가하는 팀을 위해, IronOCR 사용하는 이유와 Tesseract를 사용하지 않는 이유에 대한 자세한 기술적 차이점을 설명하는 전용 페이지가 있습니다.

XImage.OCR 접근 방식

XImage.OCR은 PDF 파일을 기본적으로 처리하지 않습니다. 이 워크플로는 PDF 페이지를 이미지로 렌더링하기 위해 별도의 상용 제품인 RasterEdge PDF SDK가 필요하며, XImage.OCR은 임시 파일을 통해 한 번에 한 페이지씩 처리합니다.

// XImage.OCR: PDF requires RasterEdge PDF SDK (additional purchase)
// Workflow: PDF -> render to image -> temp file -> OCR -> delete temp file

var pdfDocument = new PDFDocument(pdfPath); // Requires separate RasterEdge SDK

var results = new System.Text.StringBuilder();
var ocrHandler = new OCRHandler();
ocrHandler.Language = "eng";

for (int i = 0; i < pdfDocument.PageCount; i++)
{
    // Render PDF page to image at 200 DPI
    var pageImage = pdfDocument.RenderPage(i, 200);

    string tempPath = Path.GetTempFileName() + ".png";
    pageImage.Save(tempPath);

    try
    {
        string pageText = ocrHandler.Process(tempPath);
        results.AppendLine($"--- Page {i + 1} ---");
        results.AppendLine(pageText);
    }
    finally
    {
        File.Delete(tempPath); // Manual cleanup required
    }
}

return results.ToString();

// XImage.OCR: PDF requires RasterEdge PDF SDK (additional purchase)
// Workflow: PDF -> render to image -> temp file -> OCR -> delete temp file

var pdfDocument = new PDFDocument(pdfPath); // Requires separate RasterEdge SDK

var results = new System.Text.StringBuilder();
var ocrHandler = new OCRHandler();
ocrHandler.Language = "eng";

for (int i = 0; i < pdfDocument.PageCount; i++)
{
    // Render PDF page to image at 200 DPI
    var pageImage = pdfDocument.RenderPage(i, 200);

    string tempPath = Path.GetTempFileName() + ".png";
    pageImage.Save(tempPath);

    try
    {
        string pageText = ocrHandler.Process(tempPath);
        results.AppendLine($"--- Page {i + 1} ---");
        results.AppendLine(pageText);
    }
    finally
    {
        File.Delete(tempPath); // Manual cleanup required
    }
}

return results.ToString();

Imports System.Text
Imports System.IO

' XImage.OCR: PDF requires RasterEdge PDF SDK (additional purchase)
' Workflow: PDF -> render to image -> temp file -> OCR -> delete temp file

Dim pdfDocument As New PDFDocument(pdfPath) ' Requires separate RasterEdge SDK

Dim results As New StringBuilder()
Dim ocrHandler As New OCRHandler()
ocrHandler.Language = "eng"

For i As Integer = 0 To pdfDocument.PageCount - 1
    ' Render PDF page to image at 200 DPI
    Dim pageImage = pdfDocument.RenderPage(i, 200)

    Dim tempPath As String = Path.GetTempFileName() & ".png"
    pageImage.Save(tempPath)

    Try
        Dim pageText As String = ocrHandler.Process(tempPath)
        results.AppendLine($"--- Page {i + 1} ---")
        results.AppendLine(pageText)
    Finally
        File.Delete(tempPath) ' Manual cleanup required
    End Try
Next

Return results.ToString()

이 패턴은 임시 파일 관리, 명시적인 정리 작업, 그리고 두 번째 상용 제품에 대한 의존성을 도입합니다. 이 패턴의 200 DPI 렌더링 목표는 Tesseract의 정확도가 최적인 300 DPI 임계값보다 낮아 품질에 더욱 영향을 미칩니다. XImage.OCR을 PDF 워크플로우에 사용하는 팀은 사실상 다른 곳에서는 한 가지 제품으로 해결할 수 있는 문제를 해결하기 위해 두 가지 제품에 비용을 지불하는 셈입니다.

IronOCR 접근법

IronOCR PDF 파일을 기본적으로 지원합니다. 중간 단계도 없고, 임시 파일도 없고, 별도의 SDK도 필요 없습니다.

// IronOCR: Native PDF input, no extra dependencies
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

using var input = new OcrInput();
input.LoadPdf("scanned-invoice.pdf");  // Direct PDF loading
var result = new IronTesseract().Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");
Console.WriteLine(result.Text);

// IronOCR: Native PDF input, no extra dependencies
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

using var input = new OcrInput();
input.LoadPdf("scanned-invoice.pdf");  // Direct PDF loading
var result = new IronTesseract().Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");
Console.WriteLine(result.Text);

Imports IronOcr

' IronOCR: Native PDF input, no extra dependencies
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"

Using input As New OcrInput()
    input.LoadPdf("scanned-invoice.pdf")  ' Direct PDF loading
    Dim result = New IronTesseract().Read(input)
    result.SaveAsSearchablePdf("searchable-output.pdf")
    Console.WriteLine(result.Text)
End Using

암호로 보호된 PDF에는 매개변수 하나가 추가됩니다.

using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var result = new IronTesseract().Read(input);

using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var result = new IronTesseract().Read(input);

Imports IronOcr

Using input As New OcrInput()
    input.LoadPdf("encrypted.pdf", Password: "secret")
    Dim result = New IronTesseract().Read(input)
End Using

PDF 입력 가이드 에서는 여러 페이지로 구성된 PDF, 페이지 범위 선택 및 DPI 구성에 대해 다룹니다. 검색 가능한 PDF 가이드 문서에는 출력 옵션이 나와 있습니다. 문서 아카이빙 파이프라인을 구축하는 팀을 위해 C#을 사용한 PDF OCR 활용 사례 페이지에서 전체 워크플로를 다룹니다.

패키지 관리는 유지 관리 부담이 되었습니다.

XImage.OCR 언어 패키지 두세 개로 시작했던 팀들은 애플리케이션이 8개 또는 10개 언어로 확장될 때 전환점을 맞이하는 경우가 많습니다. 프로젝트 파일에는 현재 버전 동기화가 필요한 패키지 참조가 9~11개 있습니다. 핵심 패키지만 업데이트한 개발자가 아무런 공지 없이 모든 언어의 OCR 기능을 망가뜨렸습니다. CI/CD 파이프라인이 간헐적으로 실패하는 이유는 패키지 캐시가 이전 버전의 언어 팩을 복원하기 때문입니다. 이 단계에서는 버전 동기화 오버헤드가 언어별 패키징이 제공하는 이점을 초과하므로 단일 패키지 솔루션으로 통합하는 것이 명백한 아키텍처적 결정이 됩니다.

실제 문서 품질을 위해서는 사전 처리가 필수적입니다.

XImage.OCR을 제어된 고품질 스캔 데이터에 적용하는 팀은 초기에는 정확도 문제를 발견하지 못합니다. 문제는 문서 파이프라인이 확장될 때 발생합니다. 모바일 사진 업로드, 기존 아카이브 스캔, 팩스 문서, 수기로 작성 후 150 DPI로 스캔한 양식 등이 여기에 해당합니다. 전처리 없이 이러한 입력에 대한 Tesseract의 정확도는 어떤 래퍼를 사용하더라도 좋지 않습니다. 그러면 팀은 자체 전처리 라이브러리 통합을 구축하고 유지 관리할지, 아니면 전처리 기능이 내장된 솔루션으로 전환할지 선택해야 합니다. IronOCR에 내장된 기울기 보정, 노이즈 제거 및 해상도 향상 기능은 외부 의존성을 완전히 없애고 OCR 개발자가 이미지 처리 전문 지식을 갖추지 않아도 정확도를 향상시켜 줍니다.

PDF 워크플로를 사용하려면 SDK를 하나 더 구매해야 합니다.

팀의 문서 파이프라인이 이미지 파일에서 PDF로 확장될 때(문서 처리 애플리케이션에서 가장 일반적인 문제 발생 경로) XImage.OCR은 두 번째 RasterEdge 제품 구매를 강제합니다. PDF SDK는 별도의 상업용 라이선스가 필요합니다. OCR 기능을 상용 가격으로 구매하는 팀들은 Enterprise 환경에서 가장 흔한 문서 형식에 OCR 기능을 적용하기 위한 두 번째 상용 라이선스 비용을 예산에 반영하지 않았습니다. IronOCR의 기본 PDF 지원 기능 덕분에 이러한 우려는 처음부터 무의미해지며, PDF OCR 예제는 통합이 얼마나 직접적인지 정확하게 보여줍니다.

크로스 플랫폼 배포가 필수 요건이 되었습니다.

XImage.OCR의 윈도우 기반 아키텍처는 리눅스 또는 macOS개발 환경에서의 컨테이너 배포를 고려할 때 심각한 제약 조건이 됩니다. 최신 .NET 개발 팀은 로컬 개발을 위해 Docker를 사용하고 Linux기반 컨테이너 인프라에 배포합니다. Windows전용 OCR 라이브러리는 해당 스택에 참여할 수 없습니다.IronOCR Windows, Linux, macOS및 Docker를 동일한 패키지에서 지원하며 별도의 설정 변경이 필요하지 않습니다. Docker 배포 가이드 와 Linux 배포 가이드에서 설정 방법을 자세히 설명합니다.

스레드 안전성으로 인해 서버 애플리케이션의 처리량이 제한됩니다.

서버 애플리케이션에서 OCR을 사용하거나, 배치 작업을 처리하거나, 동시 HTTP 요청을 처리하려면 멀티스레딩이 필요합니다. XImage.OCR의 스레드별 핸들러 모델은 각 동시 스레드가 자체 Tesseract 엔진 인스턴스를 로드하여 언어별, 스레드별로 40~100MB의 메모리를 소비함을 의미합니다. 5개 언어로 된 문서를 처리하는 4스레드 서버는 OCR 처리기 인스턴스에만 약 900MB~1.2GB의 부하를 발생시킵니다. IronOCR의 스레드 안전 설계는 모든 스레드에서 단일 인스턴스를 공유합니다. 이 단일 인스턴스는 메모리 사용량을 늘리지 않고 동시 요청을 처리합니다. 프로덕션 환경에서 메모리나 처리량 한계에 부딪히는 팀은 종종 그 원인을 이러한 아키텍처 차이에서 찾습니다.

OCRHandler를 IronTesseract로 교체

주요 코드 대체는 간단합니다. OCRHandler를 IronTesseract로 대체하고, 문자열 언어 코드("eng", "deu")를 타입 안전한 OcrLanguage 열거형 값으로 대체하며, 이미지 로딩을 OcrInput에 래핑합니다. 라이선스 활성화가 LicenseManager.SetLicense()에서 IronOcr.License.LicenseKey 정적 속성으로 이동하여, 환경 변수에서 설정하면 배포 안전성이 향상됩니다:

// Before: XImage.OCR
RasterEdge.XImage.OCR.License.LicenseManager.SetLicense("your-key");
var ocrHandler = new OCRHandler();
ocrHandler.Language = "eng";
string text = ocrHandler.Process(imagePath);

// After: IronOCR
IronOcr.License.LicenseKey = Environment.GetEnvironmentVariable("IRONOCR_LICENSE");
var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadImage(imagePath);
var result = ocr.Read(input);
string text = result.Text;

// Before: XImage.OCR
RasterEdge.XImage.OCR.License.LicenseManager.SetLicense("your-key");
var ocrHandler = new OCRHandler();
ocrHandler.Language = "eng";
string text = ocrHandler.Process(imagePath);

// After: IronOCR
IronOcr.License.LicenseKey = Environment.GetEnvironmentVariable("IRONOCR_LICENSE");
var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadImage(imagePath);
var result = ocr.Read(input);
string text = result.Text;

Imports System
Imports IronOcr

' Before: XImage.OCR
RasterEdge.XImage.OCR.License.LicenseManager.SetLicense("your-key")
Dim ocrHandler As New OCRHandler()
ocrHandler.Language = "eng"
Dim text As String = ocrHandler.Process(imagePath)

' After: IronOCR
IronOcr.License.LicenseKey = Environment.GetEnvironmentVariable("IRONOCR_LICENSE")
Dim ocr As New IronTesseract()
Using input As New OcrInput()
    input.LoadImage(imagePath)
    Dim result = ocr.Read(input)
    text = result.Text
End Using

이미지 입력에 대한 전체 가이드는 파일 경로, 바이트 배열, 스트림 및 URL을 포함한 모든 입력 유형을 다룹니다.

기존에 전처리 기능이 없었던 곳에 전처리 기능 추가

XImage.OCR에서 마이그레이션하는 팀은 이전에는 사용할 수 없었던 전처리 기능을 즉시 추가할 수 있는 기회를 갖게 됩니다. 이번 마이그레이션은 단순히 클래스 이름만 바꾸는 것이 아니라, 더 나은 대안이 없었기에 묵묵히 받아들여왔던 정확성 문제를 해결할 수 있는 기회입니다. 입력값을 불러온 후 문서 유형에 맞는 필터를 추가하세요.

using var input = new OcrInput();
input.LoadImage(imagePath);

// Add these lines immediately after loading — no other changes needed
input.Deskew();
input.DeNoise();
input.EnhanceResolution(300);

var result = new IronTesseract().Read(input);

using var input = new OcrInput();
input.LoadImage(imagePath);

// Add these lines immediately after loading — no other changes needed
input.Deskew();
input.DeNoise();
input.EnhanceResolution(300);

var result = new IronTesseract().Read(input);

Imports IronOcr

Using input As New OcrInput()
    input.LoadImage(imagePath)

    ' Add these lines immediately after loading — no other changes needed
    input.Deskew()
    input.DeNoise()
    input.EnhanceResolution(300)

    Dim result = New IronTesseract().Read(input)
End Using

이미지 필터 튜토리얼은 특정 문서 품질 문제에 적용할 필터에 대한 지침을 제공합니다. 문서 품질이 일정하지 않은 경우에만 전처리 작업을 적용하십시오. 깨끗하고 고해상도 스캔 이미지는 전처리의 이점을 누릴 수 없으며, 오히려 추가 단계로 인해 처리 시간이 늘어납니다.

패키지 목록 간소화

프로젝트에서 모든 XImage.OCR 패키지를 제거하세요. 여러 언어가 설치된 애플리케이션의 경우, 패키지 제거 과정이 가장 오래 걸리는 부분입니다.

# Remove all XImage.OCR packages
dotnet remove package RasterEdge.XImage.OCR
dotnet remove package XImage.OCR.Language.English
dotnet remove package XImage.OCR.Language.German
dotnet remove package XImage.OCR.Language.French
# ... remove all language packages

# Add IronOCR
dotnet add package IronOcr

# Remove all XImage.OCR packages
dotnet remove package RasterEdge.XImage.OCR
dotnet remove package XImage.OCR.Language.English
dotnet remove package XImage.OCR.Language.German
dotnet remove package XImage.OCR.Language.French
# ... remove all language packages

# Add IronOCR
dotnet add package IronOcr

CI/CD 파이프라인을 업데이트하여 여러 번의 복원 작업을 제거하고 패키지 종속성 검증 단계를 간소화합니다. 버전 동기화 로직은 자동화되어 있다면 완전히 삭제할 수 있습니다.

영역 기반 OCR 처리

XImage.OCR은 ProcessRegion(imagePath, rectangle)를 통해 지역 처리를 노출합니다. IronOCR은 입력 로딩 시간에 CropRectangle를 통해 이를 처리합니다:

//IronOCR region-based OCR
var region = new CropRectangle(x: 0, y: 0, width: 600, height: 100);
using var input = new OcrInput();
input.LoadImage("invoice.jpg", region);
var text = new IronTesseract().Read(input).Text;

//IronOCR region-based OCR
var region = new CropRectangle(x: 0, y: 0, width: 600, height: 100);
using var input = new OcrInput();
input.LoadImage("invoice.jpg", region);
var text = new IronTesseract().Read(input).Text;

Imports IronOcr

Dim region As New CropRectangle(x:=0, y:=0, width:=600, height:=100)
Using input As New OcrInput()
    input.LoadImage("invoice.jpg", region)
    Dim text As String = New IronTesseract().Read(input).Text
End Using

영역 기반 OCR 가이드 및 영역 자르기 예시 문서는 송장 및 양식과 같은 고정 레이아웃 문서에 대한 접근 방식을 설명합니다.