.NET OCR SDK: C#용 텍스트 인식 라이브러리

IronOCR가 귀하의 프로젝트에 적합한 .NET OCR SDK인 이유는?

텍스트 인식을 처음부터 구축하려면 이미지 전처리 파이프라인, 언어 데이터 파일, 스레딩 모델, 출력 파싱을 관리해야 합니다. 첫 단어를 추출하기 전에 몇 달의 작업이 필요합니다. IronOCR는 팀이 몇 분 안에 프로젝트에 투입할 수 있는 전투 테스트된 엔진을 제공하여 그러한 부담을 없앱니다.

원초적인 Tesseract 바인딩과 구별되는 주요 기능:

• 125개 이상의 언어와 스크립트를 포함한 필기 텍스트 인식
• 내장된 필터: 노이즈 제거, 기울어짐 보정, 이진화, 해상도 향상, 대비 보정
• 바코드 및 QR 코드 탐지, 동일한 읽기 패스 내에서
• 보관 워크플로우를 위한 보이지 않는 텍스트 레이어가 포함된 검색 가능한 PDF 생성
• 고처리량 파이프라인을 위한 비동기 및 병렬 배치 처리
• 처리 시간을 줄이기 위한 특정 페이지 영역을 지정하는 영역 OCR
• Windows, Linux, macOS, Docker, Azure에서의 크로스 플랫폼 지원

Tesseract OCR 프로젝트 문서에 따르면, 원래의 Tesseract는 언어 팩, DPI 설정, 출력 모드에 대해 수동 구성을 필요로 합니다. IronOCR는 모든 것을 자동 처리하여 추출된 텍스트가 무엇을 의미하는지에 초점을 맞출 수 있도록 합니다.

IronOCR .NET SDK를 어떻게 설치합니까?

설치는 표준 .NET 패키지 관리자 NuGet을 통해 이루어집니다. 프로젝트 디렉토리에서 다음 명령어를 실행하세요.

Install-Package IronOcr

Visual Studio 사용자는 NuGet 패키지 관리자 GUI에서 IronOcr를 검색하여 설치하세요. 메뉴얼 DLL 참조를 포함한 전체 설치 옵션은 IronOCR 설치 문서를 참조하세요.

설치 후, 라이선스 키를 응용 프로그램 시작 시 또는 appsettings.json에 추가하세요. 모든 기능을 시험하는 동안 잠금 해제하는 시험 키를 받기 위해 무료 체험을 시작할 수 있습니다.

using IronOcr;

// Minimal smoke test -- reads a single image and prints extracted text
var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadImage("sample.png");
var result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;

// Minimal smoke test -- reads a single image and prints extracted text
var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadImage("sample.png");
var result = ocr.Read(input);
Console.WriteLine(result.Text);

이미지와 PDF에서 C#으로 텍스트를 어떻게 추출합니까?

핵심 추출 패턴은 모든 입력 유형에 대해 일관됩니다. IronTesseract 인스턴스를 생성하고, OcrInput 객체에 콘텐츠를 로드하고 Read()을 호출합니다. IronOCR는 파일 확장자로부터 형식을 자동 감지하므로 동일한 코드 경로가 JPEG, PNG, TIFF, BMP, 다중 페이지 PDF를 처리합니다.

using IronOcr;

// Reusable OCR service encapsulating the IronTesseract engine
public class OcrService
{
    private readonly IronTesseract _ocr = new IronTesseract();

    public string ExtractText(string filePath)
    {
        using var input = new OcrInput();

        // LoadPdf for PDF files; LoadImage for raster formats
        if (filePath.EndsWith(".pdf", StringComparison.OrdinalIgnoreCase))
            input.LoadPdf(filePath);
        else
            input.LoadImage(filePath);

        return _ocr.Read(input).Text;
    }

    public async Task<string> ExtractTextAsync(string filePath)
    {
        using var input = new OcrInput();

        if (filePath.EndsWith(".pdf", StringComparison.OrdinalIgnoreCase))
            input.LoadPdf(filePath);
        else
            input.LoadImage(filePath);

        var result = await _ocr.ReadAsync(input);
        return result.Text;
    }
}

using IronOcr;

// Reusable OCR service encapsulating the IronTesseract engine
public class OcrService
{
    private readonly IronTesseract _ocr = new IronTesseract();

    public string ExtractText(string filePath)
    {
        using var input = new OcrInput();

        // LoadPdf for PDF files; LoadImage for raster formats
        if (filePath.EndsWith(".pdf", StringComparison.OrdinalIgnoreCase))
            input.LoadPdf(filePath);
        else
            input.LoadImage(filePath);

        return _ocr.Read(input).Text;
    }

    public async Task<string> ExtractTextAsync(string filePath)
    {
        using var input = new OcrInput();

        if (filePath.EndsWith(".pdf", StringComparison.OrdinalIgnoreCase))
            input.LoadPdf(filePath);
        else
            input.LoadImage(filePath);

        var result = await _ocr.ReadAsync(input);
        return result.Text;
    }
}

서비스를 사용하는 최상위 진입점:

using IronOcr;

var service = new OcrService();
string text = await service.ExtractTextAsync("invoice.pdf");
Console.WriteLine(text);

using IronOcr;

var service = new OcrService();
string text = await service.ExtractTextAsync("invoice.pdf");
Console.WriteLine(text);

IronTesseract 인스턴스는 스레드 안전성을 가지며 재사용을 위해 설계되었습니다. 애플리케이션 시작 시 한 번 생성하십시오 (예: ASP.NET Core에서의 의존성 주입을 통해) 요청 당 인스턴스를 생성하는 대신.

다중 페이지 PDF의 경우 result.Pages는 페이지 별로 텍스트, 신뢰도 점수, 경계 상자에 대한 접근을 제공합니다. 페이지별 반복에 대한 자세한 내용은 다중 페이지 PDF OCR 가이드를 참조하십시오.

OCR 정확성을 향상시키기 위해 전처리 필터를 어떻게 사용할까요?

플랫베드 스캐너, 스마트폰 카메라, 팩스 기계에서의 원시 스캔은 자주 노이즈, 회전, 낮은 대조 및 불충분한 해상도 문제를 겪습니다. IronOCR의 이미지 품질 보정 파이프라인은 읽기 호출 전에 체인할 수 있는 목표 필터로 각 문제를 해결합니다.

using IronOcr;

public class AccuracyOptimizedOcr
{
    private readonly IronTesseract _ocr = new IronTesseract();

    public string ProcessLowQualityDocument(string filePath)
    {
        using var input = new OcrInput();

        if (filePath.EndsWith(".pdf", StringComparison.OrdinalIgnoreCase))
            input.LoadPdf(filePath);
        else
            input.LoadImage(filePath);

        // Chain preprocessing filters in order of operation
        input.DeNoise();              // Remove scan artifacts and speckling
        input.Deskew();               // Correct page tilt up to 35 degrees
        input.Scale(150);             // Enlarge small text for better recognition
        input.Binarize();             // Convert to black/white for cleaner edges
        input.EnhanceResolution(300); // Sharpen blurry or low-DPI input

        var result = _ocr.Read(input);

        // Confidence below 70 often signals a preprocessing mismatch
        if (result.Confidence < 70)
            Console.WriteLine($"Warning: low confidence ({result.Confidence:F1}%)");

        return result.Text;
    }
}

using IronOcr;

public class AccuracyOptimizedOcr
{
    private readonly IronTesseract _ocr = new IronTesseract();

    public string ProcessLowQualityDocument(string filePath)
    {
        using var input = new OcrInput();

        if (filePath.EndsWith(".pdf", StringComparison.OrdinalIgnoreCase))
            input.LoadPdf(filePath);
        else
            input.LoadImage(filePath);

        // Chain preprocessing filters in order of operation
        input.DeNoise();              // Remove scan artifacts and speckling
        input.Deskew();               // Correct page tilt up to 35 degrees
        input.Scale(150);             // Enlarge small text for better recognition
        input.Binarize();             // Convert to black/white for cleaner edges
        input.EnhanceResolution(300); // Sharpen blurry or low-DPI input

        var result = _ocr.Read(input);

        // Confidence below 70 often signals a preprocessing mismatch
        if (result.Confidence < 70)
            Console.WriteLine($"Warning: low confidence ({result.Confidence:F1}%)");

        return result.Text;
    }
}

필터 선택 안내:

• DeNoise() -- 심한 점이 있거나 압축 아티팩트가 있는 스캔에 사용하세요
• Deskew() -- 문서가 각도에서 촬영된 경우에 사용하세요; 자동 감지를 위한 페이지 회전 감지를 참조하십시오.
• Scale() -- 작은 글씨나 150 DPI 이하 입력에 사용하세요; 150-200의 값이 대개 최상의 결과를 제공합니다.
• Binarize() -- 컬러 또는 그라데이션 배경에 사용하세요; 이미지를 엄격한 흑백으로 변환합니다.
• EnhanceResolution() -- 흐릿하거나 대비가 낮은 텍스트에 사용하세요; 300 DPI를 Tesseract의 적합점으로 목표로 합니다.

국제 문서 분석 및 인식 저널에 게재된 연구는 이진화와 디스큐가 문자 인식률을 개선하는 데 가장 높은 영향을 미치는 전처리 단계임을 일관되게 보여줍니다. 제작 파이프라인에서는 모두 기본값으로 적용합니다.

생산 배치 처리 파이프라인을 어떻게 구축합니까?

단일 문서 추출은 간단하지만, 생산 시나리오는 대기열, 공유 폴더 또는 클라우드 저장소에 도착하는 수백 또는 수천 개의 파일을 포함합니다. IronOCR의 비동기 API와 스레드 안전 엔진은 병렬 작업에 적합합니다.

using IronOcr;
using Microsoft.Extensions.Logging;

public class ProductionOcrService
{
    private readonly IronTesseract _ocr;
    private readonly ILogger<ProductionOcrService> _logger;

    public ProductionOcrService(ILogger<ProductionOcrService> logger)
    {
        _logger = logger;
        _ocr = new IronTesseract
        {
            Configuration =
            {
                RenderSearchablePdfsAndHocr = true,
                ReadBarCodes = true
            }
        };
    }

    public async Task<IReadOnlyList<string>> ProcessBatchAsync(
        IEnumerable<string> filePaths,
        int maxDegreeOfParallelism = 4)
    {
        var results = new System.Collections.Concurrent.ConcurrentBag<string>();

        var options = new ParallelOptions
        {
            MaxDegreeOfParallelism = maxDegreeOfParallelism
        };

        await Parallel.ForEachAsync(filePaths, options, async (filePath, ct) =>
        {
            try
            {
                using var input = new OcrInput();

                if (filePath.EndsWith(".pdf", StringComparison.OrdinalIgnoreCase))
                    input.LoadPdf(filePath);
                else
                    input.LoadImage(filePath);

                var result = await _ocr.ReadAsync(input);
                results.Add(result.Text);
                _logger.LogInformation("Processed {FilePath} at {Confidence:F1}% confidence",
                    filePath, result.Confidence);
            }
            catch (Exception ex)
            {
                _logger.LogError(ex, "OCR failed for {FilePath}", filePath);
                results.Add(string.Empty);
            }
        });

        return results.ToList();
    }

    public void CreateSearchablePdf(string inputPath, string outputPath)
    {
        using var input = new OcrInput();

        if (inputPath.EndsWith(".pdf", StringComparison.OrdinalIgnoreCase))
            input.LoadPdf(inputPath);
        else
            input.LoadImage(inputPath);

        _ocr.Read(input).SaveAsSearchablePdf(outputPath);
        _logger.LogInformation("Searchable PDF written to {OutputPath}", outputPath);
    }
}

using IronOcr;
using Microsoft.Extensions.Logging;

public class ProductionOcrService
{
    private readonly IronTesseract _ocr;
    private readonly ILogger<ProductionOcrService> _logger;

    public ProductionOcrService(ILogger<ProductionOcrService> logger)
    {
        _logger = logger;
        _ocr = new IronTesseract
        {
            Configuration =
            {
                RenderSearchablePdfsAndHocr = true,
                ReadBarCodes = true
            }
        };
    }

    public async Task<IReadOnlyList<string>> ProcessBatchAsync(
        IEnumerable<string> filePaths,
        int maxDegreeOfParallelism = 4)
    {
        var results = new System.Collections.Concurrent.ConcurrentBag<string>();

        var options = new ParallelOptions
        {
            MaxDegreeOfParallelism = maxDegreeOfParallelism
        };

        await Parallel.ForEachAsync(filePaths, options, async (filePath, ct) =>
        {
            try
            {
                using var input = new OcrInput();

                if (filePath.EndsWith(".pdf", StringComparison.OrdinalIgnoreCase))
                    input.LoadPdf(filePath);
                else
                    input.LoadImage(filePath);

                var result = await _ocr.ReadAsync(input);
                results.Add(result.Text);
                _logger.LogInformation("Processed {FilePath} at {Confidence:F1}% confidence",
                    filePath, result.Confidence);
            }
            catch (Exception ex)
            {
                _logger.LogError(ex, "OCR failed for {FilePath}", filePath);
                results.Add(string.Empty);
            }
        });

        return results.ToList();
    }

    public void CreateSearchablePdf(string inputPath, string outputPath)
    {
        using var input = new OcrInput();

        if (inputPath.EndsWith(".pdf", StringComparison.OrdinalIgnoreCase))
            input.LoadPdf(inputPath);
        else
            input.LoadImage(inputPath);

        _ocr.Read(input).SaveAsSearchablePdf(outputPath);
        _logger.LogInformation("Searchable PDF written to {OutputPath}", outputPath);
    }
}

MaxDegreeOfParallelism 캡은 파일이 클 때 메모리 소진을 방지합니다. 4의 값은 4코어 서버에서 잘 작동합니다; 메모리 사용량을 프로파일링한 후에만 증가하십시오. Azure Functions 또는 AWS Lambda 배치의 경우, 함수 인스턴스당 동시성을 1로 설정하고 대신 수평으로 확장하십시오.

CreateSearchablePdf는 원본 이미지를 시각적 레이어로 보존하고 인식된 텍스트를 그 아래에 보이지 않게 삽입하여 PDF를 생성합니다. 이것은 PDF 뷰어에서의 전체 텍스트 검색과 검색 엔진에 의한 인덱싱을 허용합니다 -- 문서 관리 시스템의 일반적인 요구 사항입니다.

스캔된 문서에서 구조화된 데이터를 어떻게 추출합니까?

텍스트 추출이 첫 번째 단계입니다. 두 번째 단계는 해당 텍스트를 응용 프로그램에서 작동할 수 있는 형식의 필드로 구문 분석하는 것입니다. 이 패턴은 IronOCR의 판독 패스를 .NET의 Regex와 결합하여 송장, 양식 및 보고서에서 구조화된 데이터를 가져옵니다.

using IronOcr;
using System.Text.RegularExpressions;

public record Invoice(
    string? InvoiceNumber,
    DateOnly? Date,
    decimal? TotalAmount,
    string RawText
);

public class InvoiceOcrService
{
    private readonly IronTesseract _ocr = new IronTesseract();

    public Invoice ExtractInvoiceData(string invoicePath)
    {
        using var input = new OcrInput();

        if (invoicePath.EndsWith(".pdf", StringComparison.OrdinalIgnoreCase))
            input.LoadPdf(invoicePath);
        else
            input.LoadImage(invoicePath);

        input.DeNoise();
        input.Deskew();

        var result = _ocr.Read(input);
        string text = result.Text;

        return new Invoice(
            InvoiceNumber: ExtractInvoiceNumber(text),
            Date: ExtractDate(text),
            TotalAmount: ExtractAmount(text),
            RawText: text
        );
    }

    private static string? ExtractInvoiceNumber(string text)
    {
        var match = Regex.Match(text, @"Invoice\s*#?:?\s*(\S+)", RegexOptions.IgnoreCase);
        return match.Success ? match.Groups[1].Value : null;
    }

    private static DateOnly? ExtractDate(string text)
    {
        // Numeric format: MM/DD/YYYY
        var numeric = Regex.Match(text, @"\b(\d{1,2}/\d{1,2}/\d{2,4})\b");
        if (numeric.Success && DateTime.TryParse(numeric.Groups[1].Value, out var d1))
            return DateOnly.FromDateTime(d1);

        // Written format: January 15, 2025
        var written = Regex.Match(text,
            @"\b(January|February|March|April|May|June|July|August|September|October|November|December)\s+(\d{1,2}),?\s+(\d{4})\b",
            RegexOptions.IgnoreCase);
        if (written.Success && DateTime.TryParse(written.Value, out var d2))
            return DateOnly.FromDateTime(d2);

        return null;
    }

    private static decimal? ExtractAmount(string text)
    {
        var match = Regex.Match(text, @"\$\s*(\d+(?:\.\d{2})?)");
        return match.Success && decimal.TryParse(match.Groups[1].Value, out var amt)
            ? amt
            : null;
    }
}

using IronOcr;
using System.Text.RegularExpressions;

public record Invoice(
    string? InvoiceNumber,
    DateOnly? Date,
    decimal? TotalAmount,
    string RawText
);

public class InvoiceOcrService
{
    private readonly IronTesseract _ocr = new IronTesseract();

    public Invoice ExtractInvoiceData(string invoicePath)
    {
        using var input = new OcrInput();

        if (invoicePath.EndsWith(".pdf", StringComparison.OrdinalIgnoreCase))
            input.LoadPdf(invoicePath);
        else
            input.LoadImage(invoicePath);

        input.DeNoise();
        input.Deskew();

        var result = _ocr.Read(input);
        string text = result.Text;

        return new Invoice(
            InvoiceNumber: ExtractInvoiceNumber(text),
            Date: ExtractDate(text),
            TotalAmount: ExtractAmount(text),
            RawText: text
        );
    }

    private static string? ExtractInvoiceNumber(string text)
    {
        var match = Regex.Match(text, @"Invoice\s*#?:?\s*(\S+)", RegexOptions.IgnoreCase);
        return match.Success ? match.Groups[1].Value : null;
    }

    private static DateOnly? ExtractDate(string text)
    {
        // Numeric format: MM/DD/YYYY
        var numeric = Regex.Match(text, @"\b(\d{1,2}/\d{1,2}/\d{2,4})\b");
        if (numeric.Success && DateTime.TryParse(numeric.Groups[1].Value, out var d1))
            return DateOnly.FromDateTime(d1);

        // Written format: January 15, 2025
        var written = Regex.Match(text,
            @"\b(January|February|March|April|May|June|July|August|September|October|November|December)\s+(\d{1,2}),?\s+(\d{4})\b",
            RegexOptions.IgnoreCase);
        if (written.Success && DateTime.TryParse(written.Value, out var d2))
            return DateOnly.FromDateTime(d2);

        return null;
    }

    private static decimal? ExtractAmount(string text)
    {
        var match = Regex.Match(text, @"\$\s*(\d+(?:\.\d{2})?)");
        return match.Success && decimal.TryParse(match.Groups[1].Value, out var amt)
            ? amt
            : null;
    }
}

이 접근 방식은 각 필드가 양식의 정확한 위치에 나타날 때 지역 기반 OCR과 잘 맞습니다. 경계 상자를 제공하여 전체 페이지 인식을 생략하고 청구서 번호 또는 총계를 포함하는 영역만 대상으로 하여 고정 레이아웃 문서의 처리 시간을 대폭 줄입니다.

테이블 및 구조화된 양식을 포함한 보다 고급 추출 시나리오의 경우 제품 사이트에서 IronOCR 데이터 추출 예제를 참조하세요.

.NET에서 다국어 OCR을 어떻게 처리합니까?

많은 조직이 한 가지 이상의 언어로 문서를 처리합니다 - 수출입 양식, 국제 계약, 다국어 고객 제출 양식 등. IronOCR는 읽기 호출 전에 언어 팩을 구성할 수 있게 하여 이를 처리합니다.

using IronOcr;

// Configure multi-language recognition
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.EnglishBest;  // Swap for any of 125+ supported languages

// For mixed-language documents, combine language packs
ocr.AddSecondaryLanguage(OcrLanguage.German);

using var input = new OcrInput();
input.LoadPdf("multilingual-contract.pdf");
var result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;

// Configure multi-language recognition
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.EnglishBest;  // Swap for any of 125+ supported languages

// For mixed-language documents, combine language packs
ocr.AddSecondaryLanguage(OcrLanguage.German);

using var input = new OcrInput();
input.LoadPdf("multilingual-contract.pdf");
var result = ocr.Read(input);
Console.WriteLine(result.Text);

IronOCR 언어 지원 페이지에는 다운로드 지침과 함께 125개 이상의 사용 가능한 언어 팩이 나열되어 있습니다. 언어 팩은 NuGet 패키지로 제공되며(예: IronOcr.Languages.German) 이미 사용 중인 동일한 패키지 관리 워크플로에 통합됩니다.

라틴 알파벳 외의 문자 집합의 경우 - 아랍어, 중국어, 일본어, 한국어 - IronOCR는 오른쪽에서 왼쪽으로의 텍스트 방향과 이데오그램 스크립트를 처리하는 데 최적화된 모델을 제공합니다. 구성 세부 사항은 CJK OCR 가이드를 참조하세요.

다음 단계는 무엇입니까?

이제 .NET 10 응용 프로그램에 생산 등급의 OCR을 추가하는 데 필요한 패턴을 갖추었습니다: 기본 텍스트 추출, 어려운 스캔을 위한 전처리, 비동기 배치 처리, 구조화된 데이터 구문 분석, 그리고 다국어 지원.

여기에서 프로젝트 요구 사항에 따라 다음 영역을 탐색해 보세요:

• 바코드 및 QR 코드 읽기 -- 같은 이미지 패스에서 기계 판독 가능 코드를 추출
• HOCR 출력 형식 -- 레이아웃 인식 다운스트림 처리를 위한 단어 수준 경계 상자 얻기
• IronOCR 라이센싱 옵션 -- SaaS, OEM, Enterprise 계층의 로열티 프리 배포 모델
• IronOCR 코드 예제 라이브러리 -- 일반적인 시나리오를 다루는 30개 이상의 작동 예제
• Azure Functions 배포 가이드 -- Microsoft 클라우드 인프라에서 서버리스 OCR

무료 체험판 라이센스로 시작하여 계층에 가입하기 전에 자신의 문서에서 전체 기능 세트를 평가하세요.

!{--010011000100100101000010010100100100000101010010010110010101111101001110010101010001110100010101010100010111110100100101001110010100110101010001000001010011000100110001001100010111110100001001001100010011110100001101001011--}