Le code GS1-128 est une normalisation des standards du GS1 basé sur le code 128. Ce code est un standard international permettant l'échange de données entre producteurs et distributeurs. Le GS1-128 doit commencer par la fonction 1 (~F1). Il peut contenir plusieurs identifiants, il ne doit cependant pas dépasser 48 caractères, cette limite exclut le caractère obligatoire ~F1. Afin de faciliter la lecture, les identifiants sont entourés de parenthèses dans le texte qui accompagne le code barre; ces parenthèses ne sont pas encodées dans le code barre.

Il existe différentes façons d'envoyer le contenu de votre code barre à la méthode parse(), par exemple, le code suivant :

(01)12345678912343(92)123(15)880422

peut être encodé comme suit

• Une chaine formatée :
  parse('(01)12345678912343(92)123~F1(15)880422')
• Une chaine non formatée :
  parse('011234567891234392123~F115880422')
• Un tableau simple formaté :
  parse(array('(01)12345678912343', '(92)123', '(15)880422'))
• Un tableau simple mixte :
  parse(array('0112345678912343', '(92)123~F15880422'))
• Un tableau double contenant des couples (ID, CONTENU)
  parse(array(array('01', '12345678912343'), array('92', '123'), array('15', '880422')))

* Note sur ~F1 : Si vous envoyez votre contenu dans une chaine, vous devez ajouter un séparateur à la fin de votre identifiant si ce dernier ne couvre pas le maximum et qu'il n'est pas positionné à la fin du code.

Si vous n'avez pas indiqué de checksum dans votre contenu et que ce dernier est obligatoire, il sera calculé automatiquement,
ex: parse('011234567891234') donnera : (01)1234567891234 3

Il existe deux standards pour le GS1-128, le mode strict et le mode legacy. En mode legacy, des séparateurs seront ajoutés entre chaque identifiant. En mode strict, des séparateurs seront ajoutés que si le contenu de l'identifiant ne couvre pas le maximum autorisé. Dans ce dernier mode, il est fortement recommandé d'utiliser la table C si vous n'utilisez que des chiffres dans le code barre. Voici un exemple afin de mieux comprendre la différence entre ces deux modes :

Mode Legacy :
(01)contenu de taille fixe [Séparateur] (91)contenu de taille variable [Séparateur] (8020)contenu de taille variable

Mode Strict :
(01)contenu de taille fixe (91)contenu de taille variable [Séparateur *] (8020)contenu de taille variable

* L'identifiant 91 doit comporter entre 1 et 30 caractères. Si ce dernier comporte 30 caractères, il n'y a aucun séparateur qui sera ajouté.

Liste des identifiants :

• __construct($start = NULL) — Spécifie par quelle table doit commencer le code barre
• setStrictMode($mode) — Spécifie quel mode à utiliser pour générer le code barre

• __construct($start = NULL) — Spécifie par quelle table doit commencer le code barre
• setStart($start) — Spécifie par quelle table doit commencer le code barre
• setTilde($tilde) — Spécifie si le tilde ~ doit être traité

• setThickness($thickness) — Spécifie l'épaisseur du code barre
• getThickness() — Retourne l'épaisseur du code barre
• setLabel($label) — Spécifie le texte qui accompagne le code barre
• getLabel() — Retourne le texte qui accompagne le code barre
• setFont($font) — Spécifie la police du texte qui accompagne le code barre

• parse($text) — Analyse un message $text pour dessiner par la suite
• draw($im) — Dessine le code barre sur l'image $im
• getMaxSize() — Retourne un tableau concernant la taille de l'image requise
• getScale() — Retourne la résolution du code barre
• setScale($x) — Fixe la résolution du code barre
• setForegroundColor($color) — Fixe la couleur du code barre
• setBackgroundColor($color) — Fixe la couleur du fond
• setColor($fg, $bg) — Fixe la couleur du code barre et de fond
• setOffsetX($v) — Spécifie le décalage en X
• setOffsetY($v) — Spécifie le décalage en Y