📖 Guide complet : `img2txt` avec `caca-utils`

img2txt est un outil de la suite caca-utils qui convertit des images en texte ASCII ou ANSI pour affichage dans un terminal ou export en fichier. Ce guide présente 5 commandes courantes, leurs options et leurs usages.

🔍 Tableau comparatif des commandes

Commande	Options clés	Effet principal	Usage recommandé
img2txt -W 100 -x 1 -y 2 picture.png > picture.txt	`-W 100`, `-x 1`, `-y 2`	Conversion simple en ASCII	Obtenir un rendu basique sans couleurs
img2txt -W 100 -x 1 -y 2 -f ansi picture.png \| sed -r 's/\x1B\[[0-9;]*[mK]//g' > picture.txt	`-f ansi`, `sed`	Conversion ANSI + suppression des codes	Fichier texte brut sans couleurs
img2txt -W 150 -x 1 -y 2 -d fstein -b 0.5 -c 1.5 -g 1.2 -f ansi picture.png > picture.txt	`-d fstein`, `-b`, `-c`, `-g`	Conversion avancée avec dithering et ajustements	Rendu optimisé avec couleurs
img2txt -W 150 -x 1 -y 2 -d fstein -f ansi picture.png \| sed -r 's/\x1B\[[0-9;]*[mK]//g' > picture.txt	`-d fstein`, `-f ansi`, `sed`	Dithering sans ajustements + suppression ANSI	Fichier brut avec rendu amélioré
img2txt -W 150 -x 1 -y 2 -d fstein -b 0.5 -c 1.5 -g 1.2 -f ansi picture.png \| sed -r 's/\x1B\[[0-9;]*[mK]//g' > picture.txt	`-d fstein`, `-b`, `-c`, `-g`, `sed`	Conversion avancée + suppression ANSI	Fichier brut optimisé sans couleurs

✅ Détails des commandes

1. Conversion simple en ASCII

img2txt -W 100 -x 1 -y 2 picture.png > picture.txt

Usage : rapide, sans couleurs.
Options :
- -W 100 : largeur en caractères.
- -x 1 -y 2 : ratio horizontal/vertical.

2. Conversion ANSI + suppression des codes

img2txt -W 100 -x 1 -y 2 -f ansi picture.png | sed -r 's/\x1B\[[0-9;]*[mK]//g' > picture.txt

Usage : fichier brut sans séquences ANSI.
Options :
- -f ansi : sortie colorée.
- sed : supprime les codes ANSI.

3. Conversion avancée avec dithering et ajustements

img2txt -W 150 -x 1 -y 2 -d fstein -b 0.5 -c 1.5 -g 1.2 -f ansi picture.png > picture.txt

Usage : rendu optimisé avec couleurs.
Options :
- -d fstein : dithering Floyd-Steinberg.
- -b, -c, -g : luminosité, contraste, gamma.

4. Dithering sans ajustements + suppression ANSI

img2txt -W 150 -x 1 -y 2 -d fstein -f ansi picture.png | sed -r 's/\x1B\[[0-9;]*[mK]//g' > picture.txt

Usage : fichier brut avec rendu amélioré.
Options :
- -d fstein : dithering.
- sed : supprime les couleurs ANSI.

5. Conversion avancée + suppression ANSI

img2txt -W 150 -x 1 -y 2 -d fstein -b 0.5 -c 1.5 -g 1.2 -f ansi picture.png | sed -r 's/\x1B\[[0-9;]*[mK]//g' > picture.txt

Usage : fichier brut optimisé sans couleurs.
Options :
- Combinaison des ajustements + suppression ANSI.

🔑 Astuces pratiques

Pour un rendu coloré dans le terminal : utilisez -f ansi sans sed.
Pour un fichier texte brut : ajoutez le filtre sed.
Pour un rendu plus réaliste : activez -d fstein et ajustez -b, -c, -g.