Cómo utilizar el seguimiento del progreso en C# con IronOCR

¿A qué información de progreso puedo acceder desde el evento?

El evento OcrProgress proporciona datos de progreso completos que ayudan a supervisar y optimizar el rendimiento deOCR. Cada propiedad tiene un propósito específico en el seguimiento de la operación:

• ProgressPercent: Progreso del trabajo de OCR como porcentaje de páginas completadas, que va de 0 a 100. Útil para actualizar barras de progreso en aplicaciones GUI.
• TotalPages: Número total de páginas que está procesando el motor de OCR. Esencial para calcular los tiempos estimados de finalización.
• PagesComplete: Número de páginas en las que se ha completado la lectura OCR. Este recuento aumenta gradualmente a medida que se procesan las páginas.
• Duración: duración total del trabajo de OCR, que indica el tiempo necesario para completar todo el proceso. Medido en formato TimeSpan y actualizado cada vez que se dispara el evento.
• StartTimeUTC: Fecha y hora de inicio del trabajo de OCR, representadas en formato de Tiempo Universal Coordinado (UTC).
• EndTimeUTC: Fecha y hora en la que el trabajo de OCR se completó al 100% en formato UTC. Esta propiedad es nula mientras el OCR está en curso y se rellena una vez finalizado el proceso.

Implementación avanzada de seguimiento del progreso

Para las aplicaciones de producción, implemente un seguimiento del progreso más sofisticado. Este ejemplo incluye la gestión de errores y un registro detallado:

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

Integración del seguimiento del progreso con aplicaciones de interfaz de usuario

Cuando se crean aplicaciones de escritorio con Windows Forms o WPF, el seguimiento del progreso es crucial para la experiencia del usuario. El evento de progreso puede actualizar elementos de la interfaz de usuario de forma segura:

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

Trabajar con documentos grandes y tiempos de espera

Al procesar documentos extensos, el seguimiento del progreso resulta aún más valioso. Combínalo con configuraciones de tiempo de espera y fichas de aborto para un mejor control:

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

Mejores prácticas para el seguimiento del progreso

1. Frecuencia de las actualizaciones: El evento OcrProgress se dispara con frecuencia durante el procesamiento. Considere la posibilidad de filtrar las actualizaciones para evitar saturar la interfaz de usuario o los registros.

2. Impacto en el rendimiento: El seguimiento del progreso tiene una sobrecarga de rendimiento mínima, pero el registro excesivo o las actualizaciones de la interfaz de usuario pueden ralentizar el proceso de OCR.

3. Gestión de memoria: Para archivos TIFF o PDF de gran tamaño, supervisa el uso de memoria junto con el progreso para garantizar un rendimiento óptimo.

4. Manejo de errores: Incluya siempre el manejo de errores en sus manejadores de eventos de progreso para evitar que las excepciones interrumpan el proceso de OCR.

5. Thread Safety: Al actualizar los elementos de la interfaz de usuario desde el evento de progreso, asegúrese de que existe una sincronización de hilos adecuada mediante los métodos Invoke o BeginInvoke.

Conclusión

El seguimiento del progreso en IronOCR proporciona una visibilidad esencial de las operaciones de OCR, lo que permite a los desarrolladores crear aplicaciones con capacidad de respuesta que mantienen a los usuarios informados sobre el estado del procesamiento. Si aprovecha el evento OcrProgress de forma eficaz, podrá crear aplicaciones profesionales que gestionen con confianza desde documentos de una sola página hasta extensos archivos PDF.

Para técnicas de OCR más avanzadas, explore nuestras guías sobre filtros de imagen y objetos de resultado para mejorar aún más sus implementaciones de OCR.