IronOCR 이용한 텍스트 인식 (C# GitHub )

어떤 설치 방법을 사용해야 하나요?

IronOCR를 NuGet 패키지 관리자를 통해 설치를 시작하세요:

Install-Package IronOcr

!{--010011000100100101000010010100100100000101010010010110010101111101001110010101010001110100010101010100010111110100100101001110010100110101010001000001010011000100110001001100010111110100001001001100010011110100001101001011--}

고급 설치 시나리오의 경우, NuGet 패키지 가이드를 참조하세요. 특정 플랫폼에 배포하려면, Windows, Linux, macOS 또는 Docker 컨테이너에 대한 가이드를 확인하세요.

예제 코드를 어디에서 찾을 수 있나요?

IronOCR는 예제와 튜토리얼이 포함된 공식 GitHub 저장소를 유지합니다. IronOCR 예제 저장소는 실제 구현을 제공하며, 이미지에서 텍스트로의 튜토리얼 저장소는 클론하고 수정할 수 있는 실용적 사용 사례를 보여줍니다.

이 저장소들은 바코드 읽기, 다국어 지원, PDF 처리와 함께 OCR을 선보입니다. IronOCR가 NuGet에 자주 패키지를 발행하므로 항상 최신 안정 빌드에 접근할 수 있습니다.

어떤 프로젝트 구조를 사용해야 하나요?

MyOcrProject/
├── src/
│   └── OcrProcessor.cs
├── images/
│   └── sample-invoice.jpg
├── .gitignore
├── README.md
└── MyOcrProject.csproj

이 구조는 JPG, PNG, TIFF, BMP를 포함한 다양한 입력 형식을 지원합니다. 여러 페이지의 TIFF나 GIF 파일을 처리할 때 IronOCR는 이를 자동으로 처리합니다.

images/ 폴더는 샘플 파일을 체계적으로 유지하며 기여자가 최상위 루트를 어지럽히지 않고 테스트 이미지를 추가할 수 있게 합니다. 구성 파일과 별도로 src/ 폴더를 유지하면 프로젝트를 한눈에 읽기 쉽게 만들 수 있습니다. 프로젝트가 수행하는 작업, 설정해야 할 라이선스 키 변수 및 샘플을 실행하는 방법을 설명하는 README.md을 추가하세요.

OCR 처리 코드를 어떻게 구현하나요?

다음 예는 IronOCR의 이미지를 전처리, 텍스트 추출, 바코드 감지를 포함한 주요 기능을 보여주는 완전한 OCR 프로세서를 보여줍니다:

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;
ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.Auto;
ocr.Language = OcrLanguage.English;

using var input = new OcrInput();
input.LoadImage("images/sample-invoice.jpg");
input.Deskew();
input.DeNoise();
input.EnhanceResolution(225);

var result = ocr.Read(input);

Console.WriteLine($"Confidence: {result.Confidence}%");
Console.WriteLine($"Text Found:\n{result.Text}");

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

result.SaveAsSearchablePdf("output.pdf");

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;
ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.Auto;
ocr.Language = OcrLanguage.English;

using var input = new OcrInput();
input.LoadImage("images/sample-invoice.jpg");
input.Deskew();
input.DeNoise();
input.EnhanceResolution(225);

var result = ocr.Read(input);

Console.WriteLine($"Confidence: {result.Confidence}%");
Console.WriteLine($"Text Found:\n{result.Text}");

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

result.SaveAsSearchablePdf("output.pdf");

이 예는 IronOCR의 여러 기능을 선보입니다. 생성자는 바코드 읽기가 활성화된 OCR 엔진을 구성하고 자동 페이지 세분화를 구현합니다. 전처리 파이프라인은 디스큐(회전 교정), 디노이징(잡티 제거), 해상도 향상을 입증합니다.

처리 후, 엔진은 영어 텍스트를 신뢰도 점수와 함께 추출하고 바코드를 식별하며 검색 가능 PDF를 생성합니다. 코드는 .NET 10 최상위 명령문을 사용하여 작성되어 샘플을 짧고 읽기 쉽게 유지합니다.

고급 시나리오에서는 비동기 처리를 사용하여 처리량을 개선하거나 장기 작업에 대한 진행 추적을 구현할 수 있습니다. OcrResult 클래스는 텍스트 위치, 단어 좌표 및 단락 구조를 포함한 자세한 출력을 제공하여 평범한 텍스트 문자열 이상의 것을 제공합니다.

개발자는 IronOCR를 중국어, 스페인어, 프랑스어 등 다른 언어를 읽도록 구성할 수도 있어 다국어 GitHub 프로젝트에 적합한 선택이 됩니다. 추가 언어 팩 설치에 대한 참조는 125개 국제 언어 가이드를 참조하세요.

.gitignore 파일에 무엇을 포함해야 하나요?

.gitignore 파일에는 런타임 아티팩트, 테스트 출력, 비밀 구성의 커밋을 방지하는 항목을 포함하세요:

# IronOCR runtime files
runtimes/
# Test images and outputs
*.pdf
test-images/
output/
# License keys
appsettings.*.json

IronOCR가 빌드 시간에 플랫폼 별 이진 파일을 다운로드하기 때문에 소스 제어에서 runtimes/ 폴더를 제외하는 것이 특히 중요합니다. 이를 커밋하면 저장소가 비대해지고 플랫폼 충돌이 발생할 수 있습니다. 적절한 구현을 위한 라이선스 키 관리에 대해 자세히 알아보세요.

IronOCR이 다른 OCR 솔루션과 다른 점은 무엇입니까?

IronOCR는 개별 단어, 줄, 전체 단락을 인식할 수 있을 만큼 유연하여 각 스캔에서 얼마나 세부적으로 추출할지 정확한 제어를 제공합니다. 라이브러리는 자동차 번호판, 여권, 수기 텍스트, 스크린샷, 스캔한 문서 등 전문화된 문서 유형에 탁월합니다.

상업용 라이선스는 공개 저장소에 대한 법적 명확성을 제공합니다. IronOCR를 상업용 애플리케이션에 명시적으로 포함할 수 있습니다. 내장된 이미지 전처리 필터에는 색상 교정, 품질 향상과 같은 고급 옵션과 어려운 이미지에 대한 최적 설정을 자동으로 찾는 필터 마법사가 포함되어 있습니다.

단일 DLL 아키텍처가 중요한 이유는?

IronOCR의 단일 DLL 아키텍처를 통해 기여자가 리포지토리를 클론하고 즉시 개발을 시작할 수 있으며, 다른 OCR 솔루션에서 겪는 네이티브 종속성이나 플랫폼별 구성과 씨름하지 않아도 됩니다. 이 단순성 때문에 개발자는 원시 Tesseract 대신 IronOCR를 선택합니다.

설정 경험을 비교했을 때, 원시 Tesseract 구현은 일반적으로 네이티브 바이너리를 별도로 설치하고, PATH 변수를 구성하고, 테스데이터 언어 파일을 수동으로 관리해야 합니다. IronOCR는 이를 내부적으로 모두 처리하므로 README가 환경 설정 지침이 아닌 애플리케이션 로직에 집중할 수 있습니다.

라이브러리는 성능 개선과 멀티스레딩 지원이 포함된 Tesseract 5를 포함하여 여러 문서를 병렬로 처리할 수 있으며 사용자 지정 스레딩 코드를 쓰지 않아도 됩니다.

Git에서 큰 파일을 어떻게 처리하나요?

리포지토리 크기를 관리 가능한 상태로 유지하기 위해 큰 테스트 이미지에 대해 Git LFS를 사용하십시오.

git lfs track "*.jpg" "*.png" "*.tiff"
git add .gitattributes
git commit -m "Track large image files with Git LFS"

git lfs track "*.jpg" "*.png" "*.tiff"
git add .gitattributes
git commit -m "Track large image files with Git LFS"

이는 고해상도 이미지나 다중 페이지 TIFF 파일을 다룰 때 특히 중요합니다. 저품질 스캔의 경우 IronOCR의 전처리는 테스트 이미지를 커밋하기 전에 수동으로 편집할 필요 없이 결과를 상당히 향상시킬 수 있습니다.

리포지토리에 테스트 문서를 저장할 때, 민감한 정보를 포함하고 있는지를 고려하십시오. 실제 송장이나 신분증 문서를 커밋하기보다 프로그램적으로 합성된 테스트 이미지를 생성하는 것이 더 좋습니다, 심지어 개인 리포지토리에서도.

라이선스 키와 문서를 어떻게 관리해야 하나요?

IronOCR 라이선스 키는 환경 변수나 .NET 사용자 비밀을 사용하여 저장하십시오. 심지어 개인 브랜치에서도 이를 직접 커밋하지 마십시오. 적절한 구현을 위해 라이선스 키 가이드를 따르십시오. ASP.NET 애플리케이션에서는 web.config에 라이선스를 구성할 수도 있습니다.

지원되는 이미지 형식과 예상 정확도 수준을 README에 문서화하십시오. 기여자가 복제 직후 OCR 기능을 검증할 수 있도록 test-data/ 폴더에 샘플 이미지를 포함하세요. 새로운 기여자가 처음 실행 시 차단되지 않도록 환경 변수를 통해 라이선스 키를 설정하는 방법을 설명하는 짧은 섹션을 추가하십시오.

크로스 플랫폼 개발에는 IronOCR Linux 설치 가이드 또는 macOS 설치 지침을 참조하십시오. 모바일 개발자는 IronOCR 문서에 있는 안드로이드와 iOS 가이드를 확인해야 합니다.

왜 Windows에서 OCR이 작동하지 않나요?

일반적인 설정 문제에는 Windows에서 시각 C++ 재배포 가능 패키지가 누락된 경우입니다. IronOCR는 2019 버전을 필요로 합니다. 자세한 안내는 Visual C++ 재배포 가능 패키지 문제 해결 가이드를 참조하십시오. 리눅스 배포에서는 libgdiplus가 설치되었는지 확인하십시오.

텍스트 인식이 부진하다면 DPI 설정 가이드를 사용하여 이미지가 최소 200 DPI인지 확인하십시오. C# OCR 커뮤니티인 Stack Overflow에서도 일반적인 GitHub 프로젝트 문제에 대한 유용한 솔루션을 제공합니다.

특정 구성 문제의 경우, 문제를 진단하기 위해 IronOCR 유틸리티 도구를 사용하고 단계별 진단을 위한 일반 문제 해결 가이드를 참조하십시오.

추가 지원을 어디에서 받을 수 있나요?

자세한 문제 해결을 위해 IronOCR 문제 해결 가이드를 참조하십시오. IronOCR 지원 팀은 GitHub에 호스팅된 OCR 애플리케이션을 작업하는 라이선스 사용자에게 빠른 지원을 제공합니다. 최신 업데이트는 제품 변경 로그를 확인하십시오.