Manuel - Code 128
Introduction
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.
Si vous n'en spécifiez aucune, la table sera automatiquement choisie.
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 tilde={}.
Vous pouvez passer du texte normal directement à la méthode text={} pour que celle-ci analyse votre texte et choisisse la meilleure méthode d'encodage. Vous pouvez cependant forcer une méthode d'encodage, voici les possibilités que vous pouvez passer à la méthode text={} :
- auto encoding : méthode d'encodage automatique
[Code128.CODE128_A, 'TEXT']
: Table A[Code128.CODE128_B, 'text']
: Table B[Code128.CODE128_C, '012345']
: Table C[[Code128.CODE128_C, '012345'], 'auto encoding']
: plusieurs méthodes d'encodage
Cette classe hérite de la classe BakeryBarcode1D.
Prise en charge des caractères ASCII étendus
Afin de prendre en charge les caractères ASCII étendus tels que ü (u-umlaut / diérèse) ou ß (eszett), vous devez précéder le caractère d'un FNC4 puis soustraire le point unicode du caractère par 128.
Le code FNC4 agit comme une bascule pour un seul caractère. Si vous prévoyez d'encoder plus d'un caractère consécutif, vous pouvez utiliser deux caractères FNC4 consécutifs pour verrouiller les caractères suivants en mode étendu. Vous pouvez répéter les doubles caractères FNC4 pour revenir au mode non-étendu.
Par exemple, pour encoder Grüße, procédez comme suit:
const text = 'Gr~F4' + String.fromCharCode('ü'.charCodeAt(0) - 128) + '~F4'
+ String.fromCharCode('ß'.charCodeAt(0) - 128) + 'e';
ou
const text = 'Gr~F4~F4' + String.fromCharCode('ü'.charCodeAt(0) - 128)
+ String.fromCharCode('ß'.charCodeAt(0) - 128) + '~F4e';
Exemple
Méthodes
Méthodes de BakeryCode128
-
start={
start } — Spécifie par quelle table doit commencer le code-barres -
tilde={
tilde } — Modifie le fonctionnement du caractère tilde ~
Méthodes de BakeryBarcode1D
-
thickness={
thickness } — Spécifie l'épaisseur du code-barres -
label={
label } — Spécifie le texte qui accompagne le code-barres -
font={
font } — Spécifie la police du texte qui accompagne le code-barres -
displayChecksum={
display } — Spécifie que le chiffre de vérification soit ajouté au texte qui accompagne le code-barres
Méthodes de BakeryBarcode
-
text={
text } — Analyse un messagetext pour dessiner par la suite -
scale={
scale } — Fixe la résolution du code-barres -
foregroundColor={
color } — Fixe la couleur des barres -
backgroundColor={
color } — Fixe la couleur des espaces -
offsetX={
value } — Spécifie le décalage en X -
offsetY={
value } — Spécifie le décalage en Y
Exemple de Code
import { BakeryColor, BakeryFont } from '@barcode-bakery/barcode-react';
import { BakeryCode128 } from '@barcode-bakery/barcode-react/1d';
export default function Home() {
const font = new BakeryFont('Arial', 18);
const colorBlack = new BakeryColor(0, 0, 0);
const colorWhite = new BakeryColor(255, 255, 255);
return <BakeryCode128
scale={2}
thickness={30}
foregroundColor={colorBlack}
backgroundColor={colorWhite}
font={font}
text='a123'
>;
}
Explications des Méthodes
-
start={
start } — Spécifie par quelle table doit commencer le code-barresDescriptionL'argument peut être A, B, C ou null. Cela signifie par quelle table doit commencer le code-barres.
La valeur par défaut est null.
Cela signifie que la table sera automatiquement choisie lorsque vous fournissez le texte.
Les tables comportent différents caractères qui peuvent être encodés dans le code-barres.
Référez-vous à l'introduction de ce document pour obtenir plus d'informations. -
tilde={
tilde } — Modifie le fonctionnement du caractère tilde ~DescriptionEn mettanttrue à 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.
-
thickness={
thickness } — Spécifie l'épaisseur du code-barresDescriptionL'épaisseur du code-barres est en pixel. Il s'agit de la grandeur verticale. -
label={
label } — Spécifie le texte qui accompagne le code-barresDescriptionLe texte sera écrit au dessous ou au dessus du code-barres dépendamment de celui-ci. Vous pouvez écrire la valeur spécialeBakeryBarcode1D.Label si vous souhaitez que le texte soit automatiquement choisi. Il sera alors la valeur du texte passé à la méthodetext={} . -
font={
font } — Spécifie la police du texte qui accompagne le code-barresDescriptionLa valeur de l'argument peut être soit une instance de la classeBakeryFontFile . -
displayChecksum={
display } — Spécifie que le chiffre de vérification soit ajouté au texte qui accompagne le code-barresDescriptionSpécifiertrue ajoutera le chiffre de vérification au texte qui accompagne le code-barres par défaut.
La valeur par défaut est true.
-
text={
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. -
scale={
scale } — Fixe la résolution du code-barresDescriptionLe code-barres serax fois plus grand. Un pixel sera alors de taillex parx . -
foregroundColor={
color } — Fixe la couleur des barresDescriptionLa couleur des barres du code-barres. Par défaut, la couleur est noire. L'argument peut être soit une classeBakeryColor ou n'importe quel autre argument que la classeBakeryColor peut accepter à son constructeur. -
backgroundColor={
color } — Fixe la couleur des espacesDescriptionLa couleur des espaces du code-barres. Par défaut, la couleur est blanche. L'argument peut être soit une classeBakeryColor ou n'importe quel autre argument que la classeBakeryColor peut accepter à son constructeur. -
offsetX={
value } — Spécifie le décalage en XDescriptionSpécifie le décalage en X du code-barres en pixel multiplié par la résolution. -
offsetY={
value } — Spécifie le décalage en YDescriptionSpécifie le décalage en Y du code-barres en pixel multiplié par la résolution.