Convertissez la luminosité d’une image en art ASCII

Indiquez des entiers allant de 0 pour le noir à 255 pour le blanc, puis choisissez une gamme de caractères classée du plus sombre au plus clair. Le convertisseur associe chaque échantillon à la position la plus proche dans cette gamme et conserve la grille sous forme de lignes de texte. Il convient aux aperçus dans un terminal, aux afficheurs textuels, à la programmation créative, à l’enseignement du traitement d’image et aux chaînes qui calculent déjà des moyennes de pixels ou de cellules.

Préparez une grille de luminosité adaptée

Commencez par un tableau rectangulaire dans lequel chaque tableau interne représente une ligne de sortie et chaque valeur une cellule de caractère. Les échantillons doivent être des entiers compris entre 0 et 255 : 0 correspond au noir complet, 255 au blanc complet et les valeurs intermédiaires aux différents gris. Si votre source est une photographie en pleine résolution, réduisez-la avant d’appeler le convertisseur. Calculez la moyenne d’un bloc de pixels pour chaque position de caractère, car transformer chaque pixel en caractère produit généralement un résultat immense et amplifie la différence de proportions entre pixels et glyphes. Toutes les lignes doivent conserver la même longueur. Pour un aperçu dans un terminal, 40 à 120 colonnes et un nombre de lignes inférieur constituent souvent un bon choix, les caractères étant généralement plus hauts que larges. L’entrée sous forme de luminosités vous laisse maîtriser en amont le redimensionnement, le recadrage, les couleurs, la transparence et le contraste. Une fois ces choix fixés, une même grille donne toujours le même texte.

Choisissez et comprenez la gamme ASCII

Saisissez la gamme en partant du caractère destiné à l’échantillon le plus sombre et en terminant par celui du plus clair. Une suite telle que <code>@%#*+=-:. </code> passe de signes visuellement denses à une espace finale : les zones noires deviennent marquées tandis que les zones blanches se fondent dans le fond. Inversez cet ordre pour une représentation claire sur fond sombre, ou utilisez <code>#.</code> pour obtenir deux tons très contrastés. Chaque caractère Unicode occupe une position, y compris les espaces et les emoji, même si les caractères ordinaires à chasse fixe assurent un alignement plus fiable. Pour chaque échantillon, le convertisseur répartit l’intervalle 0–255 sur les positions disponibles puis choisit la plus proche. Les extrémités sont exactes : 0 sélectionne toujours le premier caractère et 255 le dernier. Les répétitions sont autorisées afin d’élargir volontairement une plage tonale. Une gamme vide est refusée. Une espace finale reste significative, même si elle se voit mal dans un formulaire ou un lecteur JSON.

Exploitez le texte et les métadonnées

Le résultat contient <code>art</code>, une chaîne unique séparée par des retours à la ligne et directement utilisable dans un terminal, un fichier texte, un journal ou un bloc de code. Il fournit aussi <code>lines</code> sous forme de tableau, ce qui simplifie l’ajout d’une indentation, de bordures, de couleurs ANSI ou de numéros de ligne sans devoir redécouper le texte. Les nombres de lignes et de colonnes permettent de contrôler les dimensions avant l’affichage ou l’enregistrement, tandis que <code>ramp_length</code> indique combien de caractères Unicode ont participé à la conversion. Aucun tramage aléatoire n’est appliqué : avec une gamme courte, des luminosités voisines peuvent donc partager le même caractère. Ce comportement est volontaire et reproductible. Pour obtenir un tramage, préparez d’abord la grille avec une diffusion d’erreur déterministe ou une matrice ordonnée. Affichez l’art dans une police à chasse fixe et préservez les espaces. En HTML, insérez-le comme texte dans un élément préformaté, jamais comme balisage, notamment si la gamme contient des chevrons ou des esperluettes.