Barcode 1D - Guide d'usager
InstallationProgramme et extensions nécessaires :
- PHP 4 ou PHP 5, dépendemment de la version que vous téléchargez
- L'extension GD2
- L'extension FreeType (pour écrire le texte)
Vous pouvez vous référer au fichier INSTALL fourni avec le fichier ZIP.
Lorsque tous les fichiers sont installés correctement, nous vous conseillons de modifier la ligne
$class_dir = '../class';
et mettre le chemin absolu dans cette variable.
Pour ajouter d'autres polices, vous devez simplement copier les polices .ttf dans le dossier
class/font.
Les informations présentes dans ce guide d'usager ainsi que dans le manuel sont faits pour la version 2.0.0 et supérieure de Barcode Generator.
Elles sont aussi basées sur la version PHP5 de Barcode Generator. La différence avec la version PHP4 est que les objets sont gérés différement. Vous devez utiliser des références
lorsque vous créez des objets. Référez-vous au
manuel de PHP pour de plus amples informations.
Créer Codes BarresVous pouvez utiliser l'application web pour générer un code barres, mais si vous voulez en générer un dans votre programme, vous devez comprendre comment le code fonctionne.
Référez-vous au
manuel pour obtenir plus d'informations sur les méthodes disponibles.
Vous devez premièrement inclure les fichiers requis pour dessiner votre code barres.
require('class/BCGFont.php');
require('class/BCGColor.php');
require('class/BCGDrawing.php');
Ensuite, vous devez inclure le fichier de votre type de code barres. Pour cet exemple, nous allons générer un code barres de type
Code39.
include('class/BCGcode39.barcode.php');
Nous allons maintenant charger la police pour écrire le label sous le code barres. Si vous ne souhaitez pas avoir de texte, ignorez cette étape.
Le premier argument est le chemin au fichier police ttf et le second est la taille en point (pt) de la police.
$font = new BCGFont('./class/font/Arial.ttf', 18);
Maintenant, générons des couleurs
$color_black = new BCGColor(0,0,0);
$color_white = new BCGColor(255,255,255);
Maintenant, nous devons créer le code barres. Il n'y a pas d'argument normalement utilisé pour le constructeur de la classe; vous devez par contre utiliser les méthodes fournies pour modifier des propriétés du code barre (voyez le
manuel). Pour terminer, vous devez appeler la fonction parse() afin d'analyser le code que vous souhaitez.
$code = new BCGcode39();
$code->setScale(2);
$code->setThickness(30);
$code->setForegroundColor($color_black);
$code->setBackgroundColor($color_white);
$code->setFont($font);
$code->parse('HELLO');
À ce moment, vous devez mettre le code barres sur une image. Nous utilisons la classe
BCGDrawing, mais vous pouvez créer une autre classe similaire pour satisfaire vos besoins. Le premier argument est le nom du fichier, si celui-ci est vide, l'image apparaîtra à l'écran. Le dernier argument est la couleur de fond.
$drawing = new BCGDrawing('', $color_white);
$drawing->setBarcode($code);
$drawing->draw();
Nous changeons maintenant les en-têtes pour dire au navigateur que nous allons afficher une image. Si vous écrivez le code barres dans un fichier, vous n'avez pas besoin d'écrire cette ligne. Si l'image est un jpg, vous devez la modifier.
header('Content-Type: image/png');
Pour terminer, appelez la méthode finish() avec l'argument
BCGDrawing::IMG_FORMAT_PNG ou
BCGDrawing::IMG_FORMAT_JPEG pour avoir un fichier png ou jpg. Si vous aviez spécifié un nom de fichier auparavant, l'image aurait été sauvegardée dans ce fichier, mais ici, elle est affichée.
$drawing->finish(BCGDrawing::IMG_FORMAT_PNG);
Lecture Codes BarresPeut-être vous demandez vous comment lire un code barre ? Vous devez avoir un lecteur de codes barres pour les lire. Il y a
trois lecteurs populaires disponibles : Lecteur Laser (comme dans les supermarchés), Caméra (pas de laser, numérique) et un laser dans un stylo ou dans un glisseur de cartes.
Ces trois lecteurs peuvent lire le code barre que vous avez généré avec Barcode Generator si votre lecteur peut lire la technologie que vous avez utilisée.
Mais quelle résolution je dois choisir ? Normalement, si vous avez un bon lecteur, vous pouvez choisir la première résolution, mais vous
devrez rester proche du code barres pour le lire correctement. Alors nous vous conseillons d'utiliser la seconde résolution. Essayez-le avant !
Note : Vous ne pouvez pas lire directement en pointant le laser sur l'écran de l'ordinateur.