4.2 KiB
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 <src.tga> FILTR <dst.tga> [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 :
ipour un nombre entierdpour un flottant en double précisionspour une chaine, ex: un nom de fichierfpour 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. 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 !