IronOCR vs AWS Textract: soluções de OCR para startups

Ciclo de vida do ID da imagem

A característica arquitetônica que define o GdPicture é o gerenciamento de IDs de imagem inteiros. Carregar qualquer imagem aloca memória dentro do tempo de execução do GdPicture e retorna um identificador int. Você usa esse número inteiro para referenciar a imagem em todas as chamadas subsequentes. Quando você termina, chama ReleaseGdPictureImage com esse inteiro. Caso contrário, a memória não será liberada até que o processo termine.

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

Ao processar PDFs com várias páginas, cada página renderizada gera um ID de imagem separado. Um documento de 100 páginas com resolução de 200 DPI pode alocar de 1 a 5 GB de memória se a limpeza for negligenciada. O padrão correto requer coletar todos os IDs e liberá-los em um bloco finally — mas essa disciplina é inteiramente responsabilidade do desenvolvedor.

Comparação Detalhada de Recursos

Abordagem GdPicture

Cada imagem em GdPicture existe como um identificador inteiro em um pool gerenciado em tempo de execução. Você adquire o identificador carregando uma imagem, passa esse número inteiro para o OCR e outras operações e, em seguida, o libera quando terminar. O padrão é explícito e correto quando seguido. O problema é que é fácil errar, e a consequência é um crescimento ilimitado da memória.

O fluxo de trabalho de OCR em PDF demonstra o risco de forma mais clara. Cada chamada para pdf.RenderPageToGdPictureImage() aloca uma nova imagem raster na memória e retorna um novo ID inteiro. Um documento de 100 páginas gera 100 alocações separadas. Falta uma chamada ReleaseGdPictureImage e o processo acumula memória vazada:

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

O processamento em lote de vários PDFs agrava isso. A documentação para cada loop for deve conter uma nota lembrando aos mantenedores para coletar IDs em um List<int> e liberá-los todos em finally. Isso é trabalho de infraestrutura, não trabalho de OCR.

Abordagem IronOCR

OcrInput é um IDisposable padrão. Uma declaração using garante a limpeza, quer o método retorne normalmente ou lance uma exceção. Não há IDs inteiros para rastrear, nenhum componente de imagem separado para inicializar e nenhuma etapa externa de renderização DPI para 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 PDFs protegidos por senha, o parâmetro é um argumento nomeado em vez de uma sobrecarga separada que requer verificação de status 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

O guia de entrada de PDF do IronOCR aborda opções adicionais, incluindo a seleção de intervalo de páginas. Para equipes já familiarizadas com padrões IDisposable no Entity Framework, HttpClient e manuseio de streams, OcrInput não exige um novo modelo mental.

Abordagem GdPicture

O fluxo de trabalho completo para um PDF digitalizado de baixa qualidade — carregar, pré-processar, realizar OCR em cada página e liberar — abrange três classes de componentes e requer uma verificação cuidadosa do status em cada etapa:

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",  // Pasta 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",  // Pasta 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",  ' Pasta 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

O caminho ResourceFolder não é opcional. Deve resolver para um diretório contendo arquivos de idioma .traineddata em tempo de execução. Esse caminho funciona na máquina de desenvolvimento, mas falha na produção quando a conta de serviço não consegue ver C:\GdPicture\Resources\OCR, ou quando o aplicativo é implantado no Linux, ou quando as imagensDockernão incluem essa estrutura de diretório. Depurar essas falhas frequentemente significa perseguir códigos genéricos de erro GdPictureStatus que dizem pouco sobre a causa raiz.

Abordagem IronOCR

O fluxo de trabalho equivalente no IronOCR— incluindo o pré-processamento para correção de distorção e remoção de ruído — consiste em cinco linhas:

using IronOcr;

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

    using var input = new OcrInput();
    input.LoadPdf(inputPdf);
    input.Deskew();   // Não 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();   // Não 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()   ' Não separate plugin required
        input.DeNoise()

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

O suporte ao idioma inglês está incorporado no pacote NuGet . Idiomas adicionais são instalados como pacotes NuGet (IronOcr.Languages.French) em vez de arquivos .traineddata em um caminho de sistema de arquivos. O guia de correção de qualidade de imagem e o guia de correção de orientação de imagem cobrem todo o conjunto de opções de pré-processamento disponíveis em OcrInput.

Para processamento com reconhecimento de confiança — filtrando resultados abaixo de um limite antes de gravar em um banco de dados, por exemplo — o objeto de resultado expõe a confiança diretamente:

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)

O GdPicture requer três loops aninhados — blocos, linhas, palavras — para alcançar os mesmos dados, com chamadas de método baseadas em índice em cada nível (GetOCRResultBlockLineWordConfidence(resultId, b, l, w)). O guia prático de pontuação de confiança demonstra o modelo de acesso estruturado para casos de uso comuns.

Abordagem GdPicture

O GdPicture retorna uma string resultId de RunOCR(), e todos os dados de resultados são consultados através desse ID por meio de chamadas de método na instância GdPictureOCR. Para atingir a confiança por palavra, é necessário iterar por três níveis aninhados:

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

Isso não está errado — os dados são acessíveis. Mas isso exige compreender e manter um índice tridimensional da estrutura de resultados para cada projeto que necessite de dados em nível de palavra.

Abordagem IronOCR

OcrResult expõe .Words como uma coleção tipada. LINQ atua diretamente contra isso:

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

O OCR baseado em região — que extrai texto de um retângulo definido em um documento — é igualmente direto:

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

O guia de resultados de leitura e o guia de OCR baseado em região mostram como esses padrões se estendem a documentos com várias páginas e fluxos de trabalho de extração de campos estruturados.

OCR é o único requisito.

As equipes que implementam fluxos de trabalho de ingestão de documentos — como a entrada de faturas digitalizadas, o processamento de formulários médicos e a extração de texto de contratos — costumam avaliar o GdPicture porque ele aparece em diretórios de software Enterprise ao lado do LEADTOOLS e do Kofax. Assim que a tabela de dependências do plugin ficar clara, o cenário muda. O plugin PDF não é opcional se a entrada de PDF for necessária. O plugin Document Imaging não é opcional se o pré-processamento for necessário. Uma equipe que precisa de OCR a partir de PDFs digitalizados com correção de deskew acaba com três licenças de plugin a um custo significativo de entrada no Professional. Quando o requisito é a extração de texto e nada na lista de recursos do GdPicture além disso é necessário, esse preço representa um ônus puro.IronOCR em $2,999 Professional cobre o fluxo de trabalho idêntico — entrada de imagem, entrada de PDF, pré-processamento, saída de PDF pesquisável — de um único pacote, sem decisões de plugins a serem feitas.

Incidentes de vazamento de memória em produção

O ciclo de vida de IDs inteiros se torna um incidente de produção prestes a acontecer em serviços de processamento de documentos de alto volume. Um endpoint de API web que processa PDFs carregados sob carga eventualmente terá um trecho de código onde a chamada de liberação da imagem não será alcançada — um retorno prematuro em um ramo de erro, uma exceção não tratada antes do bloco de limpeza, ou simplesmente um novo desenvolvedor não familiarizado com o padrão adicionando um método auxiliar que recebe um identificador de imagem inteiro como parâmetro e se esquece de liberá-lo. A memória aumenta, o serviço fica mais lento e a causa raiz não é óbvia em um despejo de memória. Equipes que depuraram um desses incidentes geralmente desejam um modelo em que o ambiente de execução lide com a limpeza. O padrão de descarte padrão no IronOCR é esse modelo — limpeza estruturada imposta pelo compilador em vez de pela disciplina do desenvolvedor em cada ponto de chamada.

Atrito na atualização da versão

O GdPicture incorpora o número da versão principal em seu espaço de nomes. A atualização da versão 14 para a versão 15 exige a atualização dessa diretiva de namespace em todos os arquivos de origem que fazem referência às classes GdPicture. Em uma aplicação de grande porte com OCR, manipulação de PDF e processamento de imagens distribuídos por dezenas de serviços e classes de utilitários, essa é uma tarefa de migração complexa — e não oferece nenhum benefício funcional. Todas as bibliotecas .NET modernas, desde Microsoft.EntityFrameworkCore até Newtonsoft.Json, usam namespaces independentes de versão, gerenciando o versionamento por meio do número da versão do pacote NuGet . O IronOCR segue essa convenção: a mesma importação de namespace se aplica da versão 1 até a versão atual.

Implantação de microsserviços e contêineres

O GdPicture OCR requer que uma pasta de recursos externa contendo arquivos de dados de idioma esteja presente em um caminho específico em tempo de execução. Em uma implantação em contêiner, isso significa incorporar esses arquivos à imagem do Docker, montar um volume ou configurar um script de inicialização para baixá-los. O resultado típico é uma imagemDockercom várias centenas de megabytes a mais do que o necessário, um item da lista de verificação de implantação que é esquecido e falhas em produção em reinicializações limpas de contêineres, onde o volume não está montado. O IronOCR inclui suporte para inglês no próprio pacote; Idiomas adicionais são instalados como pacotes NuGet que fazem parte do resultado da compilação. O contêiner obtém o que precisa na etapa de restauração e não há caminhos a serem configurados. O guia de implantação do Docker e o guia de implantação do Linux abordam a configuração específica para cada ambiente de destino.

Equipes de desenvolvimento sem experiência em digitalização de documentos

A área de superfície do GdPicture é grande por necessidade — ela abrange uma plataforma completa de digitalização de documentos. Para um desenvolvedor que entra em uma equipe para manter um microsserviço de OCR, entender o componente de imagem, o componente de OCR, o componente de PDF, o ciclo de vida do ID inteiro, o tratamento do código de retorno de status e a configuração da pasta de recursos representa um investimento inicial considerável. A interface do IronOCR para OCR é composta por três classes: o mecanismo, o contêiner de entrada e o objeto de resultado. Esse é o modelo mental completo para 90% dos casos de uso. Integrar um novo desenvolvedor significa direcioná-lo para a configuração do IronTesseract em vez de para um guia de SDK com vários módulos.

Substituindo a inicialização do componente

GdPicture requer uma sequência de inicialização em quatro etapas: registre a chave de licença por meio de LicenseManager, inicialize GdPictureImaging, inicialize GdPictureOCR e configure o caminho da pasta de recursos.IronOCR reduz isso a uma única atribuição de propriedade que pertence a Program.cs ou 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

Eliminação do rastreamento de ID de imagem

Cada chamada CreateGdPictureImageFromFile e cada chamada RenderPageToGdPictureImage tem uma chamada correspondente ReleaseGdPictureImage em algum lugar na base de código existente. Essas chamadas de limpeza são removidas inteiramente no IronOCR— OcrInput lida com a eliminação. A migração é mecânica: encontre cada int imageId = ..., encontre seu par ReleaseGdPictureImage(imageId), envolva o código de carregamento em using var input = new OcrInput() e substitua as chamadas de método do GdPicture por seus equivalentes em 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

Adaptando o tratamento de erros

GdPicture usa códigos de retorno GdPictureStatus verificados após cada operação significativa. O IronOCR gera exceções padrão do .NET . A migração substitui as proteções if (status != GdPictureStatus.OK) por blocos try/catch que lidam com IronOcr.Exceptions.OcrException para falhas específicas de OCR e padrão IOException e FileNotFoundException para falhas de entrada. O tutorial sobre leitura de texto em imagens aborda padrões de tratamento de erros para cenários comuns.

Implantação do pacote de idiomas

Os arquivos de idioma do GdPicture são arquivos .traineddata em uma pasta de sistema de arquivos. Os pacotes de idiomas do IronOCR são pacotes NuGet . A migração remove a pasta de recursos do manifesto de implantação e adiciona referências de pacotes NuGet para cada idioma necessário:

# 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

O guia de múltiplos idiomas cobre a configuração para documentos multilíngues onde os idiomas primário e secundário são especificados na instância IronTesseract.