Comment définir une région de recadrage de code-barres en C#

Comment définir la région de culture d'un BarCode pour une lecture plus rapide en C

This article was translated from English: Does it need improvement?
Translated
View the article in English

Définissez une zone de recadrage à l'aide de IronSoftware.Drawing.Rectangle pour limiter la zone de numérisation d'IronBarcode à des régions d'image spécifiques, améliorant considérablement les performances de lecture des codes-barres et réduisant les erreurs en se concentrant uniquement sur les zones pertinentes.

L'une des fonctionnalités les plus importantes d'IronBarcode est la possibilité de spécifier des Crop Regions. Cette fonctionnalité permet à IronBarcode de lire uniquement des codes-barres ou des zones spécifiques spécifiés par la région de recadrage dans l'image à l'aide de l'objet IronSoftware.Drawing.Rectangle. L'utilisation de cette fonctionnalité permet non seulement de réduire les erreurs de lecture, mais aussi d'améliorer les performances de lecture. Cette technique est particulièrement utile lorsqu'on travaille avec des documents multipages ou des images haute résolution où l'emplacement des codes-barres est prévisible.

Lors du traitement d'images comportant plusieurs codes-barres ou des arrière-plans complexes, la définition d'une zone de recadrage devient cruciale pour optimiser votre vitesse de lecture des codes-barres. En limitant la zone de numérisation, vous pouvez atteindre des vitesses de traitement jusqu'à 5 fois plus rapides qu'en numérisant des images entières, tout en réduisant les faux positifs dus à des éléments ne comportant pas de code-barres.

Démarrage rapide : Définir et appliquer une zone de recadrage pour lire plus rapidement les codes-barres

Créez un rectangle de découpe et insérez-le dans IronBarcode en quelques secondes—aucune configuration supplémentaire, aucune friction. Voyez comme il est facile de limiter la numérisation à une zone d'image spécifique en utilisant BarcodeReaderOptions.

  1. Installez IronBarcode avec le Gestionnaire de Packages NuGet

    PM > Install-Package BarCode
  2. Copiez et exécutez cet extrait de code.

    var results = IronBarCode.BarcodeReader.Read("image.png", new IronBarCode.BarcodeReaderOptions { CropArea = new IronSoftware.Drawing.Rectangle(x: 50, y: 100, width: 300, height: 150) });
  3. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronBarcode dans votre projet dès aujourd'hui avec un essai gratuit

    arrow pointer

Comment trouver les coordonnées et la taille d'une zone de recadrage dans une image ?

Il existe de nombreuses façons de trouver les coordonnées d'un point dans une image. Une façon de procéder consiste à charger l'image à l'aide de l'application Paint de votre ordinateur. Pour obtenir les premières coordonnées de la zone de culture, déplacez le curseur vers le premier emplacement souhaité, qui sera le coin supérieur gauche de Rectangle, et prenez les coordonnées x, y données par l'application en bas à gauche de l'écran. Ensuite, repérez le deuxième point, qui sera le coin inférieur droit du Rectangle. Référez-vous à l'image ci-dessous pour une meilleure compréhension.

Pour des scénarios plus avancés, vous pouvez également envisager d'utiliser des logiciels d'édition d'images tels que GIMP ou Photoshop, qui fournissent des coordonnées précises des pixels et des outils de mesure. Certains développeurs préfèrent utiliser des outils de recherche de coordonnées en ligne ou créer de simples utilitaires HTML/JavaScript qui affichent les coordonnées de la souris au survol de l'image.

Crop region diagram showing rectangular area with corner coordinates (x1,y1) and (x2,y2) and dimension calculations

Quels outils puis-je utiliser pour déterminer les coordonnées ?

Les valeurs des coordonnées peuvent alors être utilisées comme propriétés pour l'objet Rectangle. La largeur de l'objet peut être définie comme x2 - x1, tandis que la hauteur peut être définie comme y2 - y1. Lorsque vous travaillez avec des images de BarCode, il est important de comprendre que les coordonnées partent du coin supérieur gauche (0,0) et augmentent à mesure que vous vous déplacez vers la droite (axe des x) et vers le bas (axe des y).

Plusieurs approches de détermination des coordonnées sont possibles :

  • Outils OS intégrés : Windows Paint, macOS Preview
  • Browser Developer Tools : Inspecter l'élément sur les images basées sur le web
  • Les logiciels professionnels : Adobe Photoshop, GIMP
  • Utilitaires personnalisés : applications simples de visualisation des coordonnées
  • Fonctions de débogage d'IronBarcode : exporter des images traitées avec des superpositions de coordonnées

Comment calculer les dimensions d'un rectangle à partir de coordonnées ?

Une fois que vous avez les deux points d'angle, le calcul des dimensions est simple. Le rectangle nécessite quatre paramètres : la coordonnée x, la coordonnée y, la largeur et la hauteur. Voici comment instancier correctement la région de culture :

:path=/static-assets/barcode/content-code-examples/how-to/set-crop-region-instantiate-CropRegion.cs
using IronBarCode;

int x1 = 62;
int y1 = 29;
int x2 = 345;
int y2 = 522;

IronSoftware.Drawing.Rectangle crop1 = new IronSoftware.Drawing.Rectangle(x: x1, y: y1, width: x2-x1, height: y2-y1);
$vbLabelText   $csharpLabel

Ce système de coordonnées fonctionne de manière transparente avec les fonctions de correction d'image d'IronBarcode, ce qui vous permet d'appliquer des filtres uniquement à des régions spécifiques de votre image.

Comment appliquer CropRegion et lire les BarCodes?

Une fois que vous avez défini les CropRegions où vous souhaitez IronBarcode lise, vous pouvez appliquer l'objet dans BarcodeReaderOptions comme l'une des propriétés, ainsi que d'autres paramètres. Ceci peut ensuite être utilisé comme paramètre dans la méthode BarcodeReader.Read(). L'extrait de code ci-dessous montre ce processus :

Quels sont les paramètres acceptés par BarcodeReaderOptions?

La classe BarcodeReaderOptions offre un contrôle complet sur le processus de lecture des codes-barres. Au-delà des régions de culture, vous pouvez configurer :

  • Optimisation de la vitesse : équilibre entre précision et performance à l'aide de paramètres de vitesse
  • Types de BarCode : spécifiez les formats exacts à rechercher (formats pris en charge)
  • Filtres d'image : Appliquez des corrections pour les codes-barres de travers ou endommagés
  • Multithreading : activer le traitement parallèle pour de meilleures performances
  • Gestion de la rotation : Détecter automatiquement les BarCodes ayant subi une rotation

Comment traiter les résultats de plusieurs BarCodes à partir d'une région recadrée?

Lors de la numérisation d'une région recadrée contenant plusieurs codes-barres, IronBarcode renvoie une collection de résultats. Chaque résultat contient de précieuses métadonnées, notamment l'emplacement exact dans la région de culture, le type de code-barres et la valeur décodée. Voici comment mettre en œuvre un traitement complet des régions de culture :

:path=/static-assets/barcode/content-code-examples/how-to/set-crop-region-apply-CropRegion.cs
using IronBarCode;
using System;

int x1 = 62;
int y1 = 29;
int x2 = 345;
int y2 = 522;

IronSoftware.Drawing.Rectangle crop1 = new IronSoftware.Drawing.Rectangle(x: x1, y: y1, width: x2 - x1, height: y2 - y1);

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    CropArea = crop1
};

var result = BarcodeReader.Read("sample.png", options);
foreach (var item in result)
{
    Console.WriteLine(item.Value);
}
$vbLabelText   $csharpLabel

À partir de l'extrait de code ci-dessus, nous avons utilisé l'instanciation Rectangle dans l'objet BarcodeReaderOptions comme propriété CropArea. Nous utilisons ensuite cet objet BarcodeReaderOptions comme paramètre dans la méthode BarcodeReader.Read() pour appliquer CropArea à l'image et lire les codes-barres à l'intérieur.

Techniques avancées pour les régions de culture

Pour les applications de production, envisagez ces stratégies avancées :

  1. Régions de recadrage dynamiques : Calculez les zones de recadrage en fonction des modèles de documents ou des résultats de l'OCR
  2. Multiples régions : Traitez plusieurs zones de coupe dans une seule image pour des mises en page complexes
  3. Optimisation des performances : Combinez les régions de culture avec le traitement asynchrone pour un débit maximal
  4. Gestion des erreurs : mettre en œuvre des stratégies de repli lorsque les codes-barres ne sont pas trouvés dans les régions attendues

Lorsque vous travaillez avec des documents PDF, vous pouvez appliquer des régions de recadrage à des pages spécifiques, ce qui réduit considérablement le temps de traitement des fichiers volumineux. Cette traduction est particulièrement utile pour les factures, les étiquettes d'expédition ou les formulaires où les positions des codes-barres sont normalisées.

Bonnes pratiques pour la définition des régions de culture

Pour maximiser l'efficacité des régions de culture :

  • Add padding : incluez 10 à 20 pixels autour des emplacements prévus pour le code-barres afin de tenir compte des légères variations
  • Testez minutieusement : Vérifiez que les régions de culture fonctionnent sur l'ensemble de vos documents
  • Documenter les coordonnées : Tenir à jour une fiche de référence des régions de culture courantes pour votre application
  • Pensez à la mise à l'échelle : Tenez compte des différentes résolutions d'image ou des paramètres DPI
  • Surveiller les performances : suivre les temps de traitement pour valider l'efficacité de la région de culture

Pour les applications nécessitant une tolérance aux défauts, mettez en œuvre une approche en deux passes : scannez d'abord la région de culture, puis retombez sur la numérisation complète de l'image si aucun code-barres n'est trouvé dans les régions attendues.

Conclusion

La définition des régions de culture est une technique puissante pour optimiser les performances de lecture des codes-barres dans vos applications .NET. En limitant la zone d'analyse à des régions spécifiques, vous pouvez améliorer considérablement la vitesse tout en réduisant les faux positifs. Que vous traitiez des images uniques ou des opérations par lots, les régions de culture offrent la précision et les performances nécessaires aux environnements de production.

Questions Fréquemment Posées

Qu'est-ce qu'une région de culture de codes-barres et pourquoi devrais-je l'utiliser ?

Une zone de culture de code-barres est une zone spécifique d'une image sur laquelle IronBarcode concentre ses efforts de balayage. En définissant une région de recadrage à l'aide de IronSoftware.Drawing.Rectangle, vous pouvez atteindre des vitesses de lecture de codes-barres jusqu'à 5 fois plus rapides tout en réduisant les erreurs en limitant le balayage aux seules zones pertinentes de votre image.

Comment définir une région de culture pour la lecture des codes-barres ?

Vous pouvez définir une zone de culture dans IronBarcode en créant un objet IronSoftware.Drawing.Rectangle avec des coordonnées (x, y) et des dimensions (largeur, hauteur) spécifiques, puis en le passant à la propriété BarcodeReaderOptions.CropArea lors de l'appel de la méthode Read.

Quelles améliorations des performances puis-je attendre de l'utilisation des régions de culture ?

La fonction de région de recadrage d'IronBarcode peut améliorer les performances de lecture des codes-barres jusqu'à 5 fois par rapport à la numérisation d'images entières. Ceci est particulièrement bénéfique lorsque vous travaillez avec des documents de plusieurs pages ou des images haute résolution où les emplacements des codes-barres sont prévisibles.

Comment puis-je trouver les coordonnées correctes pour ma région de culture ?

Vous pouvez trouver les coordonnées de la région de culture à l'aide d'un logiciel d'édition d'images tel que Microsoft Paint, GIMP ou Photoshop. Ouvrez simplement votre image, déplacez votre curseur sur le coin supérieur gauche souhaité de la région, notez les coordonnées x,y, puis trouvez les coordonnées du coin inférieur droit pour déterminer la largeur et la hauteur de votre Rectangle dans IronBarcode.

Quand l'utilisation des régions de culture est-elle particulièrement bénéfique ?

Les régions de recadrage dans IronBarcode sont particulièrement utiles lors du traitement d'images comportant plusieurs codes-barres, des arrière-plans complexes, des documents multipages ou des images haute résolution où l'emplacement des codes-barres est cohérent et prévisible.

Hairil Hasyimi Bin Omar
Ingénieur logiciel
Comme tous les grands ingénieurs, Hairil est un apprenant avide. Il affine ses connaissances en C#, Python et Java, utilisant ces connaissances pour apporter de la valeur aux membres de l'équipe dans toute Iron Software. Hairil a rejoint l'équipe d'Iron Software depuis l'Université Teknologi MARA en Malaisie, ...
Lire la suite
Prêt à commencer?
Nuget Téléchargements 2,121,847 | Version : 2026.3 vient de sortir
Still Scrolling Icon

Vous faites encore défiler ?

Vous voulez une preuve rapidement ? PM > Install-Package BarCode
exécuter un échantillon regarder votre chaîne devenir un code-barres.