Converta la luminosità di un’immagine in arte ASCII

Fornisca numeri interi da 0 per il nero a 255 per il bianco, quindi scelga una scala di caratteri ordinata dal più scuro al più chiaro. Il convertitore associa ogni campione alla posizione più vicina della scala e conserva la griglia come righe di testo. È utile per anteprime nel terminale, renderer solo testo, programmazione creativa, lezioni di elaborazione delle immagini e flussi che calcolano già medie di pixel o celle.

Prepari una griglia di luminosità adatta

Inizi con un array rettangolare nel quale ogni array interno rappresenta una riga di output e ogni valore una cella di carattere. I campioni devono essere numeri interi compresi tra 0 e 255: 0 indica il buio completo, 255 la luminosità piena e i valori intermedi descrivono i diversi grigi. Se la sorgente è una fotografia ad alta risoluzione, la riduca prima di chiamare il convertitore. Calcoli la media di un blocco di pixel per ciascuna posizione di carattere, perché associare ogni pixel a un carattere produce spesso un risultato enorme e accentua le diverse proporzioni di pixel e glifi. Mantenga tutte le righe della stessa lunghezza. Un’anteprima da terminale può usare da 40 a 120 colonne e meno righe, dato che i caratteri sono normalmente più alti che larghi. Ricevendo dati di luminosità anziché un file, lo strumento Le lascia controllare prima ridimensionamento, ritaglio, colore, trasparenza e contrasto. Una volta fissate tali scelte, la stessa griglia genera sempre lo stesso testo.

Scelga e interpreti la scala ASCII

Scriva la scala partendo dal carattere destinato al campione più scuro e terminando con quello del più chiaro. Una sequenza come <code>@%#*+=-:. </code> passa da segni visivamente densi a uno spazio finale: le aree nere diventano simboli marcati e quelle bianche si confondono con lo sfondo. Invertendo l’ordine ottiene una resa chiara su fondo scuro; con <code>#.</code> crea invece un risultato netto a due toni. Ogni carattere Unicode conta come una posizione, inclusi spazi ed emoji, anche se i normali caratteri monospaziati garantiscono l’allineamento più prevedibile. Per ogni campione, il convertitore distribuisce l’intervallo 0–255 sulle posizioni disponibili e arrotonda alla più vicina. Gli estremi sono esatti: 0 seleziona sempre il primo carattere e 255 l’ultimo. È possibile ripetere caratteri per allargare intenzionalmente una fascia tonale. Una scala vuota viene rifiutata. Ricordi che uno spazio finale è significativo anche quando risulta difficile da vedere in un modulo o visualizzatore JSON.

Utilizzi il testo e i metadati restituiti

Il risultato include <code>art</code>, un’unica stringa separata da ritorni a capo e pronta per un terminale, un file di testo, un log o un blocco di codice. Include inoltre <code>lines</code> come array, più comodo quando un programma deve aggiungere rientri, bordi, colori ANSI o numeri di riga senza dividere nuovamente il testo. Il numero di righe e colonne consente di verificare le dimensioni prima della visualizzazione o dell’archiviazione, mentre <code>ramp_length</code> registra quanti caratteri Unicode sono stati usati. Non viene applicato dithering casuale, quindi luminosità vicine possono condividere un carattere quando la scala è breve. È un comportamento intenzionale e riproducibile. Se desidera il dithering, applichi prima una diffusione d’errore deterministica o una matrice ordinata e invii la griglia ottenuta. Per un allineamento fedele usi un font monospaziato e conservi gli spazi. In HTML inserisca il risultato come testo in un elemento preformattato, non come markup, soprattutto se la scala contiene parentesi angolari o e commerciali.