libtthimage/Tools

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. 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 !