beep doc

Beep/README.md

@@ -1,5 +1,43 @@
 # AlguaBeep
 
 Une expérimentation hasardeuse pour traduire des images de webcam
-en sons qui déchirent les oreilles
+en sons qui déchirent les oreilles, mais qui sont bio-dégradables.
+
+## Usage
+
+```
+        -d /dev/?       select video device
+        -I              take pictures
+        -K              set the K parameter
+        -n NNN          how many frames ?
+        -p NNN          period in seconds
+        -s WxH          set capture size
+        -v              increase verbosity
+```
+
+### Explications
+
+- **-d** : choix du périphérique vidéo. Les deux cas fréquents : une seule
+ caméra, c'est `/dev/video0`.
+ Si il y a une caméra internet et une webcam USB, la seconde sera `/dev/video2`,
+ ou l'inverse, selon que l'externe est branchée au démarrage ou non.
+- **-I** : dont't use !
+- **-K** : useless.
+- **-n** : nombre de passe, sachant qu'il y a en gros 10 à 15 images traitées
+ par seconde, vous calculez la durée.
+- **-p** : la période, ou l'espacement entre deux trames. Par exemple,
+ _0.25_ c'est 4 images par seconde.
+- **-s** : taille de l'image en pixels, le défaut est `1920x1080`.
+- **-v** : demande au kulge de raconter sa vie.
+
+Pour le moment, il n'est pas possible de choisir la sortie du son, c'est
+celle qui est déclarée 'par défaut' dans le système.
+
+### Conseils
+
+En cas de problème sur l'acquisition vidéo, dans un terminal,
+tapez `ffplay /dev/videoN`, avec `N` de zéro à quatre. Vous
+tomberez peut-être sur l'image désirée.
+
+Et surtout que la maman des algues reste CALME !