IronOCR vs AWS Texttract : solutions OCR pour les startups

Le cycle de vie de l'identifiant d'image

La caractéristique architecturale déterminante de GdPicture est la gestion des identifiants d'image entiers. Charger toute image alloue de la mémoire à l'intérieur du runtime GdPicture et retourne un handle int. Vous utilisez cet entier pour faire référence à l'image dans tous les appels suivants. Quand vous avez terminé, vous appelez ReleaseGdPictureImage avec cet entier. Sinon, la mémoire ne sera libérée qu'à la fin du processus.

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

Lors du traitement de fichiers PDF multipages, chaque page rendue génère un identifiant d'image distinct. Un document de 100 pages à 200 DPI peut allouer de 1 à 5 Go de mémoire si le nettoyage est omis. Le modèle correct nécessite de collecter tous les ID et de les libérer dans un bloc finally — mais cette discipline est entièrement la responsabilité du développeur.

Comparaison détaillée des fonctionnalités

Approche GdPicture

Dans GdPicture, chaque image existe sous la forme d'un descripteur entier dans un pool géré à l'exécution. Vous obtenez le descripteur en chargeant une image, vous transmettez cet entier à l'OCR et à d'autres opérations, puis vous le libérez une fois terminé. Le modèle est explicite et correct lorsqu'il est suivi. Le problème, c'est qu'il est facile de se tromper, et la conséquence est une croissance illimitée de la mémoire.

Le flux de travail OCR des PDF illustre le risque le plus clairement. Chaque appel à pdf.RenderPageToGdPictureImage() alloue une nouvelle image raster en mémoire et retourne un nouvel ID entier. Un document de 100 pages crée 100 affectations distinctes. Manquer un appel ReleaseGdPictureImage et le processus accumule une mémoire fuitée :

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

Le traitement par lots de plusieurs fichiers PDF aggrave ce problème. La documentation pour chaque boucle for doit inclure une note rappelant aux mainteneurs de collecter les ID dans un List<int> et de les libérer tous dans finally. Il s'agit de travaux d'infrastructure, et non de travail de reconnaissance optique de caractères.

Approche d'IronOCR

OcrInput est un IDisposable standard. Une déclaration using garantit le nettoyage que la méthode retourne normalement ou lance. Il n'y a pas d'identifiants numériques à suivre, pas de composant d'imagerie séparé à initialiser et pas d'étape de rendu DPI externe pour les pages 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

Pour les fichiers PDF protégés par mot de passe, le paramètre est un argument nommé plutôt qu'une surcharge distincte nécessitant une vérification d'état supplémentaire :

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

Le guide d'entrée PDF IronOCR propose des options supplémentaires, notamment la sélection de la plage de pages. Pour les équipes déjà familières avec les modèles IDisposable à travers Entity Framework, HttpClient, et la gestion des flux, OcrInput ne nécessite pas de nouveau modèle mental.

Approche GdPicture

Le flux de travail complet pour un PDF numérisé de faible qualité — chargement, prétraitement, OCR de chaque page, publication — s'étend sur trois classes de composants et nécessite une vérification minutieuse de l'état à chaque étape :

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",  // dossier de ressources externes 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",  // dossier de ressources externes 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",  ' dossier de ressources externes 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

Le chemin ResourceFolder n'est pas optionnel. Il doit se résoudre à un répertoire contenant des fichiers de langue .traineddata à l'exécution. Ce chemin fonctionne sur la machine de développement, puis échoue en production lorsque le compte de service ne peut pas voir C:\GdPicture\Resources\OCR, ou lorsque l'application est déployée sur Linux, ou lorsque les images Dockern'incluent pas cette structure de répertoire. Déboguer ces échecs signifie souvent poursuivre des codes d'erreur génériques GdPictureStatus qui en disent peu sur la cause racine.

Approche d'IronOCR

Le flux de travail équivalent dans IronOCR — y compris le prétraitement pour la correction de la distorsion et la suppression du bruit — est de cinq lignes :

using IronOcr;

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

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

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

La prise en charge de la langue anglaise est intégrée au package NuGet . Des langues additionnelles s'installent en tant que packages NuGet (IronOcr.Languages.French) plutôt que des fichiers .traineddata dans un chemin de système de fichiers. Le guide de correction de la qualité d'image et le guide de correction d'orientation d'image couvrent l'ensemble des options de prétraitement disponibles sur OcrInput.

Pour le traitement prenant en compte la confiance (par exemple, le filtrage des résultats inférieurs à un seuil avant leur écriture dans une base de données), l'objet résultat expose directement le niveau de confiance :

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 nécessite trois boucles imbriquées — blocs, lignes, mots — pour atteindre les mêmes données, avec des appels de méthode basés sur des indices à chaque niveau (GetOCRResultBlockLineWordConfidence(resultId, b, l, w)). Le guide pratique sur les scores de confiance illustre le modèle d'accès structuré pour les cas d'utilisation courants.

Approche GdPicture

GdPicture retourne une chaîne resultId de RunOCR(), et toutes les données de résultat sont interrogées via cet ID à travers des appels de méthode sur l'instance GdPictureOCR. Pour atteindre un niveau de confiance par mot, il faut itérer à travers trois niveaux imbriqués :

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

Ce n'est pas faux — les données sont accessibles. Mais cela nécessite de comprendre et de maintenir un index tridimensionnel de la structure des résultats pour chaque projet nécessitant des données au niveau du mot.

Approche d'IronOCR

OcrResult expose .Words comme une collection typée. LINQ s'y oppose directement :

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

La reconnaissance optique de caractères (OCR) basée sur les régions — qui consiste à extraire du texte à partir d'un rectangle défini d'un document — est tout aussi directe :

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

Le guide des résultats de lecture et le guide OCR basé sur les régions montrent comment ces modèles s'étendent aux documents de plusieurs pages et aux flux de travail d'extraction de champs structurés.

La reconnaissance optique de caractères (OCR) est la seule exigence.

Les équipes qui mettent en œuvre des pipelines d'ingestion de documents (importation de factures numérisées, traitement de formulaires médicaux, extraction du texte des contrats) évaluent souvent GdPicture car il apparaît dans les répertoires de logiciels Enterprise aux côtés de LEADTOOLS et Kofax. Une fois que le tableau des dépendances des plugins est clair, la situation change. Le plugin PDF n'est pas optionnel si l'entrée PDF est requise. Le plugin Document Imaging n'est pas optionnel si un prétraitement est nécessaire. Une équipe qui a besoin d'OCR de PDF numérisés avec correction de redressement finit par obtenir trois licences de plugins à un coût d'entrée Professional significatif. Quand le besoin est d'extraire du texte et que rien dans la liste des fonctionnalités GdPicture au-delà de cela n'est nécessaire, ce prix représente du pur surcoût. IronOCR à $2,999 Professional couvre le même flux de travail — entrée d'image, entrée de PDF, prétraitement, sortie PDF interrogeable — depuis un seul package sans décisions de plugin à prendre.

Incidents de fuite de mémoire en production

Le cycle de vie des identifiants entiers devient un incident de production potentiel dans les services de traitement de documents à haut débit. Un point de terminaison d'API Web qui traite des PDF téléchargés sous charge finira par avoir un chemin de code où l'appel de libération de l'image n'est pas atteint : un retour prématuré dans une branche d'erreur, une exception non gérée avant le bloc de nettoyage, ou tout simplement un nouveau développeur non familiarisé avec le modèle ajoutant une méthode d'assistance qui prend un handle d'image entier comme paramètre et oublie de le libérer. La mémoire sature, le service ralentit et la cause première reste obscure dans un vidage de mémoire. Les équipes ayant déjà débogué ce type d'incident privilégient généralement un modèle où le nettoyage est géré par l'environnement d'exécution. Le modèle de nettoyage standard d' IronOCR correspond à cette approche : un nettoyage structuré, imposé par le compilateur plutôt que par les développeurs à chaque appel de mémoire.

Mise à niveau de la version Friction

GdPicture intègre le numéro de version majeure dans son espace de noms. La mise à niveau de la version 14 à la version 15 nécessite la mise à jour de cette directive d'espace de noms dans chaque fichier source qui référence les classes GdPicture. Dans une application de grande envergure comportant des fonctions de reconnaissance optique de caractères (OCR), de gestion de fichiers PDF et de traitement d'images réparties sur des dizaines de services et de classes utilitaires, il s'agit d'une tâche de migration complexe, sans aucun avantage fonctionnel. Toutes les bibliothèques .NET modernes, de Microsoft.EntityFrameworkCore à Newtonsoft.Json, utilisent des espaces de noms indépendants de la version, gérant le versionnage via le numéro de version du package NuGet . IronOCR suit cette convention : la même importation d'espace de noms s'applique de la version 1 à la version actuelle.

Déploiement de microservices et de conteneurs

GdPicture OCR requiert, lors de son exécution, la présence d'un dossier de ressources externe contenant les fichiers de données linguistiques à un emplacement précis. Dans un déploiement conteneurisé, cela implique soit d'intégrer ces fichiers à l'image Docker, soit de monter un volume, soit de configurer un script de démarrage pour les télécharger. Le résultat typique est une image Dockerde plusieurs centaines de mégaoctets plus volumineuse que nécessaire, un élément de la liste de contrôle de déploiement qui est oublié et des échecs de production lors de redémarrages de conteneurs propres lorsque le volume n'est pas monté. IronOCR intègre la prise en charge de l'anglais dans le package lui-même ; Les langues supplémentaires s'installent sous forme de packages NuGet qui font partie du résultat de la compilation. Le conteneur récupère ce dont il a besoin lors de l'étape de restauration, et il n'y a aucun chemin à configurer. Le guide de déploiement Docker et le guide de déploiement Linux couvrent la configuration spécifique de chaque environnement cible.

Équipes de développement sans expertise en imagerie documentaire

La surface de GdPicture est importante par nécessité — elle couvre une plateforme complète d'imagerie documentaire. Pour un développeur rejoignant une équipe chargée de la maintenance d'un microservice OCR, la compréhension du composant d'imagerie, du composant OCR, du composant PDF, du cycle de vie de l'identifiant entier, de la gestion des codes de retour d'état et de la configuration du dossier de ressources représente un investissement initial important. La surface d'interaction d'IronOCR pour la reconnaissance optique de caractères (OCR) est composée de trois classes : le moteur, le conteneur d'entrée et l'objet de résultat. Voilà le modèle mental complet pour 90 % des cas d'utilisation. L'intégration d'un nouveau développeur implique de le diriger vers la configuration d'IronTesseract plutôt que vers un guide SDK multi-modules.

Remplacement de l'initialisation du composant

GdPicture nécessite une séquence d'initialisation en quatre étapes : enregistrer la clé de licence via LicenseManager, initialiser GdPictureImaging, initialiser GdPictureOCR, et définir le chemin du dossier de ressources. IronOCR réduit cela à une seule attribution de propriété qui appartient à 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

Suppression du suivi des identifiants d'image

Chaque appel à CreateGdPictureImageFromFile et chaque appel à RenderPageToGdPictureImage a un appel ReleaseGdPictureImage correspondant quelque part dans la base de code existante. Ces appels de nettoyage sont entièrement supprimés dans IronOCR — OcrInput gère la disposition. La migration est mécanique : trouvez chaque int imageId = ..., trouvez son pair ReleaseGdPictureImage(imageId), encapsulez le code de chargement dans using var input = new OcrInput(), et remplacez les appels de méthode GdPicture par leurs équivalents 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

Adaptation de la gestion des erreurs

GdPicture utilise des codes de retour GdPictureStatus vérifiés après chaque opération significative. IronOCR génère des exceptions .NET standard. La migration remplace les gardes if (status != GdPictureStatus.OK) par des blocs try/catch qui gèrent IronOcr.Exceptions.OcrException pour les échecs spécifiques à l'OCR et les IOException et FileNotFoundException standards pour les échecs d'entrée. Le tutoriel sur la lecture de texte à partir d'images aborde les modèles de gestion des erreurs pour les scénarios courants.

Déploiement du module linguistique

Les fichiers de langue GdPicture sont des fichiers .traineddata dans un dossier de système de fichiers. Les packs de langue IronOCR sont des packages NuGet . La migration supprime le dossier de ressources du manifeste de déploiement et ajoute des références aux packages NuGet pour chaque langage requis :

# 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

Le guide de langues multiples couvre la configuration pour les documents multilingues où les langues primaire et secondaire sont spécifiées sur l'instance IronTesseract.