如何使用 IronOCR 在 C# 中使用進度追蹤。

IronOCR 為 OCR 作業提供了一個以事件為基礎的進度追蹤系統，讓開發人員可以透過 OcrProgress 事件來監控閱讀進度，該事件會即時報告完成百分比、處理的頁面以及時間指標。

<! -- --> <！--說明：說明程式碼概念的圖表或截圖 -->

快速入門：訂閱 OcrProgress 並閱讀 PDF

本範例展示如何使用 IronOCR 監控 OCR 進度：訂閱其內建的 OcrProgress 事件，並在閱讀 PDF 時接收即時回饋，包括百分比、已完成頁數和總頁數。 只需要幾行就可以開始。

如何在我的 OCR 應用程式中實作進度追蹤？ <！--說明：說明程式碼概念的圖表或截圖 --> 使用 OCR 處理大型文件或批次文件時，進度追蹤是不可或缺的。 訂閱`OcrProgress`事件即可接收閱讀過程的進度更新。 這對於 [PDF OCR 作業](https://ironsoftware.com/csharp/ocr/examples/csharp-pdf-ocr/)以及處理 [ 多頁 TIFF 檔案](https://ironsoftware.com/csharp/ocr/examples/csharp-tesseract-multipage-tiff/)時特別有用。 事件傳遞一個包含 OCR 工作進度資訊的實例，例如開始時間、總頁數、進度百分比、持續時間和結束時間。此功能可與[async作業](https://ironsoftware.com/csharp/ocr/how-to/async/)無縫運作，並可結合[多執行緒](https://ironsoftware.com/csharp/ocr/examples/csharp-tesseract-multithreading-for-speed/)以增強效能。 The following example uses this document as a sample: "Experiences in Biodiversity Research: A Field Course" by Thea B. 蓋斯勒，愛荷華州立大學。 ```csharp :path=/static-assets/ocr/content-code-examples/how-to/progress-tracking-progress-tracking.cs ```

我可以從活動中取得哪些進度資訊？ OcrProgress 事件提供全面的進度資料，有助於監控和最佳化 [OCR 效能](https://ironsoftware.com/csharp/ocr/examples/progress-tracking/)。 每個屬性都有追蹤作業的特定目的： - `ProgressPercent`：OCR 工作的進度，以完成頁數的百分比表示，範圍從 0 到 100。對於更新 GUI 應用程式中的進度列非常有用。 - `TotalPages`: OCR 引擎正在處理的總頁數。對於計算預計完成時間來說非常重要。 - `PagesComplete`：已完全完成 OCR 讀取的頁數。 此數量會隨著頁面的處理而逐漸增加。 - `持續時間`：OCR 工作的總持續時間，表示整個流程完成所需的時間。 以 TimeSpan 格式測量，並在每次事件觸發時更新。 - `StartTimeUTC`：OCR 工作開始的日期和時間，以 Coordinated Universal Time (UTC) 格式表示。 - `EndTimeUTC`：OCR 工作 100% 完成的日期和時間，以 UTC 格式表示。 此屬性在 OCR 進行中時為空，並在過程結束後填入。 ### 進階進度追蹤實作 針對生產應用程式，實施更精密的進度追蹤。 本範例包括錯誤處理和詳細記錄： ```csharp using IronOcr; using System; using System.Diagnostics; public class OcrProgressTracker { private readonly IronTesseract _tesseract; private Stopwatch _stopwatch; private int _lastReportedPercent = 0; public OcrProgressTracker() { _tesseract = new IronTesseract(); // Configure for optimal performance _tesseract.Language = OcrLanguage.EnglishBest; _tesseract.Configuration.ReadBarCodes = false; // Subscribe to progress event _tesseract.OcrProgress += OnOcrProgress; } private void OnOcrProgress(object sender, OcrProgressEventsArgs e) { // Only report significant progress changes (every 10%) if (e.ProgressPercent - _lastReportedPercent >= 10 || e.ProgressPercent == 100) { _lastReportedPercent = e.ProgressPercent; Console.WriteLine($"Progress: {e.ProgressPercent}%"); Console.WriteLine($"Pages: {e.PagesComplete}/{e.TotalPages}"); Console.WriteLine($"Elapsed: {e.Duration.TotalSeconds:F1}s"); // Estimate remaining time if (e.ProgressPercent > 0 && e.ProgressPercent < 100) { var estimatedTotal = e.Duration.TotalSeconds / (e.ProgressPercent / 100.0); var remaining = estimatedTotal - e.Duration.TotalSeconds; Console.WriteLine($"Estimated remaining: {remaining:F1}s"); } Console.WriteLine("---"); } } public OcrResult ProcessDocument(string filePath) { _stopwatch = Stopwatch.StartNew(); using var input = new OcrInput(); input.LoadPdf(filePath); // Apply image filters for better accuracy input.Deskew(); input.DeNoise(); var result = _tesseract.Read(input); _stopwatch.Stop(); Console.WriteLine($"Total processing time: {_stopwatch.Elapsed.TotalSeconds:F1}s"); return result; } } ``` ### 整合進度追蹤與 UI 應用程式。 當使用 Windows Forms 或 WPF 建立桌面應用程式時，進度追蹤對使用者體驗非常重要。 進度事件可以安全地更新 UI 元素： ```csharp using System; using System.Windows.Forms; using IronOcr; public partial class OcrForm : Form { private IronTesseract _tesseract; private ProgressBar progressBar; private Label statusLabel; public OcrForm() { InitializeComponent(); _tesseract = new IronTesseract(); _tesseract.OcrProgress += UpdateProgress; } private void UpdateProgress(object sender, OcrProgressEventsArgs e) { // Ensure UI updates happen on the main thread if (InvokeRequired) { BeginInvoke(new Action(() => UpdateProgress(sender, e))); return; } progressBar.Value = e.ProgressPercent; statusLabel.Text = $"Processing page {e.PagesComplete} of {e.TotalPages}"; // Show completion message if (e.ProgressPercent == 100) { MessageBox.Show($"OCR completed in {e.Duration.TotalSeconds:F1} seconds"); } } } ``` ### 處理大型文件和超時問題 在處理大量文件時，進度追蹤變得更有價值。 結合[逾時設定](https://ironsoftware.com/csharp/ocr/examples/timeouts/)和[中止令牌](https://ironsoftware.com/csharp/ocr/examples/abort-token/)，以達到更好的控制效果： ```csharp using IronOcr; using System; using System.Threading; public async Task ProcessLargeDocumentWithTimeout() { var cts = new CancellationTokenSource(); var tesseract = new IronTesseract(); // Set a timeout of 5 minutes cts.CancelAfter(TimeSpan.FromMinutes(5)); tesseract.OcrProgress += (s, e) => { Console.WriteLine($"Progress: {e.ProgressPercent}% - Page {e.PagesComplete}/{e.TotalPages}"); // Check if we should cancel based on progress if (e.Duration.TotalMinutes > 4 && e.ProgressPercent < 50) { Console.WriteLine("Processing too slow, cancelling..."); cts.Cancel(); } }; try { using var input = new OcrInput(); input.LoadPdf("large-document.pdf"); var result = await Task.Run(() => tesseract.Read(input, cts.Token), cts.Token); Console.WriteLine("OCR completed successfully"); } catch (OperationCanceledException) { Console.WriteLine("OCR operation was cancelled"); } } ``` ### 進度追蹤的最佳實務 1.**更新頻率**：在處理過程中，`OcrProgress` 事件會頻繁發生。 請考慮過濾更新內容，以免 UI 或日誌不堪負荷。 2.**效能影響**：進度追蹤的效能開銷極小，但過度的日誌記錄或 UI 更新可能會導致 OCR 過程變慢。 3.**記憶體管理**：對於[大型 TIFF 檔案](https://ironsoftware.com/csharp/ocr/how-to/input-tiff-gif/)或 PDF，請隨著進度監控記憶體使用量，以確保最佳效能。 4.**錯誤處理**：務必在您的進度事件處理器中包含錯誤處理，以防止異常打亂 OCR 程序。 5.**線程安全**：從進度事件更新 UI 元素時，請使用 `Invoke` 或 `BeginInvoke` 方法確保適當的線程同步。 ### 結論 IronOCR 中的進度追蹤可提供 OCR 作業的基本可見性，讓開發人員能夠建立反應迅速的應用程式，讓使用者隨時瞭解處理狀態。 透過有效地利用 `OcrProgress` 事件，您可以建立專業的應用程式，自信地處理從單頁文件到廣泛 PDF 檔案的一切內容。 如需更進階的 OCR 技術，請參閱我們關於 [ 影像篩選器](https://ironsoftware.com/csharp/ocr/examples/ocr-image-filters-for-net-tesseract/) 和 [ 結果物件](https://ironsoftware.com/csharp/ocr/examples/results-objects/) 的指南，以進一步強化您的 OCR 實作。