better doc for the tools

This commit is contained in:
tTh 2024-05-26 01:38:30 +02:00
parent b7c32d24f3
commit 4e7debaae6
1 changed files with 53 additions and 11 deletions

View File

@ -1,8 +1,9 @@
# Images en virgule flottante, les outils.
Dans tous les cas, vous pouvez utiliser l'option `-h` pour avoir des
explications sur ce que vous pouvez faire, et l'option `-v` pour suivre
l'avancée des travaux.
Dans tous les cas, vous pouvez utiliser l'option `-v`
(qui est bien mieux en premier sur la ligne de commande)
pour suivre l'avancée des travaux et l'option `-h` pour
avoir des explications sur ce que vous pouvez faire,
## mkfimg
@ -11,7 +12,22 @@ Un [../scripts/demo-mkfimg.sh](script) permet de créer toutes
les images disponibles.
L'option `-m` rajoute des méta-données, cette option
**ne** doit **pas** encore être utilisée dans la vrai vie.
**ne** doit **pas** encore être utilisée dans la vrai vie, ymmv.
## cumulfimg
Procède à l'accumulation de plusieurs images flottantes,
c'est-à-dire en faire la moyenne.
Le nom par défaut du fichier résultant est `out.fimg`, mais peut
être changé avec l'option `-o`. Avec `-g` l'image de sortie
sera en niveau de gris.
Ce logicel gagnerait peut-être à utiliser un accumulateur
intermédiaire en double précision pour les cas limite,
ou une [méthode](https://orlp.net/blog/taming-float-sums/)
plus adaptée.
## fimgops
```
@ -24,30 +40,56 @@ options:
## fimgfx
effects:
Available effects:
cos01 cos010 pow2 sqrt gray0 cmixa xper desat ctr2x2 mirror
shift0 trimul classtrial binarize trinarize hilightr
abs clamp fakol0 morph0 morph4 morph8 thermocol
Un [../scripts/demo-fimgfx.sh](script) permet de créer toutes
les images avec les effets disponibles.
Vous vous rendrez vite compte que certains ne semblent rien faire,
mais regardez plus attentivement...
## fimgstats
Compute some useless numbers...
Compute some useless numbers, specially for the enduser...
## fimg2pnm - fimg2png - fimg2tiff - fimg2fips
Exportation d'image flottante vers divers formats. Certains d'entre eux
ne sont gérés que de façon très rudimentaire.
Exportation d'image flottante vers divers (et trop rares) formats.
Certains d'entre eux ne sont gérés que de façon très rudimentaire.
## fimg2text
Nouveau de l'année 2020+1 : exfiltrer toutes des données d'une image flottante
afin de les rendre machinables. Voir aussi *fimgmetadata*.
```
tth@redlady:~/Devel/FloatImg/tools$ ./fimg2text bar.fimg | head -5
0 0 123.701111 269.273682 10.732136
1 0 109.500832 265.568481 26.176439
2 0 128.529694 292.033844 37.591236
3 0 98.910492 234.900467 17.132524
4 0 187.679092 386.155609 36.663834
```
## fimgmetadata
Nouveau avril 2022. Need more doc...
Voir aussi *fimg2text*.
Affichage des informations diverses stockées dans un fichier `.fimg`,
comme la date de prise de vue ou les réglages du logiciel
de capture.
Expect problems with `time_t` on 32 vs. 64 bits. Fix in
progress.
## fimgextract
nouveau novembre 2022.
En avril 2024, il sert à tester une nouvelle fonctionnalité :
la recopie des méta-données de l'image source.
$ fimgextract [options] source.fimg width,height,xpos,ypos
Les options utiles : `-o out.fimg` pour nommer le fichier de
sortie, et `-m` qui demande la recopie des metadatas.