OCR C# GitHub 整合：使用 IronOCR 建立文字辨識應用程式

我應該使用哪種安裝方法？

首先透過 NuGet 套件管理器安裝 IronOCR：

Install-Package IronOcr

Visual Studio 中的 NuGet 套件管理器視窗顯示了 IronOCR 套件的搜尋結果，其中包含可供安裝的各種語言套件。

!{--010011000100100101000010010100100100000101010010010110010101111101001110010101010101010101010101010101010101010 0100010111110100100101001101010100010000010100110001001100010111110100001001001100010011110010101010

對於進階安裝場景，請參閱NuGet 套件指南。 如果您要部署到特定平台，請查看Windows 、 Linux 、 macOS甚至Docker 容器的指南。

哪裡可以找到範例程式碼？

IronOCR維護多個GitHub倉庫，其中包含範例和教學。 IronOCR 官方範例庫提供了真實世界的實現，而圖像轉文字教學庫則展示了您可以複製和修改的實際用例。 這些儲存庫展示了OCR 條碼讀取、多語言支援和PDF 處理功能。 由於 NuGet 上經常發佈軟體包，您將始終能夠存取最新的穩定版本。 演示部分提供了更多互動式範例。

流程圖展示了 OCR 處理流程：GitHub OCR 程式碼庫 → IronOCR 專案 → OCR 處理 → 擷取的文字輸出

我應該採用哪種專案結構？

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

該結構支援多種輸入格式，包括JPG、PNG、TIFF 和 BMP 。 IronOCR 可以自動處理多頁 TIFF或GIF 檔案。

如何實作OCR處理程式碼？

以下是一個完整的 C# 程式碼範例，展示了 IronOCR 處理器的關鍵功能，包括影像預處理、文字擷取和條碼偵測：

using IronOcr;
using System;
using System.IO;
namespace MyOcrProject
{
    public class OcrProcessor
    {
        private readonly IronTesseract _ocr;
        public OcrProcessor()
        {
            _ocr = new IronTesseract();
            // Configure for optimal accuracy
            _ocr.Configuration.ReadBarCodes = true;
            _ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.Auto;
            _ocr.Language = OcrLanguage.English;
        }
        public void ProcessDocument(string imagePath)
        {
            using var input = new OcrInput();
            // Load and preprocess the image
            input.LoadImage(imagePath);
            input.Deskew();  // Straighten rotated images
            input.DeNoise(); // Remove digital noise
            input.EnhanceResolution(225); // Optimize DPI for OCR
            // Perform OCR
            var result = _ocr.Read(input);
            // Output results
            Console.WriteLine($"Confidence: {result.Confidence}%");
            Console.WriteLine($"Text Found:\n{result.Text}");
            // Process any barcodes found
            foreach (var barcode in result.Barcodes)
            {
                Console.WriteLine($"Barcode: {barcode.Value} ({barcode.Format})");
            }
            // Save as searchable PDF
            result.SaveAsSearchablePdf("output.pdf");
        }
    }
    class Program
    {
        static void Main(string[] args)
        {
            var processor = new OcrProcessor();
            processor.ProcessDocument("images/sample-invoice.jpg");
        }
    }
}

using IronOcr;
using System;
using System.IO;
namespace MyOcrProject
{
    public class OcrProcessor
    {
        private readonly IronTesseract _ocr;
        public OcrProcessor()
        {
            _ocr = new IronTesseract();
            // Configure for optimal accuracy
            _ocr.Configuration.ReadBarCodes = true;
            _ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.Auto;
            _ocr.Language = OcrLanguage.English;
        }
        public void ProcessDocument(string imagePath)
        {
            using var input = new OcrInput();
            // Load and preprocess the image
            input.LoadImage(imagePath);
            input.Deskew();  // Straighten rotated images
            input.DeNoise(); // Remove digital noise
            input.EnhanceResolution(225); // Optimize DPI for OCR
            // Perform OCR
            var result = _ocr.Read(input);
            // Output results
            Console.WriteLine($"Confidence: {result.Confidence}%");
            Console.WriteLine($"Text Found:\n{result.Text}");
            // Process any barcodes found
            foreach (var barcode in result.Barcodes)
            {
                Console.WriteLine($"Barcode: {barcode.Value} ({barcode.Format})");
            }
            // Save as searchable PDF
            result.SaveAsSearchablePdf("output.pdf");
        }
    }
    class Program
    {
        static void Main(string[] args)
        {
            var processor = new OcrProcessor();
            processor.ProcessDocument("images/sample-invoice.jpg");
        }
    }
}

這個綜合範例展示了 IronOCR 的多項功能。 建構函式配置 OCR 引擎，啟用條碼讀取和自動頁面分割功能。 ProcessDocument方法展示了影像預處理，包括去斜（校正旋轉）、去雜訊（去除偽影）和解析度增強。 處理後，它提取帶有置信度分數的英文文本，識別條碼，並產生可搜尋的 PDF 。

對於進階場景，您可以利用OcrInput 類別進行更多控制，使用非同步處理以獲得更好的效能，或為長時間運行的操作實現進度追蹤。 OcrResult 類別提供詳細的輸出數據，包括文字位置和OCR 結果。

開發者還可以輕鬆設定 IronOCR 來讀取其他語言，例如中文、西班牙語或法語，使其成為多語言 GitHub 專案的多功能選擇。 有關安裝其他語言套件的參考資料，請參閱125 種國際語言指南。 您甚至可以使用自訂語言檔案或訓練自訂字體。

分割畫面顯示 OCR 示範：左側顯示白色背景上的傾斜 Lorem Ipsum 文字，右側顯示 Visual Studio 偵錯控制台，其中包含提取的文字輸出和 87.34% 的置信度得分。

我應該在 .gitignore 檔案中新增哪些內容？

在你的 .gitignore 檔案中加入以下內容：

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

了解更多關於IronOCR 運行時資料夾和正確的許可證密鑰管理的資訊。

IronOCR 與其他 OCR 解決方案有何不同？

IronOCR 非常靈活，能夠識別單字、行和整個段落，讓您可以控制從每次掃描中提取的細節量。 圖書館擅長處理各種特殊文件類型，包括車牌、護照、 MICR支票、手寫文字、螢幕截圖、掃描文檔，甚至文件中的表格。

商業許可為公共儲存庫提供了法律上的明確性。 您被明確允許在商業應用中包含 IronOCR。 內建影像預處理濾鏡包括進階選項，例如色彩校正、品質增強，以及強大的濾鏡嚮導，可自動找到最佳設定。

單 DLL 架構為何如此重要？

IronOCR 的單一 DLL 架構意味著貢獻者可以複製您的儲存庫並立即開始開發，而無需像其他 OCR 解決方案那樣處理原生依賴項或平台特定的配置。 正是這種簡潔性使得開發者選擇IronOCR 而不是原始的 Tesseract 。 該庫包含Tesseract 5 ，具有多項效能改進和多執行緒支援。

如何在 Git 中處理大檔案？

git lfs track "*.jpg" "*.png" "*.tiff"
git add .gitattributes

git lfs track "*.jpg" "*.png" "*.tiff"
git add .gitattributes

在處理高解析度影像或多頁 TIFF 檔案時，這一點尤其重要。 對於低品質掃描，IronOCR 的預處理可以顯著改善結果。

我應該如何管理許可證密鑰和文件？

使用環境變數或使用者金鑰安全地儲存 IronOCR 許可證金鑰，切勿直接提交。 請按照IronOCR 許可證密鑰指南進行正確實施。 您也可以在 ASP.NET 應用程式的web.config 檔案中設定許可證。 請在 README 檔案中說明支援的影像格式和預期精度。 在測試資料資料夾中包含範例影像，供貢獻者驗證 OCR 功能。 對於跨平台開發，請參閱IronOCR Linux 設定指南或macOS 安裝說明。 行動開發者應該查看Android 指南和iOS 指南。

對於進階功能，文件中介紹了電腦視覺在文字檢測、頁面旋轉檢測、 hOCR 匯出以及長時間運行操作的超時配置方面的應用。 考慮為可取消的操作實現中止令牌。

為什麼Windows系統上的OCR功能無法正常運作？

常見的安裝問題包括 Windows 系統缺乏Visual C++ 可再發行元件套件。 IronOCR 需要 2019 版本。 有關詳細指導，請參閱Visual C++ Redistributable 故障排除指南。 對於 Linux 部署，請確保已安裝 libgdiplus 。 如果文字辨識效果不佳，請使用DPI 設定指南驗證您的影像是否至少為 200 DPI。 Stack Overflow上的 C# OCR 社群也為常見的 GitHub 專案問題提供了有用的解決方案。

如需具體問題，請參閱有關一般故障排除、 Azure Functions 部署、 AWS Lambda 問題或 .NET 7+ 的System.Drawing 替代方案的指南。 IronOCR實用工具可以幫助診斷配置問題。

我可以在哪裡獲得更多幫助？

如需詳細故障排除信息，請參閱IronOCR 故障排除指南。 IronOCR支援團隊為使用 GitHub 託管的 OCR 應用程式的授權使用者提供快速協助。 請查看產品變更日誌以取得最新更新，並查看API 參考文件以取得完整文件。