From 4e7debaae602412ed968ae46beda6bd9a7ed5157 Mon Sep 17 00:00:00 2001 From: tTh Date: Sun, 26 May 2024 01:38:30 +0200 Subject: [PATCH] better doc for the tools --- tools/README.md | 64 ++++++++++++++++++++++++++++++++++++++++--------- 1 file changed, 53 insertions(+), 11 deletions(-) diff --git a/tools/README.md b/tools/README.md index 0e2c8f41..2668a32c 100644 --- a/tools/README.md +++ b/tools/README.md @@ -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.