History

tTh 97ad716bd2 little work on documentation		2024-11-14 10:11:11 +01:00
..
.gitignore	tga to text, version 0	2024-02-27 00:43:44 +01:00
essayage.sh	shootgun debug session #539	2022-12-19 13:54:39 +01:00
fonctions.c	breakin a srand usage	2023-11-14 13:09:27 +01:00
genplot2.c	more cleanup...	2023-01-31 00:21:05 +01:00
Makefile	re-enable tga_info	2024-08-16 13:06:51 +02:00
README.md	little work on documentation	2024-11-14 10:11:11 +01:00
tga_alpha.c	a few cleanup + new patterns	2023-09-22 14:15:52 +02:00
tga_applymap.c	clean before use	2024-04-08 05:35:19 +02:00
tga_cadre.c	maintenant, les choses importantes...	2022-06-27 23:05:42 +02:00
tga_combine.c	a few cleanup + new patterns	2023-09-22 14:15:52 +02:00
tga_dither.c	more clean...	2022-08-22 17:53:30 +02:00
tga_effects.c	remove useless msg	2024-07-18 08:55:57 +02:00
tga_equalize.c	add molly-guard message	2024-07-18 08:56:48 +02:00
tga_export.c	garbage collecting again	2022-07-07 12:52:00 +02:00
tga_extract.c	add tga_extract	2023-09-12 18:19:12 +02:00
tga_filtres.c	garbage collecting again	2022-07-07 12:52:00 +02:00
tga_incrust.c	small tweaking	2024-08-15 11:20:58 +02:00
tga_info.c	2.5 tools added...	2022-06-28 10:46:14 +02:00
tga_makehf15.c	six more tools added...	2022-06-27 23:39:52 +02:00
tga_mires.c	six more tools added...	2022-06-27 23:39:52 +02:00
tga_outils.h	a few cleanup + new patterns	2023-09-22 14:15:52 +02:00
tga_pattern.c	a few cleanup + new patterns	2023-09-22 14:15:52 +02:00
tga_remap.c	a few cleanup + new patterns	2023-09-22 14:15:52 +02:00
tga_television.c	porno canal+	2024-04-01 18:26:46 +02:00
tga_to_text.c	small tweaking	2024-08-15 11:20:58 +02:00
tga_tools.c	error handling + cosmetic	2024-07-31 22:24:32 +02:00

README.md

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

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