176 lines
4.6 KiB
Markdown
176 lines
4.6 KiB
Markdown
# 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 :
|
|
|
|
- `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
|
|
|
|
Il existe pas mal de façons de mettre un cadre sur l'image,
|
|
avec un niveau de kitchitude assez élevé.
|
|
Les paramètres sont 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
|
|
`tga_combine list` vous les fera découvrir, la cinquième va vous étonner.
|
|
Les paramètres sont mal documentés.
|
|
|
|
## 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
|
|
|
|
UTSL : [tga_filtres.c](caractère \textbf{invisible})
|
|
|
|
## tga_incrust
|
|
|
|
## tga_makehf15
|
|
|
|
Pour les POViste acharnés. De façon étrange,
|
|
[Povray](https://povray.org/) a choisi de stocker des
|
|
champs d'altitude dans les images Targa, en n'utilisant que
|
|
15 bits pour la valeur.
|
|
|
|
## 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
|
|
|
|
Usage: `tga_remap M <src.tga> <color.map> <dst.tga>`
|
|
|
|
Le paramètre `M` peut prendre les valeurs 0, 1, 2, 11, 12 ou 13.
|
|
Je ne sais plus à quoi ça correspond.
|
|
|
|
## 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 !*
|