IronOCR을 사용하여 C#에서 진행 상황 추적을 사용하는 방법

이벤트 진행 상황에서 어떤 정보를 확인할 수 있나요?

OcrProgress 이벤트는 OCR 성능을 모니터링하고 최적화하는 데 도움이 되는 포괄적인 진행 상황 데이터를 제공합니다. 각 속성은 운영 추적에 있어 특정 목적을 수행합니다.

• ProgressPercent: 완료된 페이지 백분율로 나타나는 OCR 작업 진행 상황으로 0에서 100까지 범위입니다. GUI 애플리케이션에서 진행 막대를 업데이트하는 데 유용합니다.
• TotalPages: OCR 엔진이 처리하고 있는 총 페이지 수입니다. 예상 완료 시간을 계산하는 데 필수적입니다.
• PagesComplete: OCR 읽기가 완전히 완료된 페이지 수입니다. 이 수치는 페이지가 처리됨에 따라 점차 증가합니다.
• Duration: 전체 프로세스 완료에 걸린 시간을 나타내는 OCR 작업의 총 기간입니다. TimeSpan 형식으로 측정되며 이벤트가 발생할 때마다 업데이트됩니다.
• StartTimeUTC: OCR 작업이 시작된 날짜와 시간이며, 협정 세계시(UTC) 형식으로 표시됩니다.
• EndTimeUTC: OCR 작업이 100% 완료된 날짜와 시간으로, UTC 형식입니다. 이 속성은 OCR이 진행되는 동안에는 null이며, 프로세스가 완료되면 채워집니다.

고급 진행 상황 추적 구현

실제 운영 환경에서는 더욱 정교한 진행 상황 추적 기능을 구현하십시오. 이 예제에는 오류 처리 및 자세한 로깅 기능이 포함되어 있습니다.

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;
    }
}

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 요소를 안전하게 업데이트할 수 있습니다.

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");
        }
    }
}

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");
        }
    }
}

대용량 문서 작업 및 시간 초과

방대한 양의 문서를 처리할 때는 진행 상황 추적이 더욱 중요해집니다. 타임아웃 설정 및 중단 토큰 과 함께 사용하면 더욱 효과적인 제어가 가능합니다.

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");
    }
}

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 이벤트는 처리 중에 자주 발생합니다. 사용자 인터페이스나 로그에 과부하가 걸리지 않도록 업데이트 필터링을 고려해 보세요.

2. 성능 영향 : 진행 상황 추적은 성능 저하가 거의 없지만, 과도한 로깅이나 UI 업데이트는 OCR 프로세스 속도를 저하시킬 수 있습니다.

3. 메모리 관리 : 대용량 TIFF 파일 이나 PDF 파일의 경우, 최적의 성능을 보장하기 위해 진행 상황과 함께 메모리 사용량을 모니터링하십시오.

4. 오류 처리 : OCR 프로세스가 예외로 인해 중단되는 것을 방지하기 위해 진행 이벤트 핸들러에 항상 오류 처리를 포함하십시오.

5. 스레드 안전성: 진행 이벤트에서 UI 요소를 업데이트할 때 Invoke 또는 BeginInvoke 메소드를 사용하여 적절한 스레드 동기화를 보장하십시오.

결론

IronOCR의 진행률 추적 기능은 OCR 작업에 대한 필수적인 가시성을 제공하여 개발자가 사용자에게 처리 상태를 지속적으로 알려주는 반응형 애플리케이션을 만들 수 있도록 지원합니다. OcrProgress 이벤트를 효과적으로 활용함으로써, 단일 페이지 문서에서 광범위한 PDF 파일까지 모든 작업을 자신 있게 처리하는 전문 애플리케이션을 구축할 수 있습니다.

보다 고급 OCR 기술을 활용하려면 이미지 필터 및 결과 객체 에 대한 가이드를 참조하여 OCR 구현을 더욱 향상시키세요.