← Tous les guides FaintType

Résolution des problèmes

Pourquoi la mesure du contraste varie autour d’un même texte dans une capture

Comment l’anticrénelage, la mise à l’échelle, la compression, les limites de l’OCR et les fonds hétérogènes peuvent modifier une estimation sans changer les couleurs prévues dans la maquette.

Publié le Mis à jour le

Choisissez une couleur de texte sombre et un fond clair dans un outil de conception : le calcul du contraste est simple. Mesurez le même texte dans une capture et des dizaines de couleurs intermédiaires apparaissent au bord des caractères. Une seule ligne peut aussi traverser une ombre, un dégradé ou un bloc d’image compressée.

C’est pourquoi un outil d’analyse de captures et un calculateur fondé sur les tokens de design peuvent donner des résultats différents, même si leurs calculs sont corrects. La difficulté consiste à déterminer quels pixels affichés représentent le premier plan et lesquels représentent le fond.

L’anticrénelage crée des couleurs absentes de la palette

La rastérisation des polices mélange les pixels des contours avec le fond pour lisser les courbes et les diagonales. Prendre un pixel de bord comme couleur du texte donne un contraste plus faible que prélever au cœur du caractère. Cet équilibre varie avec l’échelle d’affichage, le rendu de la police et le redimensionnement de l’image.

FaintType recherche des pixels au cœur des caractères au lieu de traiter chaque pixel du rectangle OCR comme du texte. Il exclut aussi une fine bande près du bord de ce rectangle lors du choix des pixels susceptibles d’appartenir au premier plan. Cela réduit le risque de confondre une bordure de bouton voisine avec un caractère.

Un rectangle OCR indique une position, pas un masque des caractères

Apple Vision renvoie des observations de texte reconnu avec des zones englobantes normalisées et des niveaux de confiance. Le cadre d’une ligne comprend généralement les espaces entre les lettres et peut inclure des éléments décoratifs voisins. L’estimation des couleurs doit affiner cette zone approximative avant de comparer le premier plan et le fond.

FaintType prélève des échantillons dans la zone et dans un anneau voisin, regroupe les couleurs proches et sépare les composantes de caractères retenues du fond environnant. Si la reconnaissance fusionne des textes sans rapport ou manque un petit libellé, le cadre obtenu et l’estimation des couleurs peuvent malgré tout être erronés.

Une ligne peut avoir plusieurs fonds réels

Avec un dégradé, une photographie, un panneau translucide ou une ombre, il n’existe pas une seule couleur de fond derrière toute la ligne. FaintType estime un fond local pour les composantes de caractères retenues et résume les mesures par une valeur typique, une estimation locale plus faible et la part de surface atteignant le seuil.

Ces indicateurs répondent à des questions différentes. La valeur typique décrit la majeure partie du texte affiché ; l’estimation plus faible aide à repérer une portion vulnérable ; la couverture indique quelle proportion de la surface échantillonnée atteint le seuil WCAG sélectionné. Ne communiquez pas uniquement le chiffre le plus favorable lorsque la ligne traverse manifestement un fond changeant.

Examiner un résultat inattendu

Revenez à la capture dans sa taille d’origine, sélectionnez le résultat et comparez les échantillons de premier plan et de fond aux pixels surlignés. Vérifiez si l’image a été redimensionnée, recompressée ou prise avec une autre échelle d’affichage. Si le niveau de confiance est moyen ou faible, confirmez les couleurs dans la maquette source ou l’inspecteur du navigateur.

Une estimation devrait être reproductible pour les mêmes pixels. En revanche, après une transformation de ces pixels, elle n’a pas nécessairement à correspondre au calcul fondé sur les couleurs d’origine. Conservez l’export original lorsqu’une décision se joue près d’un seuil.