img-outils

dernière mise à jour: 09 septembre 2015

Au départ, c'était juste quelques programmes de démonstration pour ma libimage, mais maintenant, c'est arrivé à un stade où ça devient utilisable. Et comme un miracle n'arrive jamais seul, voici la documentation, un peu légère, il faut l'avouer... Pour compenser, la doc de la bibliothèque est plus consistante, elle.

Current Tarball is here -> img-outils.tar.gz <-

Quelques remarques :

Il est possible de 'faire causer' ces outils en positionnant la variable d'environnement TGA_OUTILS_VERBOSE à yes. En particulier, la ligne de commande sera explicité sur stderr, ce qui est parfois utile dans les scripts ou les Makefiles complexes et/ou àlc.

A partir de mi-février 2008, les paramètres de type 'entier' peuvent éventuellement être donnés en notation décimale, octale ou hexa-décimale. La mise en oeuvre de ce nouveau truc a entrainé l'apparition de nombreux nouveaux messages de trace, qui vont bientôt disparaitre.

tga_showdiff

tga_showdiff iA.tga iB.tga mode dst.tga [params]

Mise en évidence des différences entre deux images de même dimension. A l'heure actuelle, les modes disponibles sont: 0, 1, 2 et 3. Voir ici pour (un peu) plus de détails. Parce que, bon, c'est assez difficile à expliquer, mais je vais essayer.

modecalculs
0Pour chacune des composantes, on calcule dC = ( (s1C - s2C)/2 ) + 127.
1Pour chaque composante, si celle de la première image est supérieure à celle de la seconde image, la composante du résultat est à 255, sinon, elle est à 0.
2Pour chacune des composantes, le calcul est: dC = (C1*C1 - C2*C2)/256, ce qui semble empirique, mais donne de bons résultats.
3On calcule d'abord la valeur absolue de la difference de chaque composante des deux images: dC = abs(C1-C2), puis on binarise en fonction du seuil passé en paramètre sur la ligne de commande.

tga_2x2contrast

Mise en évidence des zones à fort contraste. Le reste de l'image deviendra pratiquement noir. La méthode utilisée est ésotérique, moi-même, j'ai du mal à la comprendre.

tga_tools

(9 oct 2009) C'est un outil assez ancien, et qui se propose de faire un certain nombre d'opérations. Au départ, il a servi de base pour certains tests unitaires, pour se révéler ensuite prêt pour le prime time.

Pour avoir une première idée des choses disponibles, la commande tga_tools sans arguments est un bon début.

lecture des dimensions

Cette partie du logiciel est faite de façon à pouvoir lire des trucs futiles émis dans stderr et récupérer les informations pertinentes sur stdout, ce qui est très shellistique. Exemple :

tth@gaston:/opt/gruik$ foo=$(./tga_tools getdims laPoncha.tga)
lecture header 'laPoncha.tga' -> 0
laPoncha.tga --> 520 x 325
tth@gaston:/opt/gruik$ printf "=%s=\n" $foo
=520=
=325=
tth@gaston:/opt/gruik$ printf "=%s=\n" "$foo"
=     520      325=
tth@gaston:/opt/gruik$ 

Plusieurs présentations de ces valeurs sont disponibles, et d'autres vont peut-être arriver un de ces jours.

mot clefrésultatexplications
getdims515 443 pour les scripts shell, deux nombres séparés par un space.
getdimx515x443 option -geometry de X11
getdimpov-w515 -h443 pour la ligne de commande de POVRAY
getdimwebwidth=550 height=380 pour le tag IMG des pages HTML

informations sur les images

mot clefrésultatexplications
headerplein de chiffres Affichage en +/- clair du contenu de l'entête d'un fichier Targa
prhisto
174       2      46      48
175       4       2       3
176       2      67      79
Quelques chiffres abscons machinables avec Awk

informations diverses

mot clefrésultatexplications
versiondes trucs...quelques informations sur les versions et dates de compilation des outils et de la libimage
structsbasic types :
short=2 int=4 long=4 ptr=4
Tests de boutisme, de sizeof des types de base et des structures de la libimage.
environ
TGA_OUTILS_VERBOSE (null)
LIBIMAGE_PATH      /opt/tthimg/datas
Affichage de quelques variable d'environnement pertinentes.

actions sur les images

Les fonctions sous-jacentes n'étant pas vraiment stabilisées, cette partie de la doc est à prendre avec des pincettes.

haut de page

tga_applymap

tga_applymap M src.tga color.map dst.tga
M est le mode:

Vous trouverez peut-être quelques détails dans cette page. Les fonctions concernées sont Image_apply_Map et Image_gray_Map.

tga_cadre

Syntaxe: tga_cadre <src.tga> STYLE <dst.tga> [p1] ... [pn]

Pour connaitre les différents types de cadres disponibles, il faut utsl, ou tenter de taper tga_cadre list, ce qui vous donnera quelques explications de base.

commande type arg explication
filet un simple filet noir & blanc
cracra i un machin bizarre, un peu cracra
sweep iiii dégradé: rouge, vert, bleu, et taille
bruit iiii du bruit : rouge vert bleu taille
blablanux iiii 4 paramètres
filetg ii un simple filet en gris, 2 params
pattern si cadre pattern
patt_degr si pattern degrade
patt_rand si pattern random
burp0 iii cadre burp 0
burp1 ii cadre burp 1
burp2 iiii inversion composantes
burp3 en chantier...
soft1 en chantier aussi
pixx ii pixx me !
rasta0 i largeur des bandes
wave0 iiiii des vagues en chantier
zsnd0 iii cadre zongo sound
zsnd1 iii cadre zongo sound
b84a iii cadre de la base 84
b84b ii cadre de la base 84
b84c iii non cadre base 84

Une page de démonstration vaut mieux qu'un long discours. Il ne reste plus qu'à la faire. Qui s'en occupe ? Bon, il va falloir que je m'y colle... Voilà, c'est fait. Mais ça commence à devenir *vieux*.

tga_extract

tga_extract source.tga resultat.tga X Y W H

Extraction d'une partie de l'image. Comportement non (encore) défini si il y a débordement :)
coredump in progress...

tga_incrust

Maintenant que nous savons extraire un fragment d'une image, il est temps de savoir le coller dans une autre image. Bizarrement, c'est un outil dont je n'ai jamais vraiment éprouvé le besoin avant de faire des GIFs animées. Et je suis encore en train de réfléchir sur la syntaxe de la ligne de commande, qui devrait être dans ce genre :

tga_incrust from.tga what.tga KEYWORD to.tga params

keyword type arg explication

tga_plothisto

tga_plothisto image.tga histo.tga [texte]

Dessine l'histogramme des 3 composantes r, g & b d'une image. Si le paramètre texte existe, il sera écrit dans l'image. Sinon il y aura le nom de l'image source. Pour plus de détails voir la doc des plotteurs.

tga_mires

Cet outil permet de tracer quelques images de test, et les fontes 16x24. Ce truc est encore en chantier, parfois il ne fait pas ce qu'on attend. La syntaxe générale est tga_mires type dest.tga p1 p2 p2 .., avec un nombre variable (selon le type) de paramètres optionnels.

mircol0 dimensions : 512x512
paramètres : "un texte libre"
mircol1 dimensions : 512x512
paramètres : "un texte libre"
mircol2 Une chose étrange destinée à un projet secret.
paramètres : largeur hauteur "un texte libre"
mircol3 Nous essayons d'avoir trois teintes différentes dans trois zones de l'image. Avec le paramètre mode, la position des couleurs tourne.
paramêtres : largeur hauteur mode "un texte libre"
mircol4 Nous essayons encore d'avoir trois teintes différentes, mais d'une autre manière. Avec le paramètre mode, la position des couleurs tourne.
paramêtres : largeur hauteur mode "un texte libre"
rgb0 dimensions : 256x256

Avec un peu de chance, la description des primitives de cette documentation est plus avancée, en particulier sur les divers paramètres auquels vous n'avez pas accès par cette interface simplifiée. Gniark gniark.

tga_plotmap

tga_plotmap colors.map graphe.tga [texte]
Si le paramètre texte existe, il sera écrit dans l'image, et sinon, ce sera le nom du fichier .MAP
Voir les fonctions plotteurs.

tga_remap

tga_remap MODE source.tga colors.map destination.tga
Là, il manque quelques explications. utsl. Il faut juste ajouter ceci:

  1. c'est vraiment très lent.
  2. certains MODE sont buggués.
  3. il faudrait que je trouve d'autres méthodes.

tga_equalize

tga_equalize avant.tga mode apres.tga [params]

Égalisation des niveaux, ajustement des contrastes. Le script essai_equal.sh vous permettra de tous les essayer sur vos propres clichés, en obtenant ce genre de chose.

commande type arg explication
std standard method
rgb same as 'std'
gray gray based
2x2 2x2 matrix
lumin i param : identity is 256
square pix**2
sqroot sqr(pix)

tga_dither

Réduction du nombre de couleurs dans une image, par des méthodes diverses, empiriques et variées. Il est bon de voir quelques exemples pour mieux comprendre.

* tga_dither v 0.0.20 [0.51] (dwtfywl) tonton Th
usage:
        tga_dither avant.tga mode avant.tga [params]
  commande  | type arg |  explication
------------+----------+--------------------------------
 2x2        |          |  not working
 3x3_0      |          |  
 3x3_1      |          |  
 bayer0     |          |  
 atkinson   | i        |  mmmm ?
 crude      | i        |  
 dbltresh   | ii       |  hi & low tresholds
 error      |          |  simple err diffusion
 random     | i        |  random treshold
 byr8rnd    | ii       |  new 29 nov 2013
 xper       | i        |  param: 1..254
------------+----------+--------------------------------

tga_pattern

Fabrication de divers patterns, pas toujours très beau, mon sens artistique étant limité... Désolé, je ferais mieux l'année prochaine.

tga_resize

Syntaxe: tga_resize source.tga methode resultat.tga [params]. Il existe quatre commandes différentes, certaines d'entre elles pouvant utiliser plusieurs méthodes:

opcodeparamètres
half 0=subsample ou 1=interpole
double 0=subsample ou 1=interpole
percent
newsizenewW newH method

fev 2008 Dans le temps (au siècle dernier, en fait), il existait une commande tga_halfsize qui a disparue. Afin de faire marcher un très vieux truc, je viens de la réimplémenter sous la forme d'un script shell.

tga_alpha

Quelques opération liées au canal alpha, communément utilisé pour stocker une information de transparence, que l'on peut utiliser pour gérer les incrustations.

tga_fractales

Ce petit truc est en fait à l'abandon depuis plusieurs années. Je l'ai hacké à la va-vite quand j'en ai eu besoin, mais je vais y jeter un regard plus attentif parce que mon fils Nicolas s'interesse aux fractales. Vous pouvez aussi aller lire ce petit blabla. Ou regarder ce que l'on peut en "faire.

tga_combine

La ligne de commande est: tga_combine s1.tga s2.tga MODE d.tga [PARAMS]. Voyons les différents mode de combination:

commande type arg explication
mixer i no help
mix_gray i param: 1..10000
mix_rgb iii params: 3*1..10000
seuils iii P in [0..255]
lines iii taille offset 0
columns iii taille offset 0
checker iiiii no help
random i param: 1..10000
rndrgb i param: 1..10000
diago fii no help
diagonale fii no help
hsplit ii P in pixels
vsplit ii P in pixels
minmax i 0:min 1:max
waou iiii ubyte ubyte ubyte bit
wauo i must be 0
circle0 i must be 0
hdeg f 0 or 1
vdeg f 0 or 1
ifnotblack new mars 2007
stereo rouge/vert
stereok iii rouge/vert/coefs
proto prototype

Pour plus d'explications, lire la doc des primitives. Il y a un petit cas pratique sur les images en relief. On peut aussi incruster des images.

tga_effects

Ce programme remplace les anciens tga_water, tga_2gray et tga_swapcolors.

La ligne de commande tga_effect list donne la liste des possibilités :

commande type arg explication
4bits and 0xf0
class0 experimental
decomp f flag: print colors
flatgray i detect flat gray zones
gray coefs RGB : 100 100 100
grayk iii 3 coefs à fournir
mirror
mosaic ?
mosaic0 iif ?
photomaton
negate
seuil iii rgb thresholds
noise i 0..100
pixelX prototype
pixelY prototype
efive got it, code it
recurse i EXPERIMENTAL !
rgbmskh i 'par' is a gray level
rgbmskv i 'par' is a gray level
bicolor0 i grosse fatigue...
bicolor1 ii grosse fatigue...
rot4pix i ???
cont2x2 contours 2x2 en auto
cont2x2g contours 2x2 sur le gris
scratch i coredumper :)
sinwave1 dddddd strange effect
swapcol s rg rb bg
swapnibble swap all pix nibbles
updown upside down
shift_xy ii les deux offsets
water i 'par' is water distance
fukung i OMG ! WTF ?
class1 iiii R G B diameter
x0 iii 3 thresholds for r, g, b
x1 xor other componant
x2 iii trigonometry
x3 iis
x4 i essai Aug 2008
x5 iii essai Sept 2008

Certains des effets disponibles ne fonctionnent pas très bien; mais d'autres ne sont pas si mal, en fait. Et de nouveaux arriveront dans le futur.

tga_export

Conversion d'une image TGA (à priori en 24 bits) vers divers formats. Cet utilitaire est pour le moment assez pauvre en possibilités, mais riche en limitations. La syntaxe est : tga_export src.tga format dest.xxx [params].

formatparamsexplications
pgm0component exportation vers le format PGM d'une des composantes de l'image, sélectionnée par une des lettres rgba.
ppm0  exportation de l'image en Portable PixMap, en mode ascii.
phtcomponent exportation vers le format PHT d'une des composantes de l'image, sélectionnée par une des lettres rgba. Ce format inconnu est décrit ici.
Ici, quelques formats dont le code ne fonctionne pas très bien...
pgmhf  Un truc en rapport avec les height-fields...

Pour plus de détails, consultez la doc des différents formats de fichiers gérés par la libimage. Et en particulier, les difficultés que nous cause le Grand Satan :)

genplot2

Ce truc permet de fabriquer une image TGA à partir d'ordres de tracés simples. Les dimensions de l'image sont déterminées par un parsing du fichier de commande, et vous avez quelques chances d'appeler le tristement célèbre OOM-killer si votre image est démesurée.

Quand on le lance, il va lire dans le répertoire courant un fichier texte nommé a.scratch contenant trois champs séparés par des <blanks> : X.xxx Y.yyy N, c'est à dire deux coordonnées suivies d'un code couleur. À partir de ces valeurs, il va faire une mise à l'échelle des coordonnées afin que tout cela tienne dans une image de dimensions fixés (utsl) par dddd. Le nom du fichier produit est image.tga.

Encore quelques trucs...

Pour connaitre la liste des effets/options disponibles: tga_effects list. Tout cela ne semble pas très clair, mais avec un peu de pratique, ça vient vite. Voici quelques séquences de commandes qui vont vous permettre de démarrer sans patauger.

Image grise avec les contours mis en valeur.

$ tga_2x2contrast SRC.TGA toto.tga
$ tga_effects SRC.TGA gray tutu.tga
$ tga_combine tutu.tga toto.tga mixer DST.tga 4000

D'ailleurs, donner en seul argument le mot 'list' à tous les tga_* permet d'obtenir (en général) la liste des mots-clef utilisables.

Par contre, dans la catégorie bug, veuillez noter dans vos carnets que les codes d'erreurs retournés au shell appelant sont vraiment cahotiques.

POV height-fields

Bon, je ne vais pas ré-expliquer ce qu'est un champ d'altitude, j'ai bien trop peur de dire des bétises. De mon point de vue actuel, c'est juste un tableau [x,y] contenant des valeurs entières non signées codées sur 15 bits, donc comprise entre 0 et 32767.

La forme générale d'une commande est simple : povhf_tools src.??? commande [arguments], avec src.??? qui est le nom du fichier sur lequel nous allons opérer, "commande" le nom de l'opération demandée, le tout suivi de divers arguments.

commandeargumentsaction
minmaxaucun Calcul et affichage des hauteurs minimum et maximum du hf.
rescalehmax Réglage de la hauteur maximale, le résultat de l'opération écrase l'image d'origine, ce qui n'est pas forcément une bonne idée.
lissagedst.tga coef Lissage du heigh-field. coef détermine l'intensité de l'action, mais son effet n'est pas vraiment documenté.
sqrtdst.tga Calcul de la racine carré de la hauteur, après normalisation à 1.0 pour rester dans des limites raisonnables.
powdst.tga expst Exponentiation de l'altitude par l'exposant. Avec une normalisation à 1.0 qui n'est peut-être pas au point.
sweep0coef Cette fonction est complètement cassée...
bruitdst.tga k1 k1 Rajout de bruit à un height-field. Les coefficients k1 et k2 ont une influence certaine.
fromtgadst.tga Conversion d'une image RGB en un height-field par une savante combinaison linéaire des trois composantes de l'image d'origine.
topgmdst.pgm Conversion d'un heigh-field encodé dans une TGA en une image avec 32768 niveaux de gris dans un format "portable pixmap", ce qui engendre des fichiers volumineux.
trucindéterminés
$ povhf_tools list
Cette commande est le point d'entrée de la nouvelle fonction en cours de mise au point. Le nombre et la nature des paramètres peut donc changer au fil du temps. ymmv.

Tout cela est en cours de mise au point, les ordres et valeurs à donner sur la cli ne sont pas vraiment déterminées, mais l'idée est en place. Dans le tarball, il y a un script essai_povhf.sh qui déroule une suite de tests, dont l'interprétation des résultats est laissée aux bons soins du lecteur.

povhf_plothisto

Ce logiciel rudimentaire prend comme arguments le nom d'un fichier contenant un HF au format TGA, puis le nom d'un fichier TGA qui contiendra (peut-être) un tracé (probablement) erroné de l'histogramme des altitudes.

Les mystérieux df3

Mmmpfpfpfpffeeemmmmff.

Palettes de couleurs

Mmmpfpfpfpffeeemmmmff.

Portage sur une vrai machine

Bon, maintenant, il faut faire tourner tous ces toolz dans une U5 sous OpenBSD.

tga_television

De grands progrès sont à prévoir. Il existe une page de démonstration.