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

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

<TODO : Ajouter une image ici -->

<Description : Diagramme ou capture d'écran illustrant le concept de code -->

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 spécifiques ou des zones spécifiées 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.

en-tête:2(Démarrage rapide : Définir et appliquer la région de découpe pour lire les codes-barres plus rapidement)

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 spécifique de l'image en utilisant BarcodeReaderOptions.

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 la première coordonnée de la Région de Découpe, déplacez le curseur vers l'emplacement préféré, qui sera le coin supérieur gauche du `Rectangle`, et prenez les coordonnées x, y fournies par l'application en bas à gauche de l'écran. Ensuite, localisez 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.

Définition de la référence CropRegion

Quels outils puis-je utiliser pour déterminer les coordonnées ? Les valeurs de coordonnées peuvent ensuite ê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](https://ironsoftware.com/csharp/barcode/how-to/read-barcodes-from-images/), 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 : ```cs :path=/static-assets/barcode/content-code-examples/how-to/set-crop-region-instantiate-CropRegion.cs ``` Ce système de coordonnées fonctionne de manière transparente avec les [fonctions de correction d'image](https://ironsoftware.com/csharp/barcode/how-to/image-correction/) 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 qu'IronBarcode lise, vous pouvez appliquer l'objet dans `BarcodeReaderOptions` comme l'une des propriétés, avec d'autres paramètres. Cela 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](https://ironsoftware.com/csharp/barcode/examples/reading-speeds/) - **Types de BarCode** : spécifiez les formats exacts à rechercher ([formats pris en charge](https://ironsoftware.com/csharp/barcode/get-started/supported-barcode-formats/)) - **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 : ```cs :path=/static-assets/barcode/content-code-examples/how-to/set-crop-region-apply-CropRegion.cs ``` Dans l'extrait de code ci-dessus, nous avons utilisé le `Rectangle` instancié dans l'objet `BarcodeReaderOptions` comme propriété `CropArea`. Nous utilisons ensuite cet objet `BarcodeReaderOptions` en paramètre dans la méthode `BarcodeReader.Read()` pour appliquer la 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](https://ironsoftware.com/csharp/barcode/how-to/async-multithread/) 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](https://ironsoftware.com/csharp/barcode/examples/pdf-barcode-reader-settings-csharp/), 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 - : 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](https://ironsoftware.com/csharp/barcode/features/fault-tolerance/), 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](https://ironsoftware.com/csharp/barcode/examples/barcode-quickstart/) ou des opérations par lots, les régions de culture offrent la précision et les performances nécessaires aux environnements de production.