CodeProject의 C# OCR 튜토리얼: IronOCR 사용하여 이미지에서 텍스트 추출

.NET 프로젝트에 IronOCR을 어떻게 설치합니까?

.NET 10 프로젝트에 OCR을 추가하는 가장 빠른 방법은 NuGet 패키지 관리자를 사용하는 것입니다. 프로젝트 디렉토리에서 터미널을 열고 dotnet CLI 명령을 실행하거나 Visual Studio 내에서 패키지 관리자 콘솔을 사용하십시오:

# .NET CLI
dotnet add package IronOcr

# Package Manager Console
Install-Package IronOcr

# .NET CLI
dotnet add package IronOcr

# Package Manager Console
Install-Package IronOcr

설치 후 NuGet 패키지 관리자는 필요로 하는 모든 어셈블리를 다운로드하고 참조를 자동으로 설정합니다. IronOCR은 .NET Framework 4.6.2+, .NET Core 3.1+, .NET 5에서 .NET 10까지 지원하므로 콘솔 앱, ASP.NET Core 서비스, WPF 애플리케이션 및 Azure Functions에서 작동합니다.

로컬에서 테스트하기 위해 라이센스 키를 등록할 필요는 없으며, 라이센스가 적용될 때까지 출력에 체험판 워터마크가 나타납니다. 사용 지시문을 추가하고 프로덕션 준비가 되었을 때 시작 시 한 번 키를 전달하십시오:

using IronOcr;

// Apply license key before any OCR calls (production only)
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

using IronOcr;

// Apply license key before any OCR calls (production only)
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

가격 및 활성화 세부 정보는 IronOCR 라이센스 페이지를 참조하십시오.

이미지 파일에서 텍스트를 어떻게 추출합니까?

핵심 OCR 워크플로는 세 가지 객체를 포함합니다: IronTesseract (엔진), OcrInput (입력 컨테이너), 및 OcrResult (출력). 아래 샘플은 PNG를 읽고 인식된 텍스트를 콘솔에 출력합니다.

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.LoadImage("sample-document.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.LoadImage("sample-document.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

스캔한 문서 및 TIFF 파일을 어떻게 처리합니까?

여러 페이지로 구성된 TIFF 파일은 문서 스캔 워크플로우에서 일반적입니다. IronOCR는 LoadImageFrames로 이를 처리하여 정확히 어떤 프레임(페이지)을 처리할지 선택할 수 있으며, 이는 큰 아카이브의 하위 집합만 필요할 때 유용합니다.

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
int[] pageIndices = { 0, 1, 2 };
input.LoadImageFrames("scanned-documents.tiff", pageIndices);

// Correct skew and remove noise before reading
input.Deskew();
input.DeNoise();

OcrResult result = ocr.Read(input);

foreach (var page in result.Pages)
{
    Console.WriteLine($"Page {page.PageNumber}:");
    Console.WriteLine(page.Text);
}

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
int[] pageIndices = { 0, 1, 2 };
input.LoadImageFrames("scanned-documents.tiff", pageIndices);

// Correct skew and remove noise before reading
input.Deskew();
input.DeNoise();

OcrResult result = ocr.Read(input);

foreach (var page in result.Pages)
{
    Console.WriteLine($"Page {page.PageNumber}:");
    Console.WriteLine(page.Text);
}

OCR를 위한 언어 지원을 어떻게 구성합니까?

기본적으로 IronOCR은 영어 텍스트를 읽습니다. 다른 언어의 문서를 처리하려면 일치하는 언어 NuGet 패키지를 설치하고 IronTesseract 인스턴스에서 Language 속성을 설정하십시오.

dotnet add package IronOcr.Languages.German
dotnet add package IronOcr.Languages.French
dotnet add package IronOcr.Languages.Japanese

dotnet add package IronOcr.Languages.German
dotnet add package IronOcr.Languages.French
dotnet add package IronOcr.Languages.Japanese

그런 다음 엔진을 구성하고, 이중 언어 문서의 경우 보조 언어를 추가하세요:

using IronOcr;
using IronOcr.Languages;

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

// For bilingual documents (e.g. Canadian forms, EU directives)
ocr.AddSecondaryLanguage(OcrLanguage.French);

using var input = new OcrInput();
input.LoadImage("german-invoice.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;
using IronOcr.Languages;

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

// For bilingual documents (e.g. Canadian forms, EU directives)
ocr.AddSecondaryLanguage(OcrLanguage.French);

using var input = new OcrInput();
input.LoadImage("german-invoice.png");

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

IronOCR은 125개 이상의 언어를 지원하며, 각각 별도의 가벼운 NuGet 패키지로 배포됩니다. 이를 통해 생산 바이너리는 작게 유지되며 애플리케이션에서 실제로 필요한 언어 데이터만 포함됩니다. 엔진은 인식 중에 AddSecondaryLanguage를 호출할 때 주요 및 보조 언어 모델을 혼합합니다.

OCR 오류를 처리하고 인식 결과를 개선하려면 어떻게 해야 합니까?

생산 애플리케이션은 OCR 파이프라인 주변에 오류 처리가 필요합니다. 이미지 품질 문제, 누락된 파일 또는 지원되지 않는 형식은 예외를 일으킬 수 있습니다. try/catch 블록으로 호출을 감싸면 깨끗한 복구 경로를 제공합니다.

using IronOcr;

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

try
{
    using var input = new OcrInput();
    input.LoadImage("document.png");
    input.DeNoise();
    input.Deskew();

    OcrResult result = ocr.Read(input);

    if (result.Text.Length > 0)
    {
        Console.WriteLine("Recognised text:");
        Console.WriteLine(result.Text);
    }
    else
    {
        Console.WriteLine("No text was detected in the image.");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"OCR error: {ex.Message}");
}

using IronOcr;

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

try
{
    using var input = new OcrInput();
    input.LoadImage("document.png");
    input.DeNoise();
    input.Deskew();

    OcrResult result = ocr.Read(input);

    if (result.Text.Length > 0)
    {
        Console.WriteLine("Recognised text:");
        Console.WriteLine(result.Text);
    }
    else
    {
        Console.WriteLine("No text was detected in the image.");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"OCR error: {ex.Message}");
}

예상보다 정확도가 낮을 때 도움이 되는 몇 가지 추가 설정:

• ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.Auto -- Tesseract가 단일 열, 다중 열 및 단일 단어 레이아웃 간 자동 선택을 허용합니다
• ocr.Configuration.ReadBarCodes = false -- 텍스트 전용 문서를 처리하고 더 빠른 처리량을 원하는 경우 바코드 감지를 비활성화합니다
• ocr.Configuration.TesseractVersion = TesseractVersion.Tesseract5 -- 가장 빠른 사용 가능한 엔진을 사용하도록 보장합니다

필드가 예측 가능한 위치에 나타나는 구조화된 양식의 경우 영역 기반 OCR을 사용하여 중요 부분만 읽으세요:

using IronOcr;
using IronSoftware.Drawing;

var ocr = new IronTesseract();

using var input = new OcrInput();
var region = new CropRectangle(x: 50, y: 200, width: 600, height: 100);
input.LoadImage("form.png", region);

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;
using IronSoftware.Drawing;

var ocr = new IronTesseract();

using var input = new OcrInput();
var region = new CropRectangle(x: 50, y: 200, width: 600, height: 100);
input.LoadImage("form.png", region);

OcrResult result = ocr.Read(input);
Console.WriteLine(result.Text);

인식을 크롭 사각형으로 제한하면 대형 이미지 처리 시간을 최대 90% 줄일 수 있습니다. 이 기술은 송장 번호 추출, 양식 필드 읽기 및 ID 문서 스캔에 적합합니다. 영역 OCR 가이드에서 자세한 내용을 확인할 수 있습니다.

인식된 텍스트에서 검색 가능한 PDF를 생성하려면 어떻게 해야 합니까?

스캔된 이미지 아카이브를 검색 가능한 PDF 파일로 변환하는 것은 가장 가치가 높은 OCR 사용 사례 중 하나입니다. 결과 파일은 원본 시각적 모양을 유지하면서 PDF 뷰어, 검색 엔진 및 스크린 리더가 인덱싱할 수 있는 보이지 않는 텍스트 레이어를 포함합니다.

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.Title = "Quarterly Report Q1 2026";
input.LoadImage("page1.png");
input.LoadImage("page2.png");
input.LoadImage("page3.png");

OcrResult result = ocr.Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");

Console.WriteLine("Searchable PDF created.");
Console.WriteLine($"Pages processed: {result.Pages.Count}");

using IronOcr;

var ocr = new IronTesseract();

using var input = new OcrInput();
input.Title = "Quarterly Report Q1 2026";
input.LoadImage("page1.png");
input.LoadImage("page2.png");
input.LoadImage("page3.png");

OcrResult result = ocr.Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");

Console.WriteLine("Searchable PDF created.");
Console.WriteLine($"Pages processed: {result.Pages.Count}");

텍스트와 함께 바코드를 읽는 방법은?

IronOCR은 인쇄된 텍스트와 같은 이미지에 내장된 바코드와 QR 코드를 읽을 수 있어, 별도의 바코드 라이브러리를 실행할 필요가 없습니다. 설정 속성 하나로 기능을 활성화하십시오:

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;

using var input = new OcrInput();
input.LoadImage("shipping-label.png");

OcrResult result = ocr.Read(input);

Console.WriteLine("Text:");
Console.WriteLine(result.Text);

Console.WriteLine("Barcodes:");
foreach (var barcode in result.Barcodes)
{
    Console.WriteLine($"  {barcode.Format}: {barcode.Value}");
}

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;

using var input = new OcrInput();
input.LoadImage("shipping-label.png");

OcrResult result = ocr.Read(input);

Console.WriteLine("Text:");
Console.WriteLine(result.Text);

Console.WriteLine("Barcodes:");
foreach (var barcode in result.Barcodes)
{
    Console.WriteLine($"  {barcode.Format}: {barcode.Value}");
}

지원되는 바코드 형식에는 Code 128, Code 39, EAN-13, EAN-8, UPC-A, UPC-E, PDF417, 데이터 매트릭스 및 QR 코드가 포함됩니다. 전체 세부 사항은 IronOCR 바코드 읽기 가이드에 있습니다.

이 기능은 특히 물류, 의료, 소매 애플리케이션에서 유용하며, 배송 라벨, 환자 팔찌, 제품 태그가 사람 읽을 수 있는 텍스트와 기계 읽을 수 있는 바코드를 모두 포함합니다.

IronOCR을 다른 .NET OCR 옵션과 비교하는 방법은?

.NET용 OCR 라이브러리를 평가하는 개발자는 보통 IronOCR, Tesseract.NET 및 Google Cloud Vision 또는 Azure Computer Vision와 같은 클라우드 서비스를 고려합니다. 아래 표는 주요 차이점을 요약합니다:

Tesseract는 구글이 오픈 소스 프로젝트로서 유지 관리하며, IronOCR 및 Tesseract.NET의 기반이 됩니다. IronOCR은 .NET 적합 패키징, 자동 모델 관리, 그리고 원시 Tesseract 바인딩에 없는 프로덕션 출력 기능(검색 가능한 PDF, hOCR 내보내기)을 추가합니다. Azure Computer Vision은 최첨단의 클라우드 정확성을 제공하지만, 네트워크 지연 및 호출당 비용을 초래하여 대량 또는 오프라인 워크플로에는 적합하지 않습니다.

데이터 개인정보 보호 규제로 인해 외부 서비스로 문서를 전송할 수 없는 시나리오 -- 의료 기록, 법적 문서, 재무제표 --에서는 IronOCR과 같은 온프레미스 라이브러리가 적합한 선택입니다.

다음 단계는 무엇입니까?

이제 NuGet을 통한 설치, 기본 이미지-텍스트 추출, 다중 페이지 TIFF 처리, 언어 구성, 오류 처리, 영역 기반 읽기, 바코드 감지, 검색 가능한 PDF 생성 등 모든 .NET 10 애플리케이션에 OCR을 추가할 수 있는 구성 요소를 갖추고 있습니다.

더 깊이 탐구하려면 다음 IronOCR 리소스를 탐색하십시오:

• IronOCR 문서 홈 -- 전체 API 참조 및 기능 가이드
• 이미지 필터 튜토리얼 -- 모든 전처리 필터에 대한 상세 가이드
• 바코드 읽기 가이드 -- 텍스트와 함께 QR 코드 및 선형 바코드
• 영역 OCR 사용법 -- 양식 및 ID에 대한 크롭 기반 인식
• 언어 참조 -- 지원 언어 125+의 전체 목록
• API 참조 -- 모든 클래스, 메서드 및 속성

라이선싱 질문이나 프로덕션 환경에 IronOCR을 배포하기 위해서는, IronOCR 라이선싱 페이지를 방문하십시오. 무료 체험 라이선스는 평가 기간 동안 출력 워터마크를 제거하며, Iron Software의 지원 팀은 모든 티어에서 기술적 질문을 지원합니다.

지금 바로 IronOCR으로 시작하세요.

무료로 시작하세요