Comment générer un code-barres en PNG

À quoi sert le générateur de codes-barres ?

Ce générateur transforme une donnée fournie en image PNG de code-barres, sous forme de données encodées en base64 lorsque la génération aboutit. Le format Code 128 est utilisé par défaut, ce qui convient notamment à une valeur alphanumérique lorsque vous n’avez pas besoin d’imposer un autre format pris en charge. Vous pouvez aussi régler la largeur, la hauteur et l’affichage du texte associé au code-barres.

Générer le code-barres étape par étape

1. Saisissez la donnée à encoder. Indiquez une valeur non vide, car une entrée vide produit un résultat avec une indication d’erreur et aucune image.

2. Choisissez le format souhaité, si nécessaire. Si vous ne le modifiez pas, le format utilisé est Code 128. Les noms de formats sont normalisés : les majuscules sont converties en minuscules, tandis que les espaces et les traits d’union sont retirés ; certaines variantes avec des underscores sont également associées à leur forme correspondante.

3. Ajustez la largeur et la hauteur si vous avez une contrainte de mise en page. Pour une donnée non vide, la largeur est ramenée à une valeur entière comprise entre 100 et 2000, et la hauteur à une valeur entière comprise entre 40 et 600. Une valeur impossible à convertir revient aux réglages par défaut de 400 pour la largeur et 100 pour la hauteur.

4. Activez ou désactivez l’écriture du texte, selon que la valeur doit apparaître sous le code-barres. Cette option est activée par défaut.

5. Lancez la génération, puis examinez le résultat. En cas de réussite, vous obtenez les données d’une image PNG encodées en base64. Si le format choisi n’est pas disponible, si une valeur numérique ne contient pas assez de chiffres ou si la génération rencontre une erreur, le résultat comporte une indication d’erreur et aucune image n’est fournie. Pour les formats numériques reconnus, les caractères qui ne sont pas des chiffres sont retirés et la saisie est limitée au nombre de chiffres requis ; le chiffre de contrôle est fourni par la bibliothèque de codes-barres lorsque cela s’applique.

Comprendre le résultat

Un résultat réussi doit contenir des données d’image PNG encodées en base64. La présence de ces données indique que le code-barres a été généré ; elle ne signifie pas que ses dimensions en pixels correspondent exactement aux valeurs demandées. Les réglages de largeur et de hauteur sont normalisés, mais les dimensions finales du PNG ne sont pas garanties comme identiques.

Une indication d’erreur sans image signale une limite de la saisie ou de la génération. Vérifiez d’abord que la donnée n’est pas vide, puis contrôlez le format sélectionné. Avec un format numérique, comptez les chiffres effectivement disponibles après le retrait des caractères non numériques. Enfin, si la saisie et le format sont corrects mais qu’aucune image n’est produite, la génération peut avoir échoué.

Exemple pratique

Vous préparez une étiquette interne portant la référence alphanumérique AB-2048.

Pour une étiquette interne, saisissez « AB-2048 », conservez le format Code 128, réglez la largeur à 600, la hauteur à 120, laissez l’affichage du texte activé, puis lancez la génération.

Le résultat attendu est une réussite contenant des données d’image PNG encodées en base64 ; les dimensions finales en pixels ne sont pas garanties comme identiques aux réglages demandés.

Limites

• Les valeurs de largeur et de hauteur sont normalisées, mais les dimensions finales en pixels du PNG ne sont pas garanties comme identiques aux valeurs demandées.
• Un format non disponible ou une erreur de génération peut produire une indication d’erreur sans image.

Erreurs fréquentes

• Une image ne s’affiche pas parce que la donnée est vide ou ne contient pas assez de chiffres pour le format numérique choisi. Saisissez une valeur non vide et vérifiez le nombre de chiffres requis après nettoyage des caractères non numériques.

Questions fréquentes

Le résultat est-il une image PNG ?

Oui, lorsque la génération réussit, le résultat fournit les données d’une image PNG encodées en base64. Une indication d’erreur sans image peut toutefois apparaître si la donnée est vide, si le format n’est pas disponible ou si la génération échoue.

Quel format de code-barres est utilisé par défaut ?

Le format Code 128 est sélectionné par défaut. Vous pouvez choisir un autre format, mais un format non fourni par la bibliothèque de codes-barres produit une indication d’erreur au lieu d’une image.

Les dimensions demandées sont-elles exactement celles du PNG ?

Non, pas nécessairement. Pour une donnée non vide, la largeur et la hauteur sont converties en entiers puis limitées à leurs plages respectives, mais les dimensions en pixels du PNG obtenu ne sont pas garanties comme identiques aux valeurs demandées.