« Ascii » : différence entre les versions
Aucun résumé des modifications |
Aucun résumé des modifications |
||
| 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> | <code> | ||
ASCII art in one lin<br /> | ASCII art in one lin<br /> | ||