$barcode.encode
¶
Description¶
Encode une donnée textuelle sous forme de code barres ou de QR-code
Syntaxe¶
$barcode.encode( text , width , height [ , options ] )
Paramètres¶
text
string- Texte à encoder
width
number- Largeur de l'image à produire en pixels
height
number- Hauteur de l'image à produire en pixels
options
map-
Options d'encodage. Les options reconnues sont:
format
string- Format de code barres ou de qr-code. Les valeurs possibles sont
EAN13
(ouEAN_13
),UPCA
(ouUPC_A
),QRCODE
(ouQR_CODE
),CODE39
(ouCODE_39
),CODE128
(ouCODE_128
),ITF
ouPDF417
(ouPDF_417
). Le format par défaut estQRCODE
. type
string- Type d'image à fournir en output. Les valeurs possibles de l'option
sont
png
,jpg
,svg
,text
. La valeur par défaut estpng
. Le typetext
sert surtout au debug. Il représente le code en texte, avec des espaces et des carrés noirs "█". out
string- Type d'output attendu. Les valeurs de l'option possibles sont
file
(la méthode retournera un fichier pré-généré dans le dossier de travail) outext
(la méthode retourne le flux de données en résultat - cela peut poser problème dans le cas des typespng
oujpg
). Par défaut, le format estfile
inclProperties
boolean- Flag
true
/false
indiquant si la réponse doit inclure les propriétés de l'image générée. Si le flag est activé, la valeur de retour de la méthode sera une map contenant la sortie standard (valeur litérale ou file en fonction du paramètreout
) + des propriétés décrivant les dimensions de l'image, le padding, etc. Le flag est par défaut àfalse
. margin
number- Taille de la marge à ajouter (en pixels). La marge par défaut est de 0. À noter qu'une marge variable peut toutefois être appliquée en fonction de la taille du QR-code généré.
correction
string- Niveau de codes correcteurs à intégrer au qr-code. Les niveaux
supportés sont
H
(~30% de correction),Q
(~25% de correction},M
(~15% de correction) etL
(~7% de correction). charset
string- Charset du texte à reprendre dans le qr-code
svgPathOnly
boolean- Demande à la méthode de retourner le path svg, sans les entêtes xml (uniquement si le fichier de sortie est un svg)
delPadding
boolean- Demande à la méthode d'éliminer le padding (actuellement, uniquement
si le fichier de sortie est un svg). L'option est par défaut à
true
.
Retour¶
La valeur de retour dépend du type d'image demandé dans les paramètres.
Exemple¶
1 |
|