← Modification précédente Modification suivante →

Version du 20 octobre 2025 à 13:47

📖 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.

Autres ressources

ASCII art in one lin https://1lineart.kulaone.com/

image-to-ascii https://github.com/IonicaBizau/image-to-ascii

Convert ASCII art diagrams into SVG. https://github.com/martinthomson/aasvg

générateur texte ascii http://www.network-science.de/ascii/

@@ Ligne 1 : / Ligne 1 : @@
+= 📖 Guide complet : <code>img2txt</code> avec <code>caca-utils</code> =
+<code>img2txt</code> 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 ==
+{| class="wikitable"
+|-
+! '''Commande'''
+! '''Options clés'''
+! '''Effet principal'''
+! '''Usage recommandé'''
+|-
+| <html>img2txt -W 100 -x 1 -y 2 picture.png > picture.txt</html>
+| <code>-W 100</code>, <code>-x 1</code>, <code>-y 2</code>
+| Conversion simple en ASCII
+| Obtenir un rendu basique sans couleurs
+|-
+| <html>img2txt -W 100 -x 1 -y 2 -f ansi picture.png | sed -r 's/\x1B\[[0-9;]*[mK]//g' > picture.txt</html>
+| <code>-f ansi</code>, <code>sed</code>
+| Conversion ANSI + suppression des codes
+| Fichier texte brut sans couleurs
+|-
+| <html>img2txt -W 150 -x 1 -y 2 -d fstein -b 0.5 -c 1.5 -g 1.2 -f ansi picture.png > picture.txt</html>
+| <code>-d fstein</code>, <code>-b</code>, <code>-c</code>, <code>-g</code>
+| Conversion avancée avec dithering et ajustements
+| Rendu optimisé avec couleurs
+|-
+| <html>img2txt -W 150 -x 1 -y 2 -d fstein -f ansi picture.png | sed -r 's/\x1B\[[0-9;]*[mK]//g' > picture.txt</html>
+| <code>-d fstein</code>, <code>-f ansi</code>, <code>sed</code>
+| Dithering sans ajustements + suppression ANSI
+| Fichier brut avec rendu amélioré
+|-
+| <html>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</html>
+| <code>-d fstein</code>, <code>-b</code>, <code>-c</code>, <code>-g</code>, <code>sed</code>
+| Conversion avancée + suppression ANSI
+| Fichier brut optimisé sans couleurs
+|}
+-----
+== ✅ Détails des commandes ==
+=== 1. '''Conversion simple en ASCII''' ===
+<syntaxhighlight lang="bash">img2txt -W 100 -x 1 -y 2 picture.png > picture.txt</syntaxhighlight>
+* '''Usage''' : rapide, sans couleurs.
+* '''Options''' :
+** <code>-W 100</code> : largeur en caractères.
+** <code>-x 1 -y 2</code> : ratio horizontal/vertical.
+-----
+=== 2. '''Conversion ANSI + suppression des codes''' ===
+<syntaxhighlight lang="bash">img2txt -W 100 -x 1 -y 2 -f ansi picture.png | sed -r 's/\x1B\[[0-9;]*[mK]//g' > picture.txt</syntaxhighlight>
+* '''Usage''' : fichier brut sans séquences ANSI.
+* '''Options''' :
+** <code>-f ansi</code> : sortie colorée.
+** <code>sed</code> : supprime les codes ANSI.
+-----
+=== 3. '''Conversion avancée avec dithering et ajustements''' ===
+<syntaxhighlight lang="bash">img2txt -W 150 -x 1 -y 2 -d fstein -b 0.5 -c 1.5 -g 1.2 -f ansi picture.png > picture.txt</syntaxhighlight>
+* '''Usage''' : rendu optimisé avec couleurs.
+* '''Options''' :
+** <code>-d fstein</code> : dithering Floyd-Steinberg.
+** <code>-b</code>, <code>-c</code>, <code>-g</code> : luminosité, contraste, gamma.
+-----
+=== 4. '''Dithering sans ajustements + suppression ANSI''' ===
+<syntaxhighlight lang="bash">img2txt -W 150 -x 1 -y 2 -d fstein -f ansi picture.png | sed -r 's/\x1B\[[0-9;]*[mK]//g' > picture.txt</syntaxhighlight>
+* '''Usage''' : fichier brut avec rendu amélioré.
+* '''Options''' :
+** <code>-d fstein</code> : dithering.
+** <code>sed</code> : supprime les couleurs ANSI.
+-----
+=== 5. '''Conversion avancée + suppression ANSI''' ===
+<syntaxhighlight lang="bash">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</syntaxhighlight>
+* '''Usage''' : fichier brut optimisé sans couleurs.
+* '''Options''' :
+** Combinaison des ajustements + suppression ANSI.
+-----
+== 🔑 Astuces pratiques ==
+* '''Pour un rendu coloré dans le terminal''' : utilisez <code>-f ansi</code> sans <code>sed</code>.
+* '''Pour un fichier texte brut''' : ajoutez le filtre <code>sed</code>.
+* '''Pour un rendu plus réaliste''' : activez <code>-d fstein</code> et ajustez <code>-b</code>, <code>-c</code>, <code>-g</code>.
+-----
+= '''Autres ressources''' =
 <code>
 ASCII art in one lin<br />