Manuel - DataMatrix
Introduction
Le code Datamatrix fait partie de la famille des codes-barres en 2D. Il permet d'encoder beaucoup d'information en un seul code-barres.
Tous les caractères ASCII de 0 à 255 sont supportés. La taille du code sera déterminée en fonction du nombre de données entrées. Le niveau d'erreur est choisi automatiquement.
Il est possible de passer en mode ECI avec la fonction acceptECI={}.
Cette classe hérite de la classe BakeryBarcode2D.
Exemple
![](/images/datamatrix/example.png)
Méthodes
Méthodes de BakeryDatamatrix
-
size={
value } — Fixe la taille du code-barres -
datamatrixSize={[
row ,col ]} — Spécifie une taille à utiliser pour le code-barres -
quietZone={
quietZoneSize } — Spécifie de dessiner une zone muette autour du code-barres -
tilde={
accept } — Modifie le fonctionnement du caractère tilde ~ -
acceptECI={
accept } — Spécifie d'accepter les codes ECI -
fnc1={
fnc1Type } — Transforme votre code-barres en standard GS1 ou AIM -
encoding={
encoding } — Spécifie un encodage spécifique -
macro={
macro } — Spécifie de préfixer et de rajouter un suffixe à vos données
Méthodes de BakeryBarcode2D
-
scaleX={
scaleX } — Spécifie la résolution du codes-barres en X -
scaleY={
scaleY } — Spécifie la résolution du codes-barres en Y
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 { BakeryDatamatrix } from '@barcode-bakery/barcode-react/datamatrix';
export default function Home() {
const colorBlack = new BakeryColor(0, 0, 0);
const colorWhite = new BakeryColor(255, 255, 255);
return <BakeryDatamatrix
scale={2}
foregroundColor={colorBlack}
backgroundColor={colorWhite}
text='Datamatrix'
>;
}
Explications des Méthodes
-
size={
value } — Fixe la taille du code-barresDescriptionLa taille du code-barres finale sera décidée automatiquement dépendamment du nombre de données que vous avez spécifié.
Cependant, vous pouvez spécifier une valeur afin d'obtenir un code différent. Voici les valeurs possibles :
-BakeryDatamatrix.Size.Smallest : Le code sera le plus petit possible
-BakeryDatamatrix.Size.Square : Le code sera un carré
-BakeryDatamatrix.Size.Rectangle : Le code sera un rectangle
La valeur par défaut estBakeryDatamatrix.Size.Square . -
datamatrixSize={[
row ,col ]} — Spécifie une taille à utiliser pour le code-barresDescriptionBarcode Bakery générera le plus petit code-barres basé sur les informations que vous fournissez.
Si vous souhaitez avoir une taille spécifique, vous pouvez la forcer avec cette méthode.
Vous devez spécifier une taille valide ou cette méthode génèrera une exception.
La valeur par défaut est -1. -
quietZone={
quietZoneSize } — Spécifie de dessiner une zone muette autour du code-barresDescriptionRetourne si la zone muette sera dessinée. -
tilde={
accept } — 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
- ~F : Écrit le caractère FNC1
La valeur par défaut est false.
Veuillez noter qu'il est possible d'utiliser ~F en tant que premier caractère de vos données, CEPENDANT il est possible que la sélection automatique d'encodage change le sens de votre code-barres en ne commençant pas vos données par un FNC1. C'est pourquoi nous vous recommandons d'utiliser la méthodefnc1={} et d'abandonner le premier caractère ~F de vos données. -
acceptECI={
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. -
fnc1={
fnc1Type } — Transforme votre code-barres en standard GS1 ou AIMDescriptionCette méthode transformera votre code-barres pour accepter les FNC1 pour être au standard GS1 ou au standard AIM.
BakeryDatamatrix.Fnc1.None : Le code ne suivra aucun standard.
BakeryDatamatrix.Fnc1.Gs1 : Le code suivra le standard GS1. Séparez les identifiants GS1 par des ~F. N'oubliez pas d'activertilde={} .
BakeryDatamatrix.Fnc1.Aim : Le code suivra le standard AIM.
La valeur par défaut estBakeryDatamatrix.Fnc1.None .
-
encoding={
encoding } — Spécifie un encodage spécifiqueDescriptionVous pouvez forcer l'encodage à être utilisé pour différentes raisons. Certains lecteurs ne sont pas capables de lire un encodage spécifique, alors vous pouvez forcer le mode ASCII.
Notez que si vous forcez un encodage, vous n'obtiendrez pas un résultat efficace. De plus, certains caractères ne sont pas représentables dans certains encodages.
Voyez la page information technique pour de plus amples informations à propos des encodages.
-BakeryDatamatrix.Encoding.Unknown : Aucun encodage spécifique n'est sélectionné
-BakeryDatamatrix.Encoding.Ascii : ASCII et ASCII étendu (basse compression)
-BakeryDatamatrix.Encoding.C40 : Encodage C40 (majuscules)
-BakeryDatamatrix.Encoding.Text : Encodage TEXT (minuscules)
-BakeryDatamatrix.Encoding.X12 : Encodage X12 (majuscules et chiffres)
-BakeryDatamatrix.Encoding.Edifact : Encodage Edifact
-BakeryDatamatrix.Encoding.Base256 : Encodage binaire
La valeur par défaut estBakeryDatamatrix.Encoding.Unknown . -
macro={
macro } — Spécifie de préfixer et de rajouter un suffixe à vos donnéesDescriptionLe macro a été défini pour permettre de rendre vos données et votre code-barres plus petit. Utilisez cette méthode pour préfixer et ajouter un suffixe à vos données lorsque votre code-barres est lu.
-BakeryDatamatrix.Macro.None : Vos données apparaîtront brutes. Aucun préfixe ni suffixe.
-BakeryDatamatrix.Macro._05 : Préfixe : [)>RS05GS - Suffixe : RSEoT
-BakeryDatamatrix.Macro._06 : Préfixe : [)>RS06GS - Suffixe : RSEoT
La valeur par défaut estBakeryDatamatrix.Macro.None .
-
scaleX={
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). -
scaleY={
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).
-
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.