From 68a66dffaa6e321684c3565644f2903b5d082205 Mon Sep 17 00:00:00 2001
From: tth <sigfood@dinorama.fr>
Date: Thu, 13 Feb 2020 12:13:07 +0100
Subject: [PATCH] more explanations

---
 README.md                 | 11 ++++++++--
 doc/the_floatimg_hack.tex | 45 +++++++++++++++++++++++++--------------
 scripts/shoot.sh          |  9 ++++++++
 3 files changed, 47 insertions(+), 18 deletions(-)

diff --git a/README.md b/README.md
index 735572e..68d594f 100644
--- a/README.md
+++ b/README.md
@@ -11,8 +11,15 @@ Il y a une [description](http://la.buvette.org/photos/cumul/) bien plus
 longue pour les curieux, et un début de
 [documentation](http://la.buvette.org/photos/cumul/the_floatimg_hack.pdf)
 pour les codeurs.
-Le service _après-vente_ est (plus ou moins bien) assuré sur
+Le service après-vente est (plus ou moins bien) assuré sur
 la [mailing list](https://lists.tetalab.org/mailman/listinfo/tetalab) et/ou
-le [canal IRC](https://www.tetalab.org/fr/contact/irc) qui oupse404.
+le [canal IRC](https://www.tetalab.org/fr/contact/irc) qui _oupse404_...
+
+Par ailleurs, d'autres expérimentations sont
+[en cours](http://la.buvette.org/photos/cumul/fonderie/vidz.html#interpolator)
+sur le traitement et l'assemblage de ces images floues dans le but de faire
+des films flous. Je sais aussi qu'un autre _diehard coder_ travaille sur la
+parallélisation de certaines opérations.
+*En avant vers l'infini, et au-delà...*
 
 
diff --git a/doc/the_floatimg_hack.tex b/doc/the_floatimg_hack.tex
index 67c76a2..2f58a5c 100644
--- a/doc/the_floatimg_hack.tex
+++ b/doc/the_floatimg_hack.tex
@@ -68,8 +68,8 @@ IRC de Freenode.
 \tableofcontents
 \pagebreak
 
-\layout
-\pagebreak
+% XXX \layout
+% XXX \pagebreak
 
 % -------------------------------------------------------------------
 \section{Premier exemple}\index{exemple}\label{exemple}
@@ -451,7 +451,12 @@ To be continued\index{XXX}
 
 \subsection{Effets}\index{sfx}
 
-To be done\index{XXX}
+Quelques routines qui servent futilement à \textsl{brotcher} les images.
+
+\begin{verbatim}
+int fimg_killcolors_a(FloatImg *fimg, float fval);
+int fimg_killcolors_b(FloatImg *fimg, float fval);
+\end{verbatim}
 
 
 %		----------------------------------
@@ -531,16 +536,21 @@ mais ça n'est pas si grave que ça.
 tth@debian:~/Devel/FloatImg/tools$ ./mkfimg -h
 Usage:  mkfimg [options]  quux.fimg width height
         -k N.N  give a float parameter
-        -t bla          howto make the pic
+        -t type         howto make the pic
                         black, drand48...
         -v      increase verbosity
 \end{verbatim}
 
-\begin{itemize}
-\item black / gray / grey
-\item drand48
-\item hdeg / vdeg
-\end{itemize}
+La plupart des types d'image générée prennent un paramètre flottant qui
+devra être donné avec l'option \texttt{-k F.F} avec une valeur par défaut
+à $1.0$.
+
+\begin{description}
+\item [black/gray/grey:] efface avec 0.0 (black) ou avec la valeur
+		\texttt{-k} (gray).
+\item [drand48:] beaucoup de bruit dans chacun des canaux.
+\item [hdeg/vdeg:] dégradé du noir au blanc (relatif à \texttt{-k}).
+\end{description}
 
 
 %		---------------------
@@ -597,11 +607,11 @@ Celui-ci peut être fixé avec l'option \texttt{-k}.
 Une liste détaillée des opérations possibles
 sera lisible avec le sélecteur \texttt{-L}.
 
-\begin{itemize}
-\item Ajustements de contraste : cos01 cos010 pow2 sqrt
-\item Distorsions chromatiques :
-\item Déformations géométriques :
-\end{itemize}
+\begin{description}
+\item [Ajustements de contraste:] cos01 cos010 pow2 sqrt
+\item [Distorsions chromatiques:] gray0
+\item [Déformations géométriques:] r90
+\end{description}
 
 \subsection{fimgops}\index{fimgops}\label{fimgops}
 
@@ -707,11 +717,14 @@ que votre \texttt{drand48} n'est pas si drand que ça. Séquence angoisse.
 
 \subsection{Scripts}\index{scripts}\label{scripts}
 
-:wq
+Le script bash\index{bash} \texttt{shoot.sh} est un front-end rudimentaire
+vers le programme de capture d'image décrit page \pageref{grabvidseq}.
+Il utilise deux fichiers dans le répertoire de travail~:
+\textit{reglages} et \textit{compteur}.
 
 \subsection{Fonderie}\index{fonderie}\label{fonderie}
 
-:wq
+Projet externe en cours d'expérimentation.
 
 % -------------------------------------------------------------------
 \section{Video for Linux}\index{v4l2}
diff --git a/scripts/shoot.sh b/scripts/shoot.sh
index a1e25e3..a0d7a7e 100755
--- a/scripts/shoot.sh
+++ b/scripts/shoot.sh
@@ -1,5 +1,8 @@
 #!/bin/bash
 
+
+# change this to point to your installed binary
+#
 GVS=${HOME}/Devel/FloatImg/v4l2/grabvidseq
 
 #	------------------------------------
@@ -11,8 +14,14 @@ PERIOD=0.0
 COUNT=compteur
 OPTIONS=" -v "
 SHOW="no"
+# output format can be of those types:
+#      .pnm .fimg or .png
 OFORMAT="P_%04d.pnm"
 
+# ces paramètres peuvent être surchargés avec
+# un fichier nommé "reglages" dans le répertoire
+# de travail.
+
 #	------------------------------------
 #	overide parameters from $PWD
 if [ -r ./reglages ]