Comment créer des images de codes-barres

Hairil related to Comment créer des images de codes-barres
Hairil Hasyimi Bin Omar
mars 19, 2023
Mise à jour décembre 17, 2024
Partager:
This article was translated from English: Does it need improvement?
Translated
View the article in English


Générez des codes-barres et enregistrez-les sous forme de fichiers image.

En plus de lire les codes-barres, IronBarcode est un outil puissant qui permet également aux utilisateurs de créer des codes-barres avec un codage très minimal. Pour y parvenir, il suffit d'appeler la méthode CreateBarcode() de la classe BarcodeWriter, où la valeur, le type, la largeur et la hauteur du code-barres peuvent être spécifiés dans les paramètres de la méthode. Cela produit un objet GeneratedBarcode, qui peut ensuite être enregistré sous forme de fichier image à l'aide de la méthode SaveAs(). Discutons en détail de chaque paramètre et voyons ensuite comment implémenter l'écriture de code-barres avec un extrait de code.

Valeur du code-barres

La méthode BarcodeWriter.CreateBarcode() accepte plusieurs types de données pour les valeurs de code-barres. Cela inclut byte[] array, MemoryStream, et string. Les longueurs de la chaîne et les caractères acceptés varient selon le type de code-barres, mais tout cela est détaillé dans notre documentation.

Types de codage des codes-barres

IronBarcode prend en charge une grande variété de formats de codes-barres pour l'écriture—la liste complète peut être trouvée dans notre article Formats de codes-barres pris en charge. Ces types de codes-barres ont tous leurs propres propriétés uniques, spécialités et utilisations—vous pouvez rechercher celui qui convient le mieux à votre cas d'utilisation avec notre documentation.

Largeur et hauteur

Définissez la largeur et la hauteur de l'image de code-barres en pixels. Par défaut, les deux mesures sont définies à 250 px. Plusieurs types de codes-barres, tels que QR et PDF417, nécessitent des dimensions spécifiques pour être conformes. Ainsi, pour les largeurs et hauteurs d'entrée qui ne correspondent pas aux dimensions requises du code-barres, le code-barres sera généré avec les dimensions conformes et l'espace restant sera rempli par des blancs. Si les dimensions sont trop petites pour le code-barres, une exception sera levée.

Importer des codes-barres sous forme d'image

Lors de la création d'un code-barres avec la méthode BarcodeWriter.CreateBarcode(), un objet GeneratedBarcode sera généré. Avec cet objet, nous pouvons enregistrer le code-barres dans une variété de formats d'image avec plusieurs méthodes SaveAs() spécifiques à chaque format d'image. Ces méthodes incluent :

  • SaveAsGif() : Cette méthode enregistre le GeneratedBarcode en tant que fichier image GIF et accepte le chemin du fichier image comme argument de chaîne de caractères.
  • SaveAsJpeg() : Cette méthode enregistre le GeneratedBarcode sous forme de fichier image JPEG et accepte le chemin du fichier image comme argument de type chaîne de caractères.
  • SaveAsPng() : Cette méthode enregistre le GeneratedBarcode en tant que fichier image PNG et accepte le chemin du fichier image comme argument de type chaîne.
  • SaveAsTiff() : Cette méthode enregistre le GeneratedBarcode en tant que fichier image TIFF et accepte le chemin du fichier image comme argument de type chaîne.
  • SaveAsWindowsBitmap() : Cette méthode enregistre le GeneratedBarcode en tant que fichier image BMP et accepte le chemin du fichier image comme argument de type chaîne de caractères.
  • SaveAsImage() : Il s'agit d'une méthode générale pour enregistrer le GeneratedBarcode en tant que fichier image—les utilisateurs doivent spécifier l'extension de format de fichier désirée lors de la saisie du chemin de fichier.

Générer un code-barres et enregistrer en tant que fichier image

Nous allons maintenant utiliser BarcodeWriter.CreateBarcode() pour démontrer la création d'un code-barres Code128, et le sauvegarder sur le disque en tant que fichier image JPEG.

:path=/static-assets/barcode/content-code-examples/how-to/create-barcode-images-one-dimensional.cs
using IronBarCode;

BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg");
Imports IronBarCode

BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg")
$vbLabelText   $csharpLabel
Code-barres unidimensionnel extrait du fragment

Générer des codes QR et enregistrer sous forme de fichiers image

L'un des codes-barres les plus populaires de nos jours, code QR, qui est également l'un des codes-barres classés comme un code-barres bidimensionnel, est entièrement pris en charge par IronBarcode. En raison de leur polyvalence, de leur attrait esthétique et de leurs fonctionnalités hautement personnalisables, les codes QR ont gagné une grande popularité auprès des utilisateurs.

Contrairement à la création de codes-barres unidimensionnels et d'autres types, la création de codes QR utilisera une méthode différente provenant d'une classe distincte dans IronBarcode en raison de la complexité des codes QR, qui nécessitent des propriétés et des arguments différents pour produire des codes QR de haute qualité, comme l'exigent les clients. Pour créer des codes QR dans IronBarcode, les utilisateurs devront appeler la méthode CreateQrCode() de la classe QRCodeWriter. La méthode QRCodeWriter.CreateQrCode() accepte 4 arguments, où la valeur du code-barres est le premier argument, la taille du code QR de sortie est le second, le champ enum QRCodeWriter.QrErrorCorrectionLevel est le troisième argument, et enfin c'est le QRVersion. Examinons en détail les arguments en faveur de cette méthode.

Valeurs du code QR

De la même manière que la méthode BarcodeWriter.CreateBarcode(), QRCodeWriter.CreateQrCode() accepte d'abord une valeur pour le code QR qui peut être numérique, alphabétique ou alphanumérique. Ces valeurs peuvent être saisies dans la méthode sous forme de tableau byte [], de MemoryStream et de type System.String.

Taille du code QR

Les utilisateurs peuvent également spécifier la taille du code QR directement dans la méthode en tant que type Int32. L'unité de mesure pour la taille du code QR utilisée dans cette méthode est en pixels(px). La taille par défaut du code QR est de 500 px.

Niveau de correction d'erreur QR

QRErrorCorrectionLevel est une propriété membre de la classe QRCodeWriter dans laquelle il y a 4 champs, qui sont Highest, High, Medium, et Low. Fondamentalement, cette propriété est le niveau de tolérance aux erreurs d'un code QR, dans lequel un niveau de correction plus élevé crée des codes QR plus complexes qui sont moins sujets aux erreurs de lecture, même s'ils sont endommagés ou partiellement obscurcis. Examinons maintenant en détail chacun des champs de cette propriété, ainsi que la différence d'aspect du code QR produit.

QRErrorCorrectionLevel.Highest

Les codes QR générés avec le niveau de correction le plus élevé auront une image de code QR plus complexe, dont 30 % est utilisé pour la correction d'erreur. Le code QR produit peut également être estampillé avec un logo ou une image graphique sur le code QR.

Code QR avec le niveau de correction le plus élevé

QRErrorCorrectionLevel.High

Définir le champ de propriété sur Élevé entraînera l'application d'une correction d'erreur de 25 % dans l'image du code QR. Ce sera moins complexe que l'image de code QR produite à partir de QRErrorCorrectionLevel.Highest.

Code QR avec un niveau de correction élevé

QRErrorCorrectionLevel.Medium

Ce champ ne s'applique qu'à une correction d'erreur de 15 % dans l'image du code QR. En utilisant ce paramètre, les utilisateurs pourront produire des codes QR plus rapidement, mais ils seront plus enclins à commettre des erreurs.

Code QR avec niveau de correction moyen

QRErrorCorrectionLevel.Low

Il s'agit du paramètre le plus bas pour le niveau de correction d'erreur, qui n'applique qu'une correction d'erreur de 7 % dans l'image du code QR et produit le code QR le moins complexe.

Code QR avec un faible niveau de correction

QrVersion

La version QR est la version du symbole du code QR qui va de 1 à 40, la version QR la plus élevée produisant un code QR plus complexe, qui permet aux utilisateurs de stocker plus de données, et vice versa pour la version la plus basse du code QR. Notez toutefois que si la version QR est trop basse, des problèmes peuvent survenir lorsque les utilisateurs essaient d'encoder plus de données que ce qui est autorisé par la version. Si la version QR est fixée à 0, la version QR appropriée sera automatiquement attribuée en fonction de la valeur à encoder. Veuillez consulter ce site pour plus d'informations sur la version QR : Version QR

Créer une image de code QR

Le code ci-dessous démontre comment utiliser la méthode QRCodeWriter.CreateQrCode() dans IronBarcode pour écrire un code QR et l'enregistrer en tant que fichier image sur le disque en utilisant la méthode SaveAsJpeg().

:path=/static-assets/barcode/content-code-examples/how-to/create-barcode-images-qr.cs
using IronBarCode;

QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion: 0).SaveAsJpeg("QRMedium.jpeg");
Imports IronBarCode

QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion:= 0).SaveAsJpeg("QRMedium.jpeg")
$vbLabelText   $csharpLabel
Code QR avec niveau de correction moyen

Dans l'extrait de code ci-dessus, la valeur alphanumérique a été utilisée comme valeur à encoder dans le code QR, et nous avons utilisé 250 pixels comme mesure du code QR produit. Nous avons également spécifié que la correction d'erreur du code QR produit devait être moyenne et nous avons laissé le programme décider de la version du code QR qui convenait à notre valeur de code QR. En dehors de cela, nous avons également joint SaveAsJpeg() qui accepte le nom de fichier de l'image du code QR avec l'extension de format d'image, qui est un JPEG dans ce cas, pour être enregistré en tant qu'argument.

Hairil related to Créer une image de code QR
Ingénieur logiciel
Comme tous les grands ingénieurs, Hairil est un fervent apprenant. Il affine ses connaissances en C#, Python et Java, et les utilise pour apporter une valeur ajoutée aux membres de l'équipe d'Iron Software. Hairil a rejoint l'équipe d'Iron Software en provenance de l'Universiti Teknologi MARA en Malaisie, où il a obtenu une licence en génie chimique et des procédés.