$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¶
textstring- Texte à encoder
widthnumber- Largeur de l'image à produire en pixels
heightnumber- Hauteur de l'image à produire en pixels
optionsmap-
Options d'encodage. Les options reconnues sont:
formatstring- 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),ITFouPDF417(ouPDF_417). Le format par défaut estQRCODE. typestring- Type d'image à fournir en output. Les valeurs possibles de l'option
sont
png,jpg,svg,text. La valeur par défaut estpng. Le typetextsert surtout au debug. Il représente le code en texte, avec des espaces et des carrés noirs "█". outstring- 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 typespngoujpg). Par défaut, le format estfile inclPropertiesboolean- Flag
true/falseindiquant 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. marginnumber- 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é.
correctionstring- 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). charsetstring- Charset du texte à reprendre dans le qr-code
svgPathOnlyboolean- Demande à la méthode de retourner le path svg, sans les entêtes xml (uniquement si le fichier de sortie est un svg)
delPaddingboolean- 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 | |