IntroductionLe code ISBN est utilisé pour l'enregistrement des livres dans le commerce. Il est basé sur le code EAN-13. Un code ISBN peut contenir 10 caractères, dans ce cas 978 ou 979 viendra précéder le code pour être encodé dans un code EAN-13.
Les tirets qui sont présents sont décidés par les agences de distribution de code. Vous pouvez les écrire mais ils seront simplement ignoré. Barcode Generator en placera de nouveau de manière à générer un texte semblable au texte ISBN.
Cette classe hérite de la classe
BCGean13.
Méthodes de BCGisbnMéthodes de BCGean13Aucune méthode spécifique à cette classe.
Méthodes de BCGBarcode1DMéthodes de BCGBarcodeExemple
<?php
require('class/BCGFont.php');
require('class/BCGColor.php');
require('class/BCGDrawing.php');
require('class/BCGisbn.barcode.php');
$font = new BCGFont('./class/font/Arial.ttf', 18);
$color_black = new BCGColor(0, 0, 0);
$color_white = new BCGColor(255, 255, 255);
$code = new BCGisbn();
$code->setScale(2);
$code->setThickness(30);
$code->setForegroundColor($color_black);
$code->setBackgroundColor($color_white);
$code->setFont($font);
$code->parse('9780672326970');
$drawing = new BCGDrawing('', $color_white);
$drawing->setBarcode($code);
$drawing->draw();
header('Content-Type: image/png');
$drawing->finish(BCGDrawing::IMG_FORMAT_PNG);
?>
Explication des Méthodes__construct($gs1 = self::GS1_AUTO, $isbn_text = BarCode1D::AUTO_LABEL, $isbn_font = null) — Spécifie plusieurs paramètres avant de construire le code barre
Description
Pour comprendre la signification de chaque argument, référez-vous aux méthodes correspondantes.
Tous les arguments ont une valeur par défaut, elle est écrite en italique.
setGS1($gs1) — Spécifie les chiffres qui précéderont le code
Description
Spécifie quels caractères qui précédera le code. Les différentes valeurs pour cet argument sont :
- BCGisbn::GS1_AUTO : Effectue la même opération que BCGisbn::GS1_PREFIX978
- BCGisbn::GS1_PREFIX978 : Ajoute 978 avant le code
- BCGisbn::GS1_PREFIX979 : Ajoute 979 avant le code
setISBNText($text) — Spécifie le texte au dessus du code barre
Description
La valeur par défaut est BCGBarcode1D::AUTO_LABEL.
En mettant ayant cette valeur, le texte "ISBN ..." sera automatiquement écrit
lorsque le code barre sera dessiné.
setISBNFont($font) — Spécifie la police du texte au dessus du code barre
Description
La valeur de l'argument peut être soit une instance de la classe
BCGFont ou un chiffre de 1 à 5.
Vous pourrez spécifier une police spécifique avec la classe Font, alors qu'avec les chiffres, les polices de PHP seront utilisées.
Référez-vous au
manuel PHP.
setThickness($thickness) — Spécifie l'épaisseur du code barre
Description
L'épaisseur du code barre est en pixel. Il s'agit de la grandeur verticale.
Cette valeur est multipliée par la résolution. Référez-vous à la méthode
setScale().
La valeur par défaut est 30.
getThickness() — Retourne l'épaisseur du code barre
Description
L'épaisseur du code barre est en pixel. La valeur n'est pas multipliée par la résolution.
setLabel($label) — Spécifie le texte qui accompagne le code barre
Description
Le texte sera écrit au dessous ou au dessus du code barre dépendamment de celui-ci.
Vous pouvez écrire la valeur spéciale
BCGBarcode1D::AUTO_LABEL si vous
souhaitez que le texte soit automatiquement choisi. Il sera alors la valeur du texte passé à la méthode
parse().
getLabel() — Retourne le texte qui accompagne le code barre
Description
Retourne la vraie valeur qui serait affichée avec le code barre. Vous devez avoir appelé la méthode
parse().
setFont($font) — Spécifie la police du texte qui accompagne le code barre
Description
La valeur de l'argument peut être soit une instance de la classe
BCGFont ou un chiffre de 1 à 5.
Vous pourrez spécifier une police spécifique avec la classe BCGFont, alors qu'avec les chiffres, les polices de PHP seront utilisées.
Référez-vous au
manuel PHP.
parse($text) — Analyse un message
$text pour dessiner par la suite
Description
Les données que vous passez à l'argument $text doivent être supportées par le code barre que vous utilisez.
Référez-vous à l'introduction du code barre pour obtenir plus d'informations.
draw($im) — Dessine le code barre sur l'image
$im
Description
La valeur de l'argument
$im doit être une ressource image GD2. La taille de l'image
peut être définie avec la valeur reçue de
getMaxSize().
getMaxSize() — Retourne un tableau concernant la taille de l'image requise
Description
Retourne un tableau dont le premier index est la largeur de l'image et le deuxième index
est la hauteur de l'image. La classe
BCGDrawing utilise cette fonction pour créer la ressource
d'image.
Retourne
array(int, int) - [0] étant la largeur, [1] étant la hauteur
getScale() — Retourne la résolution du code barre
Description
Retourne la taille du code barre. La veleur correspond à la "plus petite" unité exprimée en pixel.
Retourne
int - valeur en pixel
setScale($x) — Fixe la résolution du code barre
Description
Le code barre sera $x fois plus grand. Un pixel sera alors de taille $x par $x.
setForegroundColor($color) — Fixe la couleur du code barre
Description
La couleur des barres du code barre. Par défaut, la couleur est noire. L'argument peut être soit une
classe
BCGColor ou n'importe quel autre argument
que la classe
BCGColor peut accepter à son constructeur.
setBackgroundColor($color) — Fixe la couleur du fond
Description
La couleur de fond du code barre. Par défaut, la couleur est blanche. L'argument peut être soit une
classe
BCGColor ou n'importe quel autre argument
que la classe
BCGColor peut accepter à son constructeur.
setColor($fg, $bg) — Fixe la couleur du code barre et de fond
setOffsetX($v) — Spécifie le décalage en X
Description
Spécifie le décalage en X du code barre en pixel multiplié par l'échelle. La taille requise retournée par
getMaxSize() sera modifiée en conséquence.
setOffsetY($v) — Spécifie le décalage en Y
Description
Spécifie le décalage en Y du code barre en pixel multiplié par l'échelle. La taille requise retournée par
getMaxSize() sera modifiée en conséquence.