Manuel - MaxiCode
Introduction
Le code MaxiCode fait partie de la famille des codes-barres en 2D. Il permet d'encoder un nombre spécifique d'information à l'intérieur d'un seul symbole.
Tous les caractères ASCII de 0 à 255 sont supportés. MaxiCode 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 technique.
Cette classe hérite de la classe BCGBarcode2D.
Exemple
Méthodes
Méthodes de BCGmaxicode
- getQuietZone() — Retourne si la zone muette sera dessinée
-
setQuietZone(
quietZone ) — Spécifie de dessiner une zone muette autour du code-barres - getMode() — Récupère le mode du code-barres
-
setMode(
mode ) — Spécifie le mode -
setPrimaryMessage(
serviceClass ,countryCode ,postalCode ) — Spécifie le message primaire -
setAcceptECI(
accept ) — Spécifie d'accepter les codes ECI -
setStructuredAppend(
snum ,st ) — Spécifie que les données seront dispersées sur plusieurs codes-barres
Méthodes de BCGBarcode2D
-
setScaleX(
scaleX ) — Spécifie la résolution du codes-barres en X -
setScaleY(
scaleY ) — Spécifie la résolution du codes-barres en Y
Méthodes de BCGBarcode
-
parse(
text ) — Analyse un messagetext pour dessiner par la suite -
draw(
image ) — Dessine le code-barres sur l'imageimage -
getDimension(
width ,height ) — Retourne un tableau concernant la taille de l'image requise - getScale() — Retourne la résolution du code-barres
-
setScale(
scale ) — Fixe la résolution du code-barres - getForegroundColor() — Retourne la couleur des barres
-
setForegroundColor(
color ) — Fixe la couleur des barres - getBackgroundColor() — Retourne la couleur des espaces
-
setBackgroundColor(
color ) — Fixe la couleur des espaces -
setColor(
foregroundColor ,backgroundColor ) — Fixe la couleur des barres et des espaces - getOffsetX() — Retourne le décalage en X
-
setOffsetX(
value ) — Spécifie le décalage en X - getOffsetY() — Retourne le décalage en Y
-
setOffsetY(
value ) — Spécifie le décalage en Y -
addLabel(
label ) — Ajoute un texte qui accompagne le dessin -
removeLabel(
label ) — Supprime un texte qui accompagne le dessin - clearLabels() — Supprime les textes qui accompagnent le dessin
Exemple de Code
'use strict';
import { createServer } from 'http';
import { BCGColor, BCGDrawing, createSurface, toBuffer } from '@barcode-bakery/barcode-nodejs';
import { BCGmaxicode } from '@barcode-bakery/barcode-nodejs/maxicode';
http.createServer(function (request, response) {
const colorBlack = new BCGColor(0, 0, 0);
const colorWhite = new BCGColor(255, 255, 255);
// Barcode Part
const code = new BCGmaxicode();
code.setScale(2); // Resolution
code.setForegroundColor(colorBlack); // Color of bars
code.setBackgroundColor(colorWhite); // Color of spaces
code.parse('Maxicode');
// Drawing Part
const drawing = new BCGDrawing(createSurface);
toBuffer(drawing, BCGDrawing.ImageFormat.Png, function (err, buffer) {
response.writeHead(200, { "Content-Type": "image/png" });
response.end(buffer);
});
}).listen(8124);
Explications des Méthodes
-
getQuietZone()
—
Retourne si la zone muette sera dessinée
Retourne
bool -true si activé,false autrement -
setQuietZone(
quietZone ) — Spécifie de dessiner une zone muette autour du code-barresDescriptionPour être lu correctement, le MaxiCode nécessite d'avoir une zone muette (quiet zone) autour de l'image. Vous pouvez cependant ne pas l'afficher.
La valeur par défaut est true. -
getMode()
—
Récupère le mode du code-barres
DescriptionRécupère le mode du code-barres.Retourne
int -
setMode(
mode ) — Spécifie le modeDescriptionSpécifie le mode pour générer le code-barres. Vous pouvez utiliser un mode 2 à 6. Voyez la page information technique pour plus d'information.
La valeur par défaut est 4. -
setPrimaryMessage(
serviceClass ,countryCode ,postalCode ) — Spécifie le message primaireDescriptionSpécifie le message primaire pour les modes 2 ou 3. Si vous utilisez cette méthode, vous pouvez utiliser la méthodeparse() pour remplir le message secondaire. Si vous n'utilisez pas cette méthode pour les modes 2 ou 3, le code-barres essaiera d'extraire les données du message passé à la méthodeparse() .
La classe de service doit être un nombre entre 0 et 999. Le code de pays doit être un code ISO 3166 entre 0 et 999. Le code postal doit être numérique seulement (mode 2), ou alphanumérique (mode 3).
Spécifiez leserviceClass à -1 pour réinitialiser le message primaire. -
setAcceptECI(
accept ) — Spécifie d'accepter les codes ECIDescriptionEn mettanttrue à l'argument de cette méthode, les caractères antislash (ASCII 92 \) seront pris comme des caractères spéciaux. Voici les caractères spéciaux que vous pouvez écrire.
- \\ : Écrit un simple antislash
- \xxxxxx : Écrit le caractère ECI xxxxxx avec x pouvant varier de 0 à 9
La valeur par défaut est false. -
setStructuredAppend(
snum ,st ) — Spécifie que les données seront dispersées sur plusieurs codes-barresDescriptionLes données du code MaxiCode peuvent être séparées sur plusieurs codes-barres.
Le premier argument est le numéro du code-barres (commençant par 1), le deuxième argument est le nombre total de codes-barres que vous avez.
Il est possible d'encoder sur 8 codes-barres différents au maximum.Retournebool -true en cas de succès,false en cas d'échec
-
setScaleX(
scaleX ) — Spécifie la résolution du codes-barres en XDescriptionLa largeur en pixel d'un module.
La valeur par défaut est 1.
Notez que cette méthode est protégée (protected). -
setScaleY(
scaleY ) — Spécifie la résolution du codes-barres en YDescriptionLa hauteur en pixel d'un module.
La valeur par défaut est 1.
Notez que cette méthode est protégée (protected).
-
parse(
text ) — Analyse un messagetext pour dessiner par la suiteDescriptionLes données que vous passez à l'argumenttext doivent être supportées par le type de code-barres que vous utilisez.
Référez-vous à l'introduction de chaque code-barres pour obtenir plus d'informations comment utiliser cette méthode pour chaque type de code-barres. -
draw(
image ) — Dessine le code-barres sur l'imageimage DescriptionLa valeur de l'argumentimage doit être une image ressource. La taille de l'image peut être définie avec la valeur reçue degetDimension() . -
getDimension(
width ,height ) — Retourne un tableau concernant la taille de l'image requiseDescriptionRetourne un tableau dont le premier index est la largeur de l'image et le deuxième index est la hauteur de l'image.
Les arguments sont utilisés pour spécifier le point de départ du dessin. Ils devraient être 0.
La classeBCGDrawing utilise cette fonction pour créer la ressource d'image.Retournearray(int, int) - [0] étant la largeur, [1] étant la hauteur -
getScale()
—
Retourne la résolution du code-barres
DescriptionRetourne la taille du code-barres. La valeur correspond à la "plus petite" unité exprimée en pixel.Retourne
int - valeur en pixels -
setScale(
scale ) — Fixe la résolution du code-barresDescriptionLe code-barres serax fois plus grand. Un pixel sera alors de taillex parx . -
getForegroundColor()
—
Retourne la couleur des barres
DescriptionRetourne la couleur des barres du code-barres.Retourne
-
setForegroundColor(
color ) — Fixe la couleur des barres -
getBackgroundColor()
—
Retourne la couleur des espaces
DescriptionRetourne la couleur des espaces du code-barres.Retourne
-
setBackgroundColor(
color ) — Fixe la couleur des espaces -
setColor(
foregroundColor ,backgroundColor ) — Fixe la couleur des barres et des espacesDescriptionUne méthode plus rapide pour fixer la couleur de premier plan et de l'arrière-plan. Référez-vous àsetForegroundColor() etsetBackgroundColor() . -
getOffsetX()
—
Retourne le décalage en X
DescriptionRetourne le décalage en X en pixel. Cette valeur n'est pas multipliée par la résolution.Retourne
int - valeur en pixels -
setOffsetX(
value ) — Spécifie le décalage en XDescriptionSpécifie le décalage en X du code-barres en pixel multiplié par la résolution. La taille requise retournée pargetDimension() sera modifiée en conséquence. -
getOffsetY()
—
Retourne le décalage en Y
DescriptionRetourne le décalage en Y en pixel. Cette valeur n'est pas multipliée par la résolution.Retourne
int - valeur en pixels -
setOffsetY(
value ) — Spécifie le décalage en YDescriptionSpécifie le décalage en Y du code-barres en pixel multiplié par la résolution. La taille requise retournée pargetDimension() sera modifiée en conséquence. -
addLabel(
label ) — Ajoute un texte qui accompagne le dessinDescriptionAjoute un objetBCGLabel au dessin. -
removeLabel(
label ) — Supprime un texte qui accompagne le dessinDescriptionSupprime un objetBCGLabel spécifique du graphique. -
clearLabels()
—
Supprime les textes qui accompagnent le dessin
DescriptionSupprime tous les objets
BCGLabel du dessin.