IronOCR 사용하여 C# GitHub 프로젝트에 OCR을 구현하는 방법

IronOCR을 시작하는 방법은?

IronOCR는 NuGet을 통해 배포되는 관리된 .NET 라이브러리를 제공하여 GitHub 저장소에 쉽게 통합할 수 있습니다. 수동으로 바이너리와 tessdata 구성을 관리해야 하는 오픈 소스 Tesseract OCR 래퍼와 달리 IronOCR는 이러한 종속성을 내부적으로 처리하며 Windows, Linux 및 macOS에서 바로 작동합니다.

라이브러리는 개발자가 클론 및 참조할 수 있는 공식 예제 저장소를 GitHub에 유지합니다. 이러한 예제는 이미지를 텍스트로 변환하고, 여러 언어를 지원하며, PDF 처리를 포함한 실제 구현을 보여줍니다. 기여자는 추가 설정 없이 클론한 후 즉시 기능을 테스트할 수 있습니다.

Visual Studio에서 시작하려면 NuGet 패키지 관리자에서 IronOCR를 설치하십시오:

Install-Package IronOcr

Install-Package IronOcr

설치가 완료되면 이 단일 패키지는 OCR 작업에 필요한 모든 것을 포함합니다. 이 라이브러리는 .NET Framework 4.6.2+, .NET Core, .NET 5부터 10까지 지원하여 최대 호환성을 제공합니다.

C#에서 이미지 형식에서 텍스트를 추출하는 방법은 무엇인가요?

다음 예제는 IronOCR의 IronTesseract 클래스를 사용하여 기본 텍스트 추출을 시연합니다. 이 OCR 엔진은 PNG, JPG, JPEG, BMP, GIF 및 TIFF를 포함한 다양한 이미지 형식을 읽습니다:

using IronOcr;

// Initialize the OCR engine
var ocr = new IronTesseract();

// Load and process an image
using var input = new OcrInput("document-scan.png");

// Perform OCR and retrieve results
var result = ocr.Read(input);

// Output the extracted text to console
Console.WriteLine($"Extracted Text:\n{result.Text}");
Console.WriteLine($"Confidence: {result.Confidence}%");

using IronOcr;

// Initialize the OCR engine
var ocr = new IronTesseract();

// Load and process an image
using var input = new OcrInput("document-scan.png");

// Perform OCR and retrieve results
var result = ocr.Read(input);

// Output the extracted text to console
Console.WriteLine($"Extracted Text:\n{result.Text}");
Console.WriteLine($"Confidence: {result.Confidence}%");

IronTesseract 클래스는 최적화된 Tesseract 5 구현을 기반으로 한 기본 OCR 엔진 역할을 합니다. 인스턴스를 생성한 후 OcrInput 객체는 디스크, URL 또는 바이트 배열에서 대상 이미지를 로드합니다. Read 메서드는 입력을 처리하고 추출된 일반 텍스트와 인식 정확성을 나타내는 신뢰도 백분율을 포함하는 OcrResult를 반환합니다. 90% 이상의 높은 신뢰도는 일반적으로 깔끔하고 잘 포맷된 소스 문서를 나타냅니다.

OcrResult 객체는 인식된 콘텐츠에 대한 구조화된 접근을 제공합니다. 일반 텍스트 외에도 개발자는 개별 단어, 줄, 단락, 문자 및 그 위치와 신뢰도 점수에 접근할 수 있습니다. 각 Word 는 경계 사각형 좌표를 포함하여 문서 주석 또는 양식 필드 추출과 같이 정밀한 텍스트 위치 데이터가 필요한 애플리케이션에 유용합니다.

이미지 전처리가 OCR 정확성을 어떻게 향상시키나요?

스캔된 문서는 종종 비뚤어지거나, 잡음이 있거나, 최적이 아닌 해상도로 도착합니다. IronOCR는 OCR 엔진이 이미지를 처리하기 전에 이러한 문제를 수정하는 내장 전처리 필터를 포함합니다:

using IronOcr;

var ocr = new IronTesseract();
using var input = new OcrInput("skewed-receipt.jpg");

// Apply preprocessing filters to enhance scan quality
input.Deskew();                    // Straighten rotated images
input.DeNoise();                   // Remove digital artifacts
input.EnhanceResolution(225);      // Optimize DPI for OCR

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

using IronOcr;

var ocr = new IronTesseract();
using var input = new OcrInput("skewed-receipt.jpg");

// Apply preprocessing filters to enhance scan quality
input.Deskew();                    // Straighten rotated images
input.DeNoise();                   // Remove digital artifacts
input.EnhanceResolution(225);      // Optimize DPI for OCR

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

Deskew 메서드는 스캐너에 조금 비스듬히 올려진 페이지의 일반적인 경우를 처리하여 최대 15도 이미지 회전을 자동으로 감지하고 수정합니다. DeNoise 필터는 사진으로 촬영된 문서나 오래된 스캔에서 흔히 볼 수 있는 점과 아티팩트를 제거합니다. EnhanceResolution 는 낮은 DPI 이미지를 광학 문자 인식 정확성을 위해 최적의 200-300 DPI 범위로 업스케일합니다.

이 필터는 체인 방식으로 결합되며 임시 파일 없이 메모리에서 전체 실행할 수 있습니다. 많은 경우에 심각한 품질 문제(약한 잉크, 배경 잡음, 카메라 왜곡 등)가 있는 문서에서 여러 전처리 과정을 적용하면 텍스트 인식 결과가 크게 향상될 수 있습니다. 향상은 주로 150 DPI 이하로 스캔한 문서나 균일하지 않은 조명 조건에서 찍힌 사진에서 가장 두드러집니다.

using IronOcr;
using IronSoftware.Drawing;

var ocr = new IronTesseract();
using var input = new OcrInput("invoice.png");

// Define crop region (x, y, width, height in pixels)
var cropArea = new CropRectangle(50, 100, 600, 300);
input.AddRegion(cropArea);

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

using IronOcr;
using IronSoftware.Drawing;

var ocr = new IronTesseract();
using var input = new OcrInput("invoice.png");

// Define crop region (x, y, width, height in pixels)
var cropArea = new CropRectangle(50, 100, 600, 300);
input.AddRegion(cropArea);

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

바코드 및 QR 코드를 텍스트와 함께 추출할 수 있나요?

IronOCR는 동일한 문서에서 텍스트를 인식하고 바코드를 스캔할 수 있습니다. 이 중복 기능은 청구서, 운송 라벨, 재고 문서를 처리하는 데 가치가 큽니다:

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;  // Enable barcode detection

using var input = new OcrInput("shipping-label.png");
var result = ocr.Read(input);

// Access extracted text
Console.WriteLine($"Text: {result.Text}");

// Access any barcodes found in the image
foreach (var barcode in result.Barcodes)
{
    Console.WriteLine($"Barcode ({barcode.Format}): {barcode.Value}");
}

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;  // Enable barcode detection

using var input = new OcrInput("shipping-label.png");
var result = ocr.Read(input);

// Access extracted text
Console.WriteLine($"Text: {result.Text}");

// Access any barcodes found in the image
foreach (var barcode in result.Barcodes)
{
    Console.WriteLine($"Barcode ({barcode.Format}): {barcode.Value}");
}

ReadBarCodes 가 true으로 설정되면 바코드 탐지가 활성화되며 처리 시간에 큰 영향을 주지 않습니다. 결과의 Barcodes 컬렉션에는 각 탐지된 바코드의 값과 형식 유형이 포함됩니다. 지원하는 형식에는 QR 코드, Code 128, EAN-13, UPC, 데이터 매트릭스, PDF417 등이 있습니다. 이 이중 기능은 사람 인식 문자와 기계 인식 코드가 모두 포함된 문서를 처리할 때 별도의 바코드 스캔 라이브러리의 필요성을 없앱니다.

스캔 이미지에서 검색 가능한 PDF를 생성하는 방법은 무엇인가요?

스캔한 문서를 검색 가능한 PDF로 변환하면 문서 관리 시스템 내에서 텍스트 선택, 복사 및 전체 텍스트 검색을 사용할 수 있습니다. 이는 다양한 이미지 형식을 입력으로 사용하여 작동합니다:

using IronOcr;

var ocr = new IronTesseract();
using var input = new OcrInput("scanned-contract.tiff");
var result = ocr.Read(input);

// Export as searchable PDF with invisible text layer
result.SaveAsSearchablePdf("contract-searchable.pdf");

using IronOcr;

var ocr = new IronTesseract();
using var input = new OcrInput("scanned-contract.tiff");
var result = ocr.Read(input);

// Export as searchable PDF with invisible text layer
result.SaveAsSearchablePdf("contract-searchable.pdf");

SaveAsSearchablePdf 메서드는 인식된 콘텐츠와 일치하는 보이지 않는 텍스트 레이어를 삽입하여 원본 문서의 외관을 유지하면서 텍스트 작업을 수행할 수 있게 합니다. 이는 아카이브 및 Enterprise 문서 관리 시스템에 적합한 문서를 생성합니다. IronOCR는 또한 결과를 HTML 또는 JSON으로 내보내 다운로드 시스템에 통합할 수 있습니다.

여러 페이지로 구성된 문서의 경우, IronOCR는 각 페이지를 개별적으로 처리하고 결과를 하나의 파일로 조립합니다. 여러 프레임이 있는 TIFF 파일은 자동으로 처리되어 스캔된 문서 아카이브의 일괄 변환을 용이하게 합니다. 생성된 PDF는 원본 스캔의 시각적 레이아웃을 보존하면서 내장된 텍스트 레이어는 모든 PDF 뷰어 또는 문서 관리 플랫폼에서 각 페이지를 완전히 검색할 수 있게 만듭니다.

IronOCR를 다국어 애플리케이션에서 어떻게 사용하나요?

IronOCR는 영어, 스페인어, 프랑스어, 독일어, 중국어, 일본어, 아랍어 등 125개 이상의 언어를 지원합니다. 언어 팩은 NuGet을 통해 별도의 패키지로 설치되어 핵심 라이브러리를 가볍게 유지합니다:

using IronOcr;

// Install-Package IronOcr.Languages.French
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.French;

using var input = new OcrInput("french-document.png");
var result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;

// Install-Package IronOcr.Languages.French
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.French;

using var input = new OcrInput("french-document.png");
var result = ocr.Read(input);
Console.WriteLine(result.Text);

같은 페이지에 혼합 언어가 포함된 문서의 경우, IronOCR는 여러 언어 모델을 동시에 로드하는 것을 지원합니다. 이는 언어별로 파일을 미리 정렬할 필요 없이 여러 지역의 문서를 처리하는 국제화 된 애플리케이션에 해당됩니다. 각 언어 팩은 핵심 라이브러리와 함께 유지 관리되며 동일한 전처리 및 출력 기능을 지원합니다.

GitHub 프로젝트에서 OCR의 최선의 방법은 무엇인가요?

GitHub에서 OCR 프로젝트를 유지 관리할 때, 몇 가지 조직적 결정은 기여자 경험과 장기적인 프로젝트 건강을 향상시킵니다. 이러한 관행은 소규모 유틸리티 스크립트를 작성하거나 대규모 Enterprise 문서 처리 서비스를 구축하든 상관없이 적용됩니다.

저장소 크기를 부풀리지 않기 위해 큰 테스트 이미지를 위해 Git LFS를 사용하세요. 일반적인 Git 기록에서의 이진 자산은 테스트 데이터 세트에 고해상도 스캔이 포함될 때 클론 시간과 저장 비용을 증가시킵니다. 라이선스 키는 환경 변수나 GitHub Secrets에 저장하고, 절대 커밋된 C# 코드에 저장하지 마세요; 라이선스 키 설정 가이드를 참조하여 설정 지침을 확인하세요.

기여자가 자신의 문서를 소싱하지 않고도 OCR 기능을 검증할 수 있도록 전용 test-data 폴더에 샘플 이미지를 포함하세요. README 파일에 지원되는 이미지 형식과 .NET 버전 요구 사항을 문서화하여 온보딩 질문을 줄이세요. 목표 환경 전반에서 라이브러리가 제대로 작동하는지 확인하기 위해 GitHub Actions를 사용하여 CI 파이프라인에서 빌드하고 테스트하세요.

GitHub Actions 워크플로우의 경우, IronOCR는 Windows와 Linux 실행기 모두에서 컨테이너화된 환경에서 실행됩니다. Ubuntu 또는 다른 비-Windows 실행기를 겨냥할 때의 구성 세부 사항은 Linux 배포 가이드를 참조하세요.

다음 단계는 무엇입니까?

IronOCR는 외부 이진 종속성 없이 Tesseract 구성, 전처리, 바코드 감지 및 다국어 지원을 처리하는 NuGet으로 배포되는 라이브러리를 통해 C# GitHub 프로젝트에 안정적인 텍스트 인식을 제공합니다. 이 가이드의 코드 예제는 기본 텍스트 추출, 이미지 전처리, 바코드 스캐닝, 검색 가능한 PDF 생성, 다국어 처리라는 핵심 사용 사례를 다룹니다.

전체 기능 세트를 탐색하려면, 시간 압박이나 신용카드 요구가 없는 무료 체험판을 시작하세요. 프로덕션 배포 준비가 되었을 때, 개별 개발자부터 Enterprise 팀에 이르는 라이선스 옵션을 검토하세요.

지식을 확장하는 관련 리소스:

• C#에서 이미지에서 텍스트 읽기 방법
• C# 튜토리얼의 Tesseract OCR
• IronOCR GitHub 예제 저장소