Texte et outils quotidiens · Boîte à outils QR et codes-barres
Comment se construit un code QR : du texte aux modules en noir et blanc
· Comment ça marche
code QR codage traitement du navigateur
Suit une URL courte à chaque étape du codage QR (sélection du mode, correction des erreurs, placement, masquage) afin que la grille en noir et blanc cesse de ressembler à du bruit.
La grille qui semble aléatoire mais ne l'est pas : pourquoi la même URL produit toujours le même code et à quoi sert chaque région du carré
La grille est constituée de données structurées, pas de bruit décoratif. ToolAcre reçoit le même texte, utilise le même choix de correction d'erreur et renvoie la même matrice de module booléen, y compris les trois régions de recherche que ses tests inspectent dans les coins.
Cette répétabilité est utile lors de la révision. Si deux exportations à partir d'un texte et de paramètres identiques diffèrent, étudiez la saisie, le sélecteur de correction ou le chemin de rendu plutôt que d'accepter la variation visuelle comme inoffensive. Les tests évitent de comparer une image dorée et fragile ; ils affirment un tableau booléen carré, des dimensions valides et les trois modèles de recherche. Ces vérifications séparent la structure codée des choix ultérieurs tels que la couleur, la largeur de la zone silencieuse et l'échelle de sortie.
Étape 1 : ToolAcre utilise délibérément le mode UTF-8 octet plutôt que de choisir parmi quatre modes
L'en-tête du classeur suggère un encodeur qui choisit le mode numérique, alphanumérique, octet ou kanji. Ce n'est pas le cas de cette implémentation : elle pré-code délibérément chaque charge utile avec TextEncoder et transmet ces UTF-8 octets via la bibliothèque QR en mode octet.
Ce chemin fixe évite un bogue de dépendance silencieux. La bibliothèque QR importée traiterait autrement les caractères JavaScript comme des octets Latin-1, de sorte que café pourrait contenir un octet E9 au lieu de la paire UTF-8 C3 A9, tandis qu'un caractère japonais pourrait se réduire à des données sans rapport. ToolAcre convertit en morceaux avant d'appeler la bibliothèque, évitant ainsi les limites de nombre d'arguments sur des charges utiles plus importantes et évitant un correctif global de singe qui pourrait affecter un autre appelant.
Étape 2 : choix d'une version et d'un niveau de correction d'erreurs — comment la longueur du texte et le niveau choisi fixent la taille de la grille à partir de 21×21 vers le haut
La bibliothèque choisit automatiquement la plus petite version QR qui correspond aux octets au niveau de correction sélectionné. ToolAcre vérifie que les matrices valides se développent selon les étapes standard de quatre modules, de 21 modules par côté jusqu'au plafond implémenté de 177.
Le niveau sélectionné modifie à la fois la capacité en octets disponible et la version requise pour une charge utile. Le panneau mesure la charge utile préparée avec TextEncoder, la compare au plafond configuré pour ce niveau et affiche les deux chiffres à côté de l'aperçu. Si la bibliothèque ne peut pas correspondre à la valeur, l'utilisateur reçoit une instruction pour la raccourcir ou réduire la correction au lieu d'un aperçu vide ou d'une matrice manquant silencieusement des octets de fin.
Étape 3 : la bibliothèque QR ajoute des données de correction d'erreurs en interne ; ToolAcre expose le niveau choisi
ToolAcre expose L, M, Q et H comme choix, mais la construction du bloc Reed-Solomon réside dans la dépendance du générateur de code qrcode. L’affirmation défendable est que la sélection d’un niveau plus élevé peut produire une matrice plus grande pour un contenu identique, comme le démontrent les tests.
Les tests structurels rendent cette frontière observable sans revendiquer la propriété des mathématiques à l'intérieur de la dépendance. Une matrice générée doit avoir des lignes et des colonnes de même longueur, des dimensions suivant la progression 21, 25, 29 et des formes de recherche de bordure sombre, d'anneau clair et de centre sombre. Un bug du moteur de rendu peut alors être diagnostiqué séparément : si la matrice booléenne réussit mais qu'une exportation échoue, le problème se situe après l'encodage plutôt que dans la charge utile ou les données de correction.
Étape 4 : modèles de fonction – modèles de recherche, de séparateur, de synchronisation et d'alignement, ainsi que la bande d'informations sur le format
Les modèles de recherche, les structures de synchronisation et autres régions réservées sont déjà présents lorsque la bibliothèque renvoie sa matrice. ToolAcre convertit ce résultat en booléens majeurs de ligne et teste les trois chercheurs de coins 7-by-7 au lieu de réimplémenter ces structures lui-même.
L'application contrôle toujours la manière dont cette matrice vérifiée atteint un fichier. La sortie SVG fusionne les modules sombres adjacents dans chaque ligne en tracés de chemin, réduisant ainsi le balisage tout en gardant les bords voisins exacts. La sortie Canvas peint un rectangle de pixels entiers pour chaque cellule sombre. Les deux chemins ajoutent la zone calme choisie autour plutôt qu'à l'intérieur de la matrice, de sorte que la modification de la marge ou de la couleur ne peut pas modifier la charge utile codée.
Étape 5 : le masquage matriciel est géré dans la bibliothèque QR plutôt que sélectionné par le code ToolAcre
La sélection de masque appartient également à la dépendance, donc cet article ne prétend pas que ToolAcre contient une boucle de notation visible de huit candidats. Ce que possède l'application, c'est l'interface matricielle stable et le chemin de rendu qui consomme ses modules clairs et sombres.
Cette limite est importante lors du débogage d'un code dont l'apparence vous surprend. ToolAcre ne peut pas révéler lequel des masques candidats de la dépendance a gagné ni reproduire un score de pénalité dans l'interface ; il peut reproduire le tableau de modules final pour les mêmes entrées. Comparer des tableaux est donc significatif, tandis qu'expliquer un patch particulier de cellules alternées comme un masque sélectionné à la main irait au-delà de ce que ce code enregistre.
Exemple concret : comparez la charge utile UTF-8 observable, la taille de la matrice et les modules rendus
Essayez une URL de menu courte, notez le nombre de modules renvoyés, puis ajoutez une longue chaîne de requête. La leçon observable est que plus de UTF-8 octets peuvent nécessiter une matrice plus dense ; le référentiel n'expose pas de chaînes de bits intermédiaires ou de mots de passe pour un calcul manuel.
Pour une comparaison utile, maintenez le niveau M et les couleurs constants, puis générez `https://example.com/menu` et la même adresse avec une valeur de requête longue. Enregistrez le compteur d'octets et les dimensions de la matrice affichées par le panneau. La deuxième entrée peut franchir une limite de version même si les deux constituent « une seule URL ». La différence vient des octets codés, et non du nombre de mots ou de la longueur apparente de la page de destination.
Ce qu'il faut retenir : l'encodage est local, tandis que l'activité réseau au niveau de la page doit être évaluée séparément.
L'opération de transfert de charge utile vers la matrice est effectuée par le navigateur JavaScript, et le rendu SVG ou PNG utilise cette matrice en mémoire. C'est plus restrictif que de prétendre que la page entière est silencieuse sur le réseau : le déploiement peut charger des ressources de page non liées, alors inspectez les demandes avant d'utiliser des secrets.
La revendication étroite de confidentialité peut également être testée sans se fier aux copies marketing. Effacez les outils de développement, entrez une chaîne inoffensive distinctive et générez le code, puis recherchez de nouvelles URL et corps de requête pour cette chaîne. Les fonctions d'encodage ne contiennent aucun appel d'extraction, mais le test doit quand même être effectué sur la page déployée car les styles, analyses ou extensions sont distincts de l'implémentation de la charge utile vers la matrice examinée ici.