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

Méthodes de BakeryBarcode

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-barres
    Description
    L'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 ~
    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.
  • thickness={thickness} — Spécifie l'épaisseur du code-barres
    Description
    L'épaisseur du code-barres est en pixel. Il s'agit de la grandeur verticale.
  • label={label} — Spécifie le texte qui accompagne le code-barres
    Description
    Le texte sera écrit au dessous ou au dessus du code-barres dépendamment de celui-ci. Vous pouvez écrire la valeur spéciale BakeryBarcode1D.Label si vous souhaitez que le texte soit automatiquement choisi. Il sera alors la valeur du texte passé à la méthode text={}.
  • font={font} — Spécifie la police du texte qui accompagne le code-barres
    Description
    La valeur de l'argument peut être soit une instance de la classe BakeryFontFile.
  • displayChecksum={display} — Spécifie que le chiffre de vérification soit ajouté au texte qui accompagne le code-barres
    Description
    Spécifier true 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 message text pour dessiner par la suite
    Description
    Les données que vous passez à l'argument text 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-barres
    Description
    Le code-barres sera x fois plus grand. Un pixel sera alors de taille x par x.
  • foregroundColor={color} — Fixe la couleur des barres
    Description
    La couleur des barres du code-barres. Par défaut, la couleur est noire. L'argument peut être soit une classe BakeryColor ou n'importe quel autre argument que la classe BakeryColor peut accepter à son constructeur.
  • backgroundColor={color} — Fixe la couleur des espaces
    Description
    La couleur des espaces du code-barres. Par défaut, la couleur est blanche. L'argument peut être soit une classe BakeryColor ou n'importe quel autre argument que la classe BakeryColor peut accepter à son constructeur.
  • offsetX={value} — Spécifie le décalage en X
    Description
    Spécifie le décalage en X du code-barres en pixel multiplié par la résolution.
  • offsetY={value} — Spécifie le décalage en Y
    Description
    Spécifie le décalage en Y du code-barres en pixel multiplié par la résolution.