AWS Textract vs IronOCR para España: Cumplimiento AEAT, Facturae, LOPDGDD y TicketBAI

El ciclo de vida de la identificación de imágenes

La característica arquitectónica que define a GdPicture es la gestión de identificadores de imagen enteros. Cargar cualquier imagen asigna memoria dentro del tiempo de ejecución de GdPicture y devuelve un manejador de int. Utilizas ese número entero para hacer referencia a la imagen en todas las llamadas posteriores. Cuando terminas, llamas a ReleaseGdPictureImage con ese entero. Si no lo hace, la memoria no se liberará hasta que finalice el proceso.

using GdPicture14;

// Every image load returns an integer handle
int imageId = _imaging.CreateGdPictureImageFromFile(imagePath);

if (imageId == 0)
{
    throw new Exception($"Failed to load image: {_imaging.GetStat()}");
}

try
{
    _ocr.SetImage(imageId);
    _ocr.Language = "eng";

    string resultId = _ocr.RunOCR();

    if (string.IsNullOrEmpty(resultId))
    {
        throw new Exception($"OCR failed: {_ocr.GetStat()}");
    }

    return _ocr.GetOCRResultText(resultId);
}
finally
{
    // CRITICAL: omitting this line causes a memory leak
    _imaging.ReleaseGdPictureImage(imageId);
}

using GdPicture14;

// Every image load returns an integer handle
int imageId = _imaging.CreateGdPictureImageFromFile(imagePath);

if (imageId == 0)
{
    throw new Exception($"Failed to load image: {_imaging.GetStat()}");
}

try
{
    _ocr.SetImage(imageId);
    _ocr.Language = "eng";

    string resultId = _ocr.RunOCR();

    if (string.IsNullOrEmpty(resultId))
    {
        throw new Exception($"OCR failed: {_ocr.GetStat()}");
    }

    return _ocr.GetOCRResultText(resultId);
}
finally
{
    // CRITICAL: omitting this line causes a memory leak
    _imaging.ReleaseGdPictureImage(imageId);
}

Imports GdPicture14

' Every image load returns an integer handle
Dim imageId As Integer = _imaging.CreateGdPictureImageFromFile(imagePath)

If imageId = 0 Then
    Throw New Exception($"Failed to load image: {_imaging.GetStat()}")
End If

Try
    _ocr.SetImage(imageId)
    _ocr.Language = "eng"

    Dim resultId As String = _ocr.RunOCR()

    If String.IsNullOrEmpty(resultId) Then
        Throw New Exception($"OCR failed: {_ocr.GetStat()}")
    End If

    Return _ocr.GetOCRResultText(resultId)
Finally
    ' CRITICAL: omitting this line causes a memory leak
    _imaging.ReleaseGdPictureImage(imageId)
End Try

Al procesar archivos PDF de varias páginas, cada página renderizada genera un ID de imagen independiente. Un documento de 100 páginas a 200 ppp puede consumir entre 1 y 5 GB de memoria si no se realiza la limpieza correspondiente. El patrón correcto requiere reunir todos los ID y liberarlos en un bloque finally, pero esa disciplina recae completamente en el desarrollador.

Comparación detallada de características

Enfoque GdPicture

Cada imagen en GdPicture existe como un identificador entero en un grupo administrado en tiempo de ejecución. Se obtiene el identificador cargando una imagen, se pasa ese número entero al OCR y a otras operaciones, y luego se libera cuando se termina. El patrón es explícito y correcto cuando se sigue. El problema es que es fácil equivocarse, y la consecuencia es un crecimiento ilimitado de la memoria.

El flujo de trabajo de OCR de PDF demuestra el riesgo con mayor claridad. Cada llamada a pdf.RenderPageToGdPictureImage() asigna una nueva imagen rasterizada en memoria y devuelve un nuevo ID entero. Un documento de 100 páginas crea 100 asignaciones separadas. Omitir una llamada ReleaseGdPictureImage y el proceso acumula memoria perdida:

using GdPicture14;

public string ExtractTextFromPdf(string pdfPath)
{
    var text = new StringBuilder();

    using var pdf = new GdPicturePDF();

    GdPictureStatus status = pdf.LoadFromFile(pdfPath, false);
    if (status != GdPictureStatus.OK)
        throw new Exception($"Failed to load PDF: {status}");

    int pageCount = pdf.GetPageCount();

    for (int i = 1; i <= pageCount; i++)
    {
        pdf.SelectPage(i);

        // Each page render = new memory allocation + new integer ID
        int imageId = pdf.RenderPageToGdPictureImage(200, false);

        if (imageId == 0) continue;

        try
        {
            _ocr.SetImage(imageId);
            _ocr.Language = "eng";
            string resultId = _ocr.RunOCR();

            if (!string.IsNullOrEmpty(resultId))
                text.AppendLine(_ocr.GetOCRResultText(resultId));
        }
        finally
        {
            // Without this: ~10–50MB leaked per page
            _imaging.ReleaseGdPictureImage(imageId);
        }
    }

    return text.ToString();
}

using GdPicture14;

public string ExtractTextFromPdf(string pdfPath)
{
    var text = new StringBuilder();

    using var pdf = new GdPicturePDF();

    GdPictureStatus status = pdf.LoadFromFile(pdfPath, false);
    if (status != GdPictureStatus.OK)
        throw new Exception($"Failed to load PDF: {status}");

    int pageCount = pdf.GetPageCount();

    for (int i = 1; i <= pageCount; i++)
    {
        pdf.SelectPage(i);

        // Each page render = new memory allocation + new integer ID
        int imageId = pdf.RenderPageToGdPictureImage(200, false);

        if (imageId == 0) continue;

        try
        {
            _ocr.SetImage(imageId);
            _ocr.Language = "eng";
            string resultId = _ocr.RunOCR();

            if (!string.IsNullOrEmpty(resultId))
                text.AppendLine(_ocr.GetOCRResultText(resultId));
        }
        finally
        {
            // Without this: ~10–50MB leaked per page
            _imaging.ReleaseGdPictureImage(imageId);
        }
    }

    return text.ToString();
}

Imports GdPicture14
Imports System.Text

Public Function ExtractTextFromPdf(ByVal pdfPath As String) As String
    Dim text As New StringBuilder()

    Using pdf As New GdPicturePDF()
        Dim status As GdPictureStatus = pdf.LoadFromFile(pdfPath, False)
        If status <> GdPictureStatus.OK Then
            Throw New Exception($"Failed to load PDF: {status}")
        End If

        Dim pageCount As Integer = pdf.GetPageCount()

        For i As Integer = 1 To pageCount
            pdf.SelectPage(i)

            ' Each page render = new memory allocation + new integer ID
            Dim imageId As Integer = pdf.RenderPageToGdPictureImage(200, False)

            If imageId = 0 Then Continue For

            Try
                _ocr.SetImage(imageId)
                _ocr.Language = "eng"
                Dim resultId As String = _ocr.RunOCR()

                If Not String.IsNullOrEmpty(resultId) Then
                    text.AppendLine(_ocr.GetOCRResultText(resultId))
                End If
            Finally
                ' Without this: ~10–50MB leaked per page
                _imaging.ReleaseGdPictureImage(imageId)
            End Try
        Next
    End Using

    Return text.ToString()
End Function

El procesamiento por lotes en múltiples archivos PDF agrava este problema. La documentación para cada bucle for debe llevar una nota recordando a los mantenedores que recojan los ID en un List<int> y que los liberen todos en finally. Eso es trabajo de infraestructura, no trabajo de OCR.

Enfoque de IronOCR

OcrInput es un estándar IDisposable. Una declaración using garantiza la limpieza ya sea que el método devuelva normalmente o lance. No hay identificadores enteros que rastrear, ni un componente de imagen independiente que inicializar, ni un paso de renderizado DPI externo para las páginas PDF.

using IronOcr;

public string ExtractTextFromPdf(string pdfPath)
{
    // LoadPdf handles page rendering internally
    using var input = new OcrInput();
    input.LoadPdf(pdfPath);

    var result = new IronTesseract().Read(input);

    foreach (var page in result.Pages)
        Console.WriteLine($"Page {page.PageNumber}: {page.Text}");

    return result.Text;
    // using block exits — all internal resources released automatically
}

using IronOcr;

public string ExtractTextFromPdf(string pdfPath)
{
    // LoadPdf handles page rendering internally
    using var input = new OcrInput();
    input.LoadPdf(pdfPath);

    var result = new IronTesseract().Read(input);

    foreach (var page in result.Pages)
        Console.WriteLine($"Page {page.PageNumber}: {page.Text}");

    return result.Text;
    // using block exits — all internal resources released automatically
}

Imports IronOcr

Public Function ExtractTextFromPdf(pdfPath As String) As String
    ' LoadPdf handles page rendering internally
    Using input As New OcrInput()
        input.LoadPdf(pdfPath)

        Dim result = New IronTesseract().Read(input)

        For Each page In result.Pages
            Console.WriteLine($"Page {page.PageNumber}: {page.Text}")
        Next

        Return result.Text
        ' using block exits — all internal resources released automatically
    End Using
End Function

Para los archivos PDF protegidos con contraseña, el parámetro es un argumento con nombre en lugar de una sobrecarga separada que requiere una comprobación de estado adicional:

using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");

var result = new IronTesseract().Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");

using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");

var result = new IronTesseract().Read(input);
result.SaveAsSearchablePdf("searchable-output.pdf");

Imports IronOcr

Using input As New OcrInput()
    input.LoadPdf("encrypted.pdf", Password:="secret")

    Dim result = New IronTesseract().Read(input)
    result.SaveAsSearchablePdf("searchable-output.pdf")
End Using

La guía de entrada de PDF de IronOCR incluye opciones adicionales, como la selección de rangos de páginas. Para equipos que ya están familiarizados con patrones IDisposable en Entity Framework, HttpClient y manejo de flujos, OcrInput no requiere un nuevo modelo mental.

Enfoque GdPicture

El flujo de trabajo completo para un PDF escaneado de baja calidad (carga, preprocesamiento, OCR de cada página, publicación) abarca tres clases de componentes y requiere una comprobación de estado minuciosa en cada paso:

using GdPicture14;

public void CreateSearchablePdf(string inputPdf, string outputPdf)
{
    using var pdf = new GdPicturePDF();

    GdPictureStatus status = pdf.LoadFromFile(inputPdf, false);
    if (status != GdPictureStatus.OK)
        throw new Exception($"Load failed: {status}");

    int pageCount = pdf.GetPageCount();

    for (int i = 1; i <= pageCount; i++)
    {
        pdf.SelectPage(i);

        // OcrPage adds text layer to each page
        // Requires: OCR plugin + PDF plugin + resource folder path
        GdPictureStatus ocrStatus = pdf.OcrPage(
            "eng",
            @"C:\GdPicture\Resources\OCR",  // Carpeta de recursos externos required
            "",
            200
        );

        if (ocrStatus != GdPictureStatus.OK)
            Console.WriteLine($"Warning: Page {i} OCR failed: {ocrStatus}");
    }

    pdf.SaveToFile(outputPdf, true);
}

using GdPicture14;

public void CreateSearchablePdf(string inputPdf, string outputPdf)
{
    using var pdf = new GdPicturePDF();

    GdPictureStatus status = pdf.LoadFromFile(inputPdf, false);
    if (status != GdPictureStatus.OK)
        throw new Exception($"Load failed: {status}");

    int pageCount = pdf.GetPageCount();

    for (int i = 1; i <= pageCount; i++)
    {
        pdf.SelectPage(i);

        // OcrPage adds text layer to each page
        // Requires: OCR plugin + PDF plugin + resource folder path
        GdPictureStatus ocrStatus = pdf.OcrPage(
            "eng",
            @"C:\GdPicture\Resources\OCR",  // Carpeta de recursos externos required
            "",
            200
        );

        if (ocrStatus != GdPictureStatus.OK)
            Console.WriteLine($"Warning: Page {i} OCR failed: {ocrStatus}");
    }

    pdf.SaveToFile(outputPdf, true);
}

Imports GdPicture14

Public Sub CreateSearchablePdf(inputPdf As String, outputPdf As String)
    Using pdf As New GdPicturePDF()

        Dim status As GdPictureStatus = pdf.LoadFromFile(inputPdf, False)
        If status <> GdPictureStatus.OK Then
            Throw New Exception($"Load failed: {status}")
        End If

        Dim pageCount As Integer = pdf.GetPageCount()

        For i As Integer = 1 To pageCount
            pdf.SelectPage(i)

            ' OcrPage adds text layer to each page
            ' Requires: OCR plugin + PDF plugin + resource folder path
            Dim ocrStatus As GdPictureStatus = pdf.OcrPage(
                "eng",
                "C:\GdPicture\Resources\OCR",  ' Carpeta de recursos externos required
                "",
                200
            )

            If ocrStatus <> GdPictureStatus.OK Then
                Console.WriteLine($"Warning: Page {i} OCR failed: {ocrStatus}")
            End If
        Next

        pdf.SaveToFile(outputPdf, True)
    End Using
End Sub

La ruta ResourceFolder no es opcional. Debe resolverse a un directorio que contenga los archivos de idioma .traineddata en tiempo de ejecución. Esa ruta funciona en la máquina de desarrollo, pero falla en producción cuando la cuenta de servicio no puede ver C:\GdPicture\Resources\OCR, o cuando la aplicación se despliega en Linux, o cuando las imágenes de Dockerno incluyen esa estructura de directorio. Depurar estos fallos a menudo significa perseguir códigos de error genéricos GdPictureStatus que dicen poco sobre la causa raíz.

Enfoque de IronOCR

El flujo de trabajo equivalente en IronOCR, que incluye el preprocesamiento para la corrección de inclinación y la eliminación de ruido, consta de cinco líneas:

using IronOcr;

public void CreateSearchablePdf(string inputPdf, string outputPdf)
{
    var ocr = new IronTesseract();

    using var input = new OcrInput();
    input.LoadPdf(inputPdf);
    input.Deskew();   // No separate plugin required
    input.DeNoise();

    var result = ocr.Read(input);
    result.SaveAsSearchablePdf(outputPdf);
}

using IronOcr;

public void CreateSearchablePdf(string inputPdf, string outputPdf)
{
    var ocr = new IronTesseract();

    using var input = new OcrInput();
    input.LoadPdf(inputPdf);
    input.Deskew();   // No separate plugin required
    input.DeNoise();

    var result = ocr.Read(input);
    result.SaveAsSearchablePdf(outputPdf);
}

Imports IronOcr

Public Sub CreateSearchablePdf(inputPdf As String, outputPdf As String)
    Dim ocr As New IronTesseract()

    Using input As New OcrInput()
        input.LoadPdf(inputPdf)
        input.Deskew()   ' No separate plugin required
        input.DeNoise()

        Dim result = ocr.Read(input)
        result.SaveAsSearchablePdf(outputPdf)
    End Using
End Sub

El soporte para el idioma inglés está integrado en el paquete NuGet . Los idiomas adicionales se instalan como paquetes de NuGet (IronOcr.Languages.French) en lugar de archivos .traineddata en una ruta del sistema de archivos. La guía de corrección de calidad de imagen y la guía de corrección de orientación de imagen cubren el conjunto completo de opciones de preprocesamiento disponibles en OcrInput.

Para el procesamiento que tiene en cuenta la confianza —por ejemplo, filtrar los resultados por debajo de un umbral antes de escribirlos en una base de datos— el objeto de resultado expone la confianza directamente:

var result = new IronTesseract().Read("scanned.jpg");
Console.WriteLine($"Confidence: {result.Confidence}%");

// Per-word confidence for fine-grained filtering
var highConfidenceWords = result.Words
    .Where(w => w.Confidence > 85)
    .Select(w => w.Text);

var result = new IronTesseract().Read("scanned.jpg");
Console.WriteLine($"Confidence: {result.Confidence}%");

// Per-word confidence for fine-grained filtering
var highConfidenceWords = result.Words
    .Where(w => w.Confidence > 85)
    .Select(w => w.Text);

Imports System
Imports System.Linq

Dim result = (New IronTesseract()).Read("scanned.jpg")
Console.WriteLine($"Confidence: {result.Confidence}%")

' Per-word confidence for fine-grained filtering
Dim highConfidenceWords = result.Words _
    .Where(Function(w) w.Confidence > 85) _
    .Select(Function(w) w.Text)

GdPicture requiere tres bucles anidados — bloques, líneas, palabras — para alcanzar los mismos datos, con llamadas a métodos basadas en índice en cada nivel (GetOCRResultBlockLineWordConfidence(resultId, b, l, w)). La guía práctica sobre puntuaciones de confianza demuestra el modelo de acceso estructurado para casos de uso comunes.

Enfoque GdPicture

GdPicture devuelve una cadena resultId desde RunOCR(), y todos los datos de resultado se consultan a través de ese ID mediante llamadas a métodos en la instancia GdPictureOCR. Para alcanzar el nivel de confianza por palabra, es necesario iterar a través de tres niveles anidados:

using GdPicture14;

public List<(string word, float confidence)> GetWordConfidences(int imageId)
{
    var words = new List<(string, float)>();

    _ocr.SetImage(imageId);
    _ocr.Language = "eng";
    string resultId = _ocr.RunOCR();

    int blockCount = _ocr.GetOCRResultBlockCount(resultId);

    for (int b = 0; b < blockCount; b++)
    {
        int lineCount = _ocr.GetOCRResultBlockLineCount(resultId, b);

        for (int l = 0; l < lineCount; l++)
        {
            int wordCount = _ocr.GetOCRResultBlockLineWordCount(resultId, b, l);

            for (int w = 0; w < wordCount; w++)
            {
                string word = _ocr.GetOCRResultBlockLineWordText(resultId, b, l, w);
                float conf = _ocr.GetOCRResultBlockLineWordConfidence(resultId, b, l, w);
                words.Add((word, conf));
            }
        }
    }

    return words;
}

using GdPicture14;

public List<(string word, float confidence)> GetWordConfidences(int imageId)
{
    var words = new List<(string, float)>();

    _ocr.SetImage(imageId);
    _ocr.Language = "eng";
    string resultId = _ocr.RunOCR();

    int blockCount = _ocr.GetOCRResultBlockCount(resultId);

    for (int b = 0; b < blockCount; b++)
    {
        int lineCount = _ocr.GetOCRResultBlockLineCount(resultId, b);

        for (int l = 0; l < lineCount; l++)
        {
            int wordCount = _ocr.GetOCRResultBlockLineWordCount(resultId, b, l);

            for (int w = 0; w < wordCount; w++)
            {
                string word = _ocr.GetOCRResultBlockLineWordText(resultId, b, l, w);
                float conf = _ocr.GetOCRResultBlockLineWordConfidence(resultId, b, l, w);
                words.Add((word, conf));
            }
        }
    }

    return words;
}

Imports GdPicture14

Public Function GetWordConfidences(imageId As Integer) As List(Of (word As String, confidence As Single))
    Dim words As New List(Of (String, Single))()

    _ocr.SetImage(imageId)
    _ocr.Language = "eng"
    Dim resultId As String = _ocr.RunOCR()

    Dim blockCount As Integer = _ocr.GetOCRResultBlockCount(resultId)

    For b As Integer = 0 To blockCount - 1
        Dim lineCount As Integer = _ocr.GetOCRResultBlockLineCount(resultId, b)

        For l As Integer = 0 To lineCount - 1
            Dim wordCount As Integer = _ocr.GetOCRResultBlockLineWordCount(resultId, b, l)

            For w As Integer = 0 To wordCount - 1
                Dim word As String = _ocr.GetOCRResultBlockLineWordText(resultId, b, l, w)
                Dim conf As Single = _ocr.GetOCRResultBlockLineWordConfidence(resultId, b, l, w)
                words.Add((word, conf))
            Next
        Next
    Next

    Return words
End Function

Esto no es incorrecto; los datos son accesibles. Pero requiere comprender y mantener un índice tridimensional de la estructura de resultados para cada proyecto que necesite datos a nivel de palabra.

Enfoque de IronOCR

OcrResult expone .Words como una colección tipada. LINQ funciona directamente en contra de ello:

using IronOcr;

var result = new IronTesseract().Read("invoice.jpg");

// All words with position and confidence
foreach (var word in result.Words)
{
    Console.WriteLine($"'{word.Text}' at ({word.X},{word.Y}) — {word.Confidence:P0}");
}

// Lines, paragraphs, and pages follow the same pattern
foreach (var line in result.Lines)
    Console.WriteLine(line.Text);

foreach (var page in result.Pages)
    Console.WriteLine($"Page {page.PageNumber}: {page.Text.Length} characters");

using IronOcr;

var result = new IronTesseract().Read("invoice.jpg");

// All words with position and confidence
foreach (var word in result.Words)
{
    Console.WriteLine($"'{word.Text}' at ({word.X},{word.Y}) — {word.Confidence:P0}");
}

// Lines, paragraphs, and pages follow the same pattern
foreach (var line in result.Lines)
    Console.WriteLine(line.Text);

foreach (var page in result.Pages)
    Console.WriteLine($"Page {page.PageNumber}: {page.Text.Length} characters");

Imports IronOcr

Dim result = New IronTesseract().Read("invoice.jpg")

' All words with position and confidence
For Each word In result.Words
    Console.WriteLine($"'{word.Text}' at ({word.X},{word.Y}) — {word.Confidence:P0}")
Next

' Lines, paragraphs, and pages follow the same pattern
For Each line In result.Lines
    Console.WriteLine(line.Text)
Next

For Each page In result.Pages
    Console.WriteLine($"Page {page.PageNumber}: {page.Text.Length} characters")
Next

El OCR basado en regiones —que extrae texto de un rectángulo definido de un documento— es igualmente directo:

var region = new CropRectangle(0, 0, 600, 100); // header area

using var input = new OcrInput();
input.LoadImage("invoice.jpg", region);

var headerText = new IronTesseract().Read(input).Text;

var region = new CropRectangle(0, 0, 600, 100); // header area

using var input = new OcrInput();
input.LoadImage("invoice.jpg", region);

var headerText = new IronTesseract().Read(input).Text;

Imports IronOcr

Dim region As New CropRectangle(0, 0, 600, 100) ' header area

Using input As New OcrInput()
    input.LoadImage("invoice.jpg", region)

    Dim headerText As String = New IronTesseract().Read(input).Text
End Using

La guía de resultados de lectura y la guía de OCR basada en regiones muestran cómo estos patrones se extienden a documentos de varias páginas y a flujos de trabajo de extracción de campos estructurados.

El OCR es el único requisito.

Los equipos que implementan sistemas de ingesta de documentos (recepción de facturas escaneadas, procesamiento de formularios médicos, extracción de texto de contratos) suelen evaluar GdPicture porque aparece en los directorios de software Enterprise junto con LEADTOOLS y Kofax. Una vez que la tabla de dependencias de los complementos quede clara, la situación cambia. El complemento PDF no es opcional si se requiere la entrada de archivos PDF. El complemento de procesamiento de imágenes de documentos no es opcional si se requiere preprocesamiento. Un equipo que necesita OCR de PDFs escaneados con corrección de deskew termina con tres licencias de complementos a un costo inicial significantemente alto de Professional. Cuando el requisito es extracción de texto y nada más en la lista de características de GdPicture es necesario, ese precio representa puro gasto.IronOCR en $2,999 Professional cubre el flujo de trabajo idéntico: entrada de imagen, entrada de PDF, preprocesamiento, salida de PDF con capacidad de búsqueda, desde un único paquete sin decisiones de complemento que tomar.

Incidentes de fugas de memoria en producción

El ciclo de vida de los identificadores enteros se convierte en un problema potencial en los servicios de procesamiento de documentos de alto rendimiento. Un punto final de API web que procesa archivos PDF cargados bajo presión eventualmente tendrá una ruta de código donde no se alcanza la llamada para liberar la imagen: un retorno prematuro en una rama de error, una excepción no controlada antes del bloque de limpieza o simplemente un nuevo desarrollador que no está familiarizado con el patrón agrega un método auxiliar que toma un identificador de imagen entero como parámetro y olvida liberarlo. La memoria aumenta, el servicio se ralentiza y la causa raíz no es evidente en un volcado de memoria. Los equipos que han depurado uno de estos incidentes suelen preferir un modelo donde el entorno de ejecución se encargue de la limpieza. El patrón de eliminación estándar en IronOCR es precisamente ese modelo: una limpieza estructurada impuesta por el compilador, en lugar de por la disciplina del desarrollador en cada llamada.

Fricción de actualización de versión

GdPicture incorpora el número de versión principal en su espacio de nombres. La actualización de la versión 14 a la versión 15 requiere actualizar esa directiva de espacio de nombres en cada archivo fuente que haga referencia a las clases GdPicture. En una aplicación de gran tamaño con OCR, manejo de PDF y procesamiento de imágenes distribuidos en docenas de servicios y clases de utilidad, esa es una tarea de migración compleja y no proporciona ningún beneficio funcional. Todas las bibliotecas .NET modernas, desde Microsoft.EntityFrameworkCore hasta Newtonsoft.Json, utilizan espacios de nombres independientes de la versión, gestionando el versionado a través del número de versión del paquete NuGet .IronOCR sigue esa convención: la misma importación de espacio de nombres se aplica desde la versión 1 hasta la versión actual.

Implementación de microservicios y contenedores

GdPicture OCR requiere que una carpeta de recursos externa que contenga archivos de datos de idioma esté presente en una ruta específica durante la ejecución. En una implementación en contenedores, esto implica integrar esos archivos en la imagen de Docker, montar un volumen o configurar un script de inicio para descargarlos. El resultado típico es una imagen de Dockerque es varios cientos de megabytes más grande de lo necesario, un elemento de la lista de verificación de implementación que se omite y fallos en producción al reiniciar contenedores limpios donde el volumen no está montado.IronOCR incluye soporte para inglés en el propio paquete; Los idiomas adicionales se instalan como paquetes NuGet que forman parte del resultado de la compilación. El contenedor obtiene lo que necesita del paso de restauración y no hay rutas que configurar. La guía de implementación de Docker y la guía de implementación de Linux cubren la configuración específica para cada entorno de destino.

Equipos de desarrollo sin experiencia en digitalización de documentos

La superficie de GdPicture es grande por necesidad, ya que abarca una plataforma completa de procesamiento de imágenes de documentos. Para un desarrollador que se incorpora a un equipo para mantener un microservicio de OCR, comprender el componente de procesamiento de imágenes, el componente de OCR, el componente de PDF, el ciclo de vida del ID entero, el manejo del código de retorno de estado y la configuración de la carpeta de recursos supone una importante inversión inicial. La interfaz de IronOCR para el reconocimiento óptico de caracteres (OCR) se compone de tres clases: el motor, el contenedor de entrada y el objeto de resultado. Ese es el modelo mental completo para el 90% de los casos de uso. La incorporación de un nuevo desarrollador implica orientarlo sobre la configuración de IronTesseract en lugar de sobre una guía del SDK con múltiples módulos.

Reemplazo de la inicialización de componentes

GdPicture requiere una secuencia de inicialización de cuatro pasos: registrar la clave de licencia a través de LicenseManager, inicializar GdPictureImaging, inicializar GdPictureOCR, y establecer la ruta de la carpeta de recursos.IronOCR reduce esto a una sola asignación de propiedad que pertenece a Program.cs o Startup.cs:

// Remove
LicenseManager lm = new LicenseManager();
lm.RegisterKEY("GDPICTURE-LICENSE-KEY");
_imaging = new GdPictureImaging();
_ocr = new GdPictureOCR();
_ocr.ResourceFolder = @"C:\GdPicture\Resources\OCR";

// Replace with
IronOcr.License.LicenseKey = "IRONOCR-LICENSE-KEY";
// IronTesseract instances are instantiated per-use or as a singleton

// Remove
LicenseManager lm = new LicenseManager();
lm.RegisterKEY("GDPICTURE-LICENSE-KEY");
_imaging = new GdPictureImaging();
_ocr = new GdPictureOCR();
_ocr.ResourceFolder = @"C:\GdPicture\Resources\OCR";

// Replace with
IronOcr.License.LicenseKey = "IRONOCR-LICENSE-KEY";
// IronTesseract instances are instantiated per-use or as a singleton

' Remove
Dim lm As New LicenseManager()
lm.RegisterKEY("GDPICTURE-LICENSE-KEY")
_imaging = New GdPictureImaging()
_ocr = New GdPictureOCR()
_ocr.ResourceFolder = "C:\GdPicture\Resources\OCR"

' Replace with
IronOcr.License.LicenseKey = "IRONOCR-LICENSE-KEY"
' IronTesseract instances are instantiated per-use or as a singleton

Eliminación del seguimiento mediante ID de imagen

Cada llamada CreateGdPictureImageFromFile y cada llamada RenderPageToGdPictureImage tiene una llamada ReleaseGdPictureImage correspondiente en algún lugar de la base de código existente. Esas llamadas de limpieza se eliminan por completo en IronOCR— OcrInput maneja la limpieza. La migración es mecánica: encuentra cada int imageId = ..., encuentra su ReleaseGdPictureImage(imageId) emparejada, envuelve el código de carga en using var input = new OcrInput(), y reemplaza las llamadas de método de GdPicture con sus equivalentes en IronOCR.

// Remove
int imageId = _imaging.CreateGdPictureImageFromFile(path);
if (imageId == 0) throw new Exception(_imaging.GetStat().ToString());
_ocr.SetImage(imageId);
_ocr.Language = "eng";
string resultId = _ocr.RunOCR();
if (string.IsNullOrEmpty(resultId)) throw new Exception(_ocr.GetStat().ToString());
string text = _ocr.GetOCRResultText(resultId);
_imaging.ReleaseGdPictureImage(imageId);

// Replace with
using var input = new OcrInput();
input.LoadImage(path);
var result = new IronTesseract().Read(input);
string text = result.Text;

// Remove
int imageId = _imaging.CreateGdPictureImageFromFile(path);
if (imageId == 0) throw new Exception(_imaging.GetStat().ToString());
_ocr.SetImage(imageId);
_ocr.Language = "eng";
string resultId = _ocr.RunOCR();
if (string.IsNullOrEmpty(resultId)) throw new Exception(_ocr.GetStat().ToString());
string text = _ocr.GetOCRResultText(resultId);
_imaging.ReleaseGdPictureImage(imageId);

// Replace with
using var input = new OcrInput();
input.LoadImage(path);
var result = new IronTesseract().Read(input);
string text = result.Text;

Imports System

' Remove
Dim imageId As Integer = _imaging.CreateGdPictureImageFromFile(path)
If imageId = 0 Then Throw New Exception(_imaging.GetStat().ToString())
_ocr.SetImage(imageId)
_ocr.Language = "eng"
Dim resultId As String = _ocr.RunOCR()
If String.IsNullOrEmpty(resultId) Then Throw New Exception(_ocr.GetStat().ToString())
Dim text As String = _ocr.GetOCRResultText(resultId)
_imaging.ReleaseGdPictureImage(imageId)

' Replace with
Using input As New OcrInput()
    input.LoadImage(path)
    Dim result = New IronTesseract().Read(input)
    Dim text As String = result.Text
End Using

Adaptación del manejo de errores

GdPicture utiliza códigos de retorno GdPictureStatus verificados después de cada operación significativa.IronOCR genera excepciones estándar de .NET . La migración reemplaza guardias if (status != GdPictureStatus.OK) con bloques try/catch que manejan IronOcr.Exceptions.OcrException para fallos específicos de OCR y estándares IOException y FileNotFoundException para fallos de entrada. El tutorial sobre lectura de texto a partir de imágenes abarca patrones de manejo de errores para escenarios comunes.

Implementación del paquete de idioma

Los archivos de idioma de GdPicture son archivos .traineddata en una carpeta de sistema de archivos. Los paquetes de idioma de IronOCR son paquetes NuGet . La migración elimina la carpeta de recursos del manifiesto de implementación y agrega referencias de paquetes NuGet para cada idioma requerido:

# Remove filesystem dependency for each language
# Add NuGet package instead
dotnet add package IronOcr.Languages.French
dotnet add package IronOcr.Languages.German
dotnet add package IronOcr.Languages.ChineseSimplified

# Remove filesystem dependency for each language
# Add NuGet package instead
dotnet add package IronOcr.Languages.French
dotnet add package IronOcr.Languages.German
dotnet add package IronOcr.Languages.ChineseSimplified

La guía de múltiples idiomas cubre la configuración para documentos multilingües donde se especifican tanto los idiomas primarios como secundarios en la instancia IronTesseract.