OCR C# GitHub: Reconnaissance de texte avec IronOCR

Quelle méthode d'installation devez-vous utiliser ?

Commencez par installer IronOCR via le Package Manager NuGet :

Install-Package IronOcr

Installer avec NuGet

PM >  Install-Package IronOcr

Consultez IronOCR sur NuGet pour une installation rapide. Avec plus de 10 millions de téléchargements, il transforme le développement PDF avec C#. Vous pouvez également télécharger le DLL ou l'installateur Windows.

Pour les scénarios d'installation avancés, consultez le guide des packages NuGet . Si vous déployez votre application sur des plateformes spécifiques, consultez les guides pour Windows , Linux , macOS ou les conteneurs Docker.

Où trouver des exemples de code ?

IronOCR maintient des dépôts GitHub officiels contenant des exemples et des tutoriels. Le dépôt d'exemples IronOCR fournit des implémentations concrètes, tandis que le dépôt de tutoriels Image to Text présente des cas d'utilisation pratiques que vous pouvez cloner et modifier.

Ces référentiels présentent des fonctionnalités de reconnaissance optique de caractères (OCR) avec lecture de codes-barres, prise en charge multilingue et traitement des fichiers PDF. Comme IronOCR publie régulièrement des packages sur NuGet , vous aurez toujours accès aux dernières versions stables.

Quelle structure de projet devez-vous utiliser ?

MyOcrProject/
├── src/
│   └── OcrProcessor.cs
├── images/
│   └── sample-invoice.jpg
├── .gitignore
├── README.md
└── MyOcrProject.csproj

Cette structure prend en charge différents formats d'entrée, notamment JPG, PNG, TIFF et BMP. Pour le traitement des fichiers TIFF ou GIF multipages, IronOCR les gère automatiquement.

Le dossier images/ permet de garder les fichiers d'exemple organisés et facilite l'ajout d'images de test par les contributeurs sans encombrer la racine. Le fait de séparer le dossier src/ des fichiers de configuration rend le projet plus facile à lire en un coup d'œil. Ajoutez un README.md qui explique ce que fait le projet, quelle variable de clé de licence définir et comment exécuter l'exemple.

Comment implémenter le code de traitement OCR ?

L'exemple suivant présente un processeur OCR complet qui illustre les principales fonctionnalités d'IronOCR, notamment le prétraitement d'images, l'extraction de texte et la détection de codes-barres :

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;
ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.Auto;
ocr.Language = OcrLanguage.English;

using var input = new OcrInput();
input.LoadImage("images/sample-invoice.jpg");
input.Deskew();
input.DeNoise();
input.EnhanceResolution(225);

var result = ocr.Read(input);

Console.WriteLine($"Confidence: {result.Confidence}%");
Console.WriteLine($"Text Found:\n{result.Text}");

foreach (var barcode in result.Barcodes)
{
    Console.WriteLine($"Barcode: {barcode.Value} ({barcode.Format})");
}

result.SaveAsSearchablePdf("output.pdf");

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;
ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.Auto;
ocr.Language = OcrLanguage.English;

using var input = new OcrInput();
input.LoadImage("images/sample-invoice.jpg");
input.Deskew();
input.DeNoise();
input.EnhanceResolution(225);

var result = ocr.Read(input);

Console.WriteLine($"Confidence: {result.Confidence}%");
Console.WriteLine($"Text Found:\n{result.Text}");

foreach (var barcode in result.Barcodes)
{
    Console.WriteLine($"Barcode: {barcode.Value} ({barcode.Format})");
}

result.SaveAsSearchablePdf("output.pdf");

Cet exemple illustre plusieurs fonctionnalités IronOCR . Le constructeur configure le moteur OCR avec la lecture des codes-barres activée et la segmentation automatique des pages. Le pipeline de prétraitement illustre le redressement (correction de la rotation), le débruitage (suppression des artefacts) et l'amélioration de la résolution.

Après traitement, le moteur extrait le texte anglais avec des scores de confiance, identifie les codes-barres et génère un PDF consultable. Le code est écrit en utilisant des instructions de haut niveau for .NET 10, ce qui permet de conserver un exemple court et lisible.

Pour les scénarios avancés, vous pouvez utiliser le traitement asynchrone pour un meilleur débit, ou implémenter un suivi de la progression pour les opérations de longue durée. La classe OcrResult fournit une sortie détaillée comprenant les positions du texte, les coordonnées des mots et la structure des paragraphes, vous offrant bien plus qu'une simple chaîne de texte.

Les développeurs peuvent également configurer IronOCR pour lire d'autres langues, comme le chinois, l'espagnol ou le français, ce qui en fait un choix judicieux pour les projets GitHub multilingues. Pour plus d'informations sur l'installation de modules linguistiques supplémentaires, consultez le guide des 125 langues internationales .

Que devez-vous inclure dans votre fichier .gitignore ?

Dans votre fichier .gitignore, incluez des entrées empêchant l'inclusion des artefacts d'exécution, des résultats de tests et des configurations secrètes :

# IronOCR runtime files
runtimes/
# Test images and outputs
*.pdf
test-images/
output/
# License keys
appsettings.*.json

Il est particulièrement important de ne pas inclure le dossier runtimes/ dans le système de contrôle de version, car IronOCR télécharge des binaires spécifiques à chaque plateforme lors de la compilation. Leur inclusion dans le système de contrôle de version alourdirait considérablement votre dépôt et engendrerait des conflits entre plateformes. Apprenez-en davantage sur la gestion des clés de licence pour une mise en œuvre correcte.

Qu'est-ce qui différencie IronOCR des autres solutions OCR ?

IronOCR est suffisamment flexible pour reconnaître des mots individuels, des lignes et des paragraphes entiers, vous offrant un contrôle précis sur la quantité de détails extraits de chaque analyse. La bibliothèque excelle dans le traitement de types de documents spécialisés, notamment les plaques d'immatriculation, les passeports, les textes manuscrits, les captures d'écran et les documents numérisés.

La licence commerciale offre une clarté légale pour les dépôts publics. Vous êtes explicitement autorisé à inclure IronOCR dans des applications commerciales. Les filtres de prétraitement d'image intégrés comprennent des options avancées telles que la correction des couleurs, l'amélioration de la qualité et un assistant de filtre qui trouve automatiquement les paramètres optimaux pour les images difficiles.

Pourquoi l'architecture à DLL unique est-elle importante ?

L'architecture à un seul DLL d'IronOCR signifie que les contributeurs peuvent cloner votre dépôt et commencer à développer immédiatement, sans lutter contre les dépendances natives ou les configurations spécifiques à une plateforme qui affectent d'autres solutions OCR. C'est cette simplicité qui explique pourquoi les développeurs choisissent IronOCR plutôt que Tesseract brut .

En termes d'expérience d'installation, une implémentation Tesseract brute nécessite généralement l'installation séparée des binaires natifs, la configuration des variables PATH et la gestion manuelle des fichiers de langue tessdata. IronOCR gère tout cela en interne, ce qui signifie que le fichier README de votre projet peut rester concentré sur la logique de votre application plutôt que sur les instructions de configuration de l'environnement.

La bibliothèque inclut Tesseract 5 avec de nombreuses améliorations de performances et une prise en charge du multithreading qui vous permet de traiter plusieurs documents en parallèle sans écrire de code de threading personnalisé.

Comment gérer les fichiers volumineux avec Git ?

Utilisez Git LFS pour les images de test volumineuses afin de limiter la taille de votre dépôt :

git lfs track "*.jpg" "*.png" "*.tiff"
git add .gitattributes
git commit -m "Track large image files with Git LFS"

git lfs track "*.jpg" "*.png" "*.tiff"
git add .gitattributes
git commit -m "Track large image files with Git LFS"

Ceci est particulièrement important lors de la manipulation d'images haute résolution ou de fichiers TIFF multipages. Pour les numérisations de faible qualité, le prétraitement d'IronOCR peut améliorer considérablement les résultats sans vous obliger à modifier manuellement les images de test avant de les valider.

Lors du stockage de documents de test dans votre référentiel, tenez compte du fait qu'ils ne contiennent pas d'informations sensibles. Il est préférable de générer par programmation des images de test synthétiques plutôt que de conserver de véritables factures ou documents d'identité, même dans des référentiels privés.

Comment gérer les clés de licence et la documentation ?

Stockez les clés de licence IronOCR à l'aide de variables d'environnement ou de secrets utilisateur .NET . Ne les intégrez jamais directement à une branche, même privée. Suivez le guide des clés de licence pour une mise en œuvre correcte. Vous pouvez également configurer les licences dans le fichier web.config pour les applications ASP.NET .

Indiquez dans votre fichier README les formats d'image pris en charge et les niveaux de précision attendus. Incluez des exemples d'images dans un dossier test-data/ afin que les contributeurs puissent vérifier la fonctionnalité OCR immédiatement après le clonage. Ajoutez une courte section expliquant comment définir la clé de licence via une variable d'environnement afin que les nouveaux contributeurs ne soient pas bloqués lors de leur première utilisation.

Pour le développement multiplateforme, reportez-vous au guide d'installation d' IronOCR pour Linux ou aux instructions d'installation pour macOS. Les développeurs d'applications mobiles doivent consulter les guides Android et iOS disponibles dans la documentation IronOCR .

Pourquoi la reconnaissance optique de caractères (OCR) ne fonctionne-t-elle pas sous Windows ?

Parmi les problèmes d'installation courants, on note l'absence des composants redistribuables Visual C++ sous Windows. IronOCR requiert la version 2019. Pour obtenir des instructions détaillées, consultez le guide de dépannage de Visual C++ Redistributable . Pour les déploiements Linux, assurez-vous que libgdiplus est installé.

Si la reconnaissance de texte semble médiocre, vérifiez que vos images ont une résolution d'au moins 200 DPI en utilisant le guide des paramètres DPI . La communauté OCR C# sur Stack Overflow offre également des solutions utiles pour les problèmes courants des projets GitHub.

Pour les problèmes de configuration spécifiques, utilisez l' utilitaire IronOCR pour diagnostiquer les problèmes et le guide de dépannage général pour un diagnostic étape par étape.

Où pouvez-vous obtenir de l'aide supplémentaire ?

Pour un dépannage détaillé, consultez le guide de dépannage IronOCR . L' équipe d'assistance IronOCR fournit une assistance rapide aux utilisateurs disposant d'une licence et travaillant sur des applications OCR hébergées sur GitHub. Consultez le journal des modifications du produit pour connaître les dernières mises à jour.