BCGcode128 Class
Le Code 128 permet d'encoder tous les caractères ASCII de 0 à 127. Différentes tables d'encodage existent afin d'encoder
le code de manière efficace. Lorsqu'un caractère n'est pas disponible dans une table, un caractère de changement de table est écrit.
Il est possible de choisir la table de début du code, il est donc conseillé de choisir une table qui contient les premiers caractères que vous souhaitez écrire.
Voici la liste des caractères des tables :
- Table A : ASCII 0-95 (majuscules, chiffres, caractères spéciaux)
- Table B : ASCII 32-127 (majuscule, minuscule, chiffres, caractères spéciaux)
- Table C : Groupe de deux chiffres de 00 à 99
Le code 128 contient aussi 4 caractères spéciaux qui ne peuvent être écrit directement. Il s'agit des caractères FNC1, FNC2, FNC3 et FNC4.
Vous pouvez les écrire en activant le caractère tilde (~) avec la méthode
setTilde().
Cette classe hérite de la classe
BCGBarcode1D.
Cette classe est aussi disponible pour WebControl :
BCGcode128 Exemple
protected void Page_Load(
object sender,
EventArgs e)
{
BCGFont font = new BCGFont(new Font("Arial", 18, FontStyle.Regular));
BCGColor color_black = new BCGColor(0, 0, 0);
BCGColor color_white = new BCGColor(255, 255, 255);
BCGBarcode1D code = new BCGcode128();
code.setScale(2);
code.setThickness(30);
code.setForegroundColor(color_black);
code.setBackgroundColor(color_white);
code.setFont(font);
code.setStart("B");
code.setTilde(true);
code.parse("a123");
BCGDrawing drawing = new BCGDrawing(null, color_white);
drawing.setBarcode(code);
drawing.draw();
Response.ContentType = "image/png";
drawing.finish(ImageFormat.Png, Response.OutputStream);
}
Explication des MéthodesBCGcode128() — Constructeur par défaut, utilisant le Code128B
Description
Constructeur par défaut qui initialise le code avec la table B.
BCGcode128(string start) — Constructeur permettant de spécifier quelle table utiliser
Description
Constructeur qui permet de choisir la table avec laquelle vous souhaitez débuter. Voyez la méthode
setStart() pour de plus amples informations.
setStart(string start) — Spécifie par quel table doit commencer le code barre
Description
L'argument peut être A, B ou C. Cela signifie par quelle table doit commencer le code barre.
La valeur par défaut est B.
Les tables comportent différents caractères qui peuvent être encodés dans le code barre.
Référez-vous à l'introduction de ce document pour obtenir plus d'informations.
setTilde(bool accept) — Spécifie si le tilde ~ doit être traité
Description
En mettant
true à l'argument de cette méthode, les caractères tilde (ASCII 126 ~) seront pris
comme des caractères spéciaux. Voici les caractères spéciaux que vous pouvez écrire.
- ~~ : Écrit un simple tilde
- ~Fx : Écrit le caractère FNCx, avec x variant de 1 à 4.
La valeur par défaut est
true.
setThickness(int 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(string 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(BCGFont font) — Spécifie la police du texte qui accompagne le code barre
Description
Spécifie la police que vous souhaitez utiliser pour écrire le texte.
parse(string 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(ref Bitmap bm) — Dessine le code barre sur l'image
bm
Description
La valeur de l'argument
bm doit être une ressource
Bitmap. 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
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(int 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(BCGColor 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(BCGColor 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.
setOffsetX(int offsetX) — 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(int offsetY) — 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.