« 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> = | == 📖 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. | <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. | ||
| Ligne 6 : | Ligne 6 : | ||
----- | ----- | ||
== 🔍 Tableau comparatif des commandes == | === 🔍 Tableau comparatif des commandes === | ||
{| class="wikitable" | {| class="wikitable" | ||
| Ligne 44 : | Ligne 44 : | ||
----- | ----- | ||
== ✅ Détails des commandes == | === ✅ Détails des commandes === | ||
=== 1. '''Conversion simple en ASCII''' === | ==== 1. '''Conversion simple en ASCII''' ==== | ||
<syntaxhighlight lang="bash">img2txt -W 100 -x 1 -y 2 picture.png > picture.txt</syntaxhighlight> | <syntaxhighlight lang="bash">img2txt -W 100 -x 1 -y 2 picture.png > picture.txt</syntaxhighlight> | ||
| Ligne 57 : | Ligne 57 : | ||
----- | ----- | ||
=== 2. '''Conversion ANSI + suppression des codes''' === | ==== 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> | <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> | ||
| Ligne 68 : | Ligne 68 : | ||
----- | ----- | ||
=== 3. '''Conversion avancée avec dithering et ajustements''' === | ==== 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> | <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> | ||
| Ligne 79 : | Ligne 79 : | ||
----- | ----- | ||
=== 4. '''Dithering sans ajustements + suppression ANSI''' === | ==== 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> | <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> | ||
| Ligne 90 : | Ligne 90 : | ||
----- | ----- | ||
=== 5. '''Conversion avancée + suppression 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> | <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> | ||
| Ligne 100 : | Ligne 100 : | ||
----- | ----- | ||
== 🔑 Astuces pratiques == | === 🔑 Astuces pratiques === | ||
* '''Pour un rendu coloré dans le terminal''' : utilisez <code>-f ansi</code> sans <code>sed</code>. | * '''Pour un rendu coloré dans le terminal''' : utilisez <code>-f ansi</code> sans <code>sed</code>. | ||
| Ligne 106 : | Ligne 106 : | ||
* '''Pour un rendu plus réaliste''' : activez <code>-d fstein</code> et ajustez <code>-b</code>, <code>-c</code>, <code>-g</code>. | * '''Pour un rendu plus réaliste''' : activez <code>-d fstein</code> et ajustez <code>-b</code>, <code>-c</code>, <code>-g</code>. | ||
== 📖 <code>chafa</code> == | |||
=== 🖼️ <code>chafa</code> : Convertisseur d’images en ASCII pour le terminal === | |||
* Le paquet chafa sur Debian 13 (Trixie) est un outil en ligne de commande conçu pour convertir des images (y compris les GIF animés) en art ASCII ou Unicode affichable dans un terminal. | |||
* Il convertit les images bitmap en représentations textuelles adaptées à l’affichage dans les terminaux. Il prend en charge plusieurs formats d’image et offre une grande flexibilité dans le rendu ASCII ou Unicode. | |||
* Voici un aperçu de ses fonctionnalités et caractéristiques principales. | |||
----- | |||
=== 🔧 Installation sur Debian 13 === | |||
<syntaxhighlight lang="bash">sudo apt install chafa</syntaxhighlight> | |||
----- | |||
=== 💡 Exemple d’utilisation === | |||
Voici une commande qui convertit une image en ASCII pur, sans couleurs ni tramage, et l’enregistre dans un fichier texte : | |||
<syntaxhighlight lang="bash">chafa --format=symbols --colors=none --dither=none \ | |||
--symbols=ascii --size=200x \ | |||
picture.png > picture.txt</syntaxhighlight> | |||
📄 Cette commande : - utilise uniquement des symboles ASCII (<code>--symbols=ascii</code>) - désactive les couleurs (<code>--colors=none</code>) - désactive le tramage (<code>--dither=none</code>) - fixe la largeur à 200 caractères (<code>--size=200x</code>) - enregistre le résultat dans <code>picture.txt</code> | |||
----- | |||
== Comparaison entre les deux outils '''<code>chafa</code>''' et '''<code>img2txt</code>''' == | |||
=== 🔸 '''1. chafa''' === | |||
* '''Langage''' : C (librairie + CLI) | |||
* '''Fonctionnalités''' : | |||
** Supporte les images animées (GIF). | |||
** Utilise des caractères Unicode pour une meilleure qualité visuelle. | |||
** Plusieurs modes de sortie : <code>symbols</code>, <code>sixels</code>, <code>iterm</code>, <code>kitty</code>, etc. | |||
** Très configurable : alignement, transparence, optimisation, etc. | |||
** API C disponible pour intégration dans des projets. | |||
* '''Avantages''' : | |||
** Moderne, maintenu activement. | |||
** Compatible avec les terminaux récents. | |||
** Très rapide et efficace. | |||
* '''Inconvénients''' : | |||
** Moins simple que <code>img2txt</code> pour une utilisation ultra-basique. | |||
----- | |||
=== 🔸 '''2. img2txt''' (inclus dans le paquet <code>caca-utils</code>) === | |||
* '''Langage''' : C (basé sur la librairie <code>libcaca</code>) | |||
* '''Fonctionnalités''' : | |||
** Conversion d’images en ASCII simple. | |||
** Moins de support pour Unicode ou couleurs avancées. | |||
** Très léger et minimaliste. | |||
* '''Avantages''' : | |||
** Ultra simple à utiliser. | |||
** Suffisant pour des terminaux très basiques. | |||
* '''Inconvénients''' : | |||
** Moins de qualité visuelle. | |||
** Pas de support pour les images animées. | |||
** Moins de personnalisation. | |||
----- | |||
=== 🏆 '''Quel est le meilleur choix ?''' === | |||
{| class="wikitable" | |||
|- | |||
! Besoin | |||
! Choix recommandé | |||
|- | |||
| Qualité visuelle élevée | |||
| '''chafa''' | |||
|- | |||
| Support Unicode et couleurs | |||
| '''chafa''' | |||
|- | |||
| Images animées (GIF) | |||
| '''chafa''' | |||
|- | |||
| Simplicité et rapidité | |||
| '''img2txt''' | |||
|- | |||
| Environnements très limités | |||
| '''img2txt''' | |||
|} | |||
----- | ----- | ||
= '''Autres ressources''' = | == '''Autres ressources''' == | ||
<code> | <code> | ||
ASCII art in one lin<br /> | ASCII art in one lin<br /> | ||