# Tools Pour utiliser toutes les fonctions de la bibliothèque, il y a une collection d'utilitaires spécialisés. Leur interface en `CLI` est assez rudimentaire, mais la plupart savent donner quelques indices avec la commande `list`. Exemple: ``` tth@konrad:~/Devel/libtthimage$ tga_filtres list *** tga_filtres v 0.0.17 [0.59] (dwtfywl) TontonTh 2018 Usage: tga_filtres FILTR [p1] ... [pn] -+- This is the `tthimage' library v0.4.50 (dwtfywl 2022) tTh commande | type arg | explication ------------+----------+------------------------------ liss2x2 | | lissage 2x2 hipass | | lopass | | prewitt | i | rotation [0..8] random | ii | try it... ``` La colonne du milieu indique le type des paramètres : - `i` pour un nombre entier - `d` pour un flottant en double précision - `s` pour une chaine, ex: un nom de fichier - `f` pour un flag : 0, F, 1, T ## tga_alpha Manipulation du canal alpha (la transparence), lequel canal est globalement mal géré par l'ensemble de la libtthimage. ## tga_applymap Ce qui est considéré comme une map ici vient d'un antique logiciel de fractales sous ms-dos : [Fractint](https://fractint.org/). Quelques exemples de ces fichiers sont dans le répertoire `Datas/` du projet. Vous rencontrerez parfois des messages d'erreur comme « *color map is to big* » ou « *only 97 entries in foo.map* ». Pas d'inquiétude, tout va bien se passer. Dans le premier cas, les lignes en excédent sont ignorées, et dans le second, les valeurs manquantes sont mises au noir. La gestion de la ligne de commande est désastreuse. **À REFAIRE** ## tga_cadre Pas mal de façons de mettre un cadre sur l'image. Niveau de kitchitude assez élevé. Paramètres mal documentés. ## tga_combine ``` Usage: tga_combine s1.tga s2.tga MODE d.tga [PARAMS] ``` Il existe plein de façon de combiner deux images, la commande `testtga list` vous les fera découvrir, la cinquième va vous étonner. ## tga_dither Comment drastiquement réduire le nombre de couleurs d'une image ? ## tga_export Attendu avec impatience, il aura le support complet des PNG. Un jour... ## tga_effects ## tga_equalize ## tga_filtres ## tga_incrust ## tga_makehf15 Pour les POViste acharnés. ## tga_to_text Mis au point pour les imports dans d'autres langages, comme Awk, Fortran ou R. Chaque ligne du fichier généré contient cinq champs : x, y, r, g, b. Attention, il peut vite générer d'énormes fichiers. ## tga_mires La génération de diverses image de test ou de calibration. ## tga_pattern Les résultats sont très ésotériques et l'aide en ligne est vraiment trop nulle... ## tga_remap ## tga_television ## tga_tools Celui ci est très utile pour la recherche de problèmes ou l'automatisation de certaines tâches. Un exemple rapide : ``` tth@redlady:~/Devel/libtthimage$ tga_tools getdimweb foo.tga width=640 height=480 tth@redlady:~/Devel/libtthimage$ tga_tools getdimpov foo.tga -w640 -h480 tth@redlady:~/Devel/libtthimage$ ``` ### version ### surface ### getdims, getdimx, getdimpov, getdimweb renvoie une chaine de caractère donnant les dimensions de l'image en différents formats. ### width, height renvoie chacune des deux dimensions. ### grminmax ### message Flags: un entier. Si non nul, change l'encre et le papier pour d'autres valeurs. La chaine de caractère doit être (sjmsb) encodée en CP-850, voire même comme celles du Locomotive du CPC. ### structs Affichage d'information (boutisme, taille des structures) qui ne seront utiles qu'aux codeurs. ``` tth@redlady:~/Devel/libtthimage/Tools$ ./tga_tools structs petit = 1234 -> 34 12 grand = 12345678 -> 78 56 34 12 00 00 00 00 basic types : short=2 int=4 long=8 ptr=8 Image_Desc : 1296 Image_Rect : 24 RGBA : 16 A_BitPlane : 128 RGB_map : 1624 Image_Point : 8 ``` ### header ### timestamp ### prhisto Calcul et affichage en mode texte de l'histogramme d'une image. Un exemple d'utilisation avec gnuplot serait le bienvenu. ### tag7 ### environ ### mk_rgb ### mk_hgrad ## genplot2 Outil de tracé pseudo-générique et farci de bugs. *WIP ME HARDLY !*