Version courante : 2.2.1
IntroductionLe code PDF417 fait partie de la famille des codes barres en 2D. Il permet d'encoder beaucoup d'information en un seul code barre.
Tous les caractères ASCII de 0 à 255 sont supportés. PDF417 encode les données différemment dépendamment du type de caractères fournis. Certains caractères sont encodés avec un plus grand taux de compression.
Voyez le taux de compression sur la page
Aperçu.
Depuis la version 2.2.0, cette classe analyse automatiquement les données que vous fournissez et choisit le code le plus petit pour l'affichage.
Cette classe hérite de la classe
BCGBarcode2D.
Méthodes de BCGpdf417Méthodes de BCGBarcode2DAucune méthode spécifique à cette classe.
Méthodes de BCGBarcodeExemple
<?php
require('BCGColor.php');
require('BCGDrawing.php');
require('BCGpdf417.barcode2d.php');
$code = new BCGpdf417();
$code->setScale(3);
$code->setErrorLevel(2);
$code->setCompact(false);
$code->setQuietZone(true);
$code->parse('PDF 417');
$color_black = new BCGColor(0, 0, 0);
$color_white = new BCGColor(255, 255, 255);
$drawing = new BCGDrawing('', $color_white);
$drawing->setBarcode($code);
$drawing->draw();
header('Content-Type: image/png');
$drawing->finish(BCGDrawing::IMG_FORMAT_PNG);
?>
Explication des MéthodessetQuietZone($quietZone) — Spécifie de dessiner une zone muette autour du code barre
Description
Pour être lu correctement, le PDF417 nécessite d'avoir une zone muette (quiet zone) autour de l'image.
Vous pouvez néanmoins ne pas l'afficher.
La valeur par défaut est true.
setCompact($compact) — Spécifie si le code barre doit être au format tronqué
Description
Coupe le code barre en enlevant les 2 dernières colonnes sur la droite. Votre code barre se retrouve plus petit,
par contre, il sera plus difficile de le lire.
La valeur par défaut est false.
setColumn($column) — Fixe le nombre de colonnes de données
Description
Spécifie le nombre de colonnes de données que vous souhaitez écrire.
Vous pouvez répartir vos données plus horizontalement que verticalement en modifiant ce paramètre.
Le nombre de colonne doit être compris entre 1 et 30.
La valeur par défaut est -1. En mettant cette valeur, le nombre de colonnes est calculé automatiquement pour être le plus optimal possible.
setErrorLevel($errorLevel) — Fixe le niveau d'erreur du code barre
Description
Il s'agit du niveau d'erreur qui permettra la détection et la correction d'erreur dans le code barre.
Le niveau donné doit être entre 0 et 8.
La valeur par défaut est -1. En mettant cette valeur, le niveau d'erreur est calculé automatiquement pour être le plus optimal possible.
Le nombre de mot clés que vous pouvez écrire dans un seul code barre dépend du niveau d'erreur. Voyez
l'aperçu pour plus de détails.
setRatio($ratio) — Spécifie le ratio pour l'impression
Description
Fixe le ratio pour l'impression. Ceci est utilisé seulement si le nombre de colonnes est choisi automatiquement puisque ce paramètre affecte le nombre de colonnes dans votre code barre.
Si le chiffre est inférieur à 1, le code barre sera étendu plus à l'horizontal.
La valeur par défaut est 1.
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.