chore: cleanup readme

README.md

@@ -1,54 +1,90 @@
 Camera notes
 ============
 
+
+Pi Settings
+-----------
 Increase the memory available to the GPU from 128 to 256 on the pi configuration>>performance [memory]
 
-#note to exit camera preview use Ctrl+Alt+t to get a focus of the terminal (hidden behind the preview, which you can then exit, ctrl+D or pkill python )
+*Tip*: to exit camera preview use Ctrl+Alt+t to get a focus of the terminal (hidden behind the preview, which you can then exit, ctrl+D or pkill python )
 
-#grab a preview without recording, also configure the different effects modes and exposure modes
+Pi Camera CLI
+-------------
+grab a preview without recording, also configure the different effects modes and exposure modes
+```sh
 raspistill --imxfx colourswap -t 60000 --rotation 270
 raspistill --imxfx none --exposure nightpreview -t 60000 --rotation 270
+```
 
 #grab a still
+-------------
+```sh
 raspistill -o Desktop/image.jpg
+```
+
+grab a raw video
+----------------
+```sh
+raspivid -o Desktop/video.h264
+```
 
-#resolution max (2592x1944) 
+
+Python PiCamera package
+-----------------------
+*docs* https://picamera.readthedocs.io/en/release-1.13/
+
+set resolution max (2592x1944) 
 https://projects.raspberrypi.org/en/projects/getting-started-with-picamera/8
 Note framerate of 15 caveat...
 
-
-#consistent image sequence
+consistent exposure image sequence (esp. for timeseries)
 https://picamera.readthedocs.io/en/release-1.13/recipes1.html#capturing-consistent-images
 
-#low lighting
+low lighting settings (needs tweaking)
 https://picamera.readthedocs.io/en/release-1.13/recipes1.html#capturing-in-low-light
 
-
 Various methods for image series capture
 https://picamera.readthedocs.io/en/release-1.13/recipes1.html#capturing-timelapse-sequences
+https://projects.raspberrypi.org/en/projects/cress-egg-heads
 
 
+using avconv for timelapse sequence video collation
+---------------------------------------------------
+https://projects.raspberrypi.org/en/projects/cress-egg-heads/10
+```sh
+avconv -r 10 -i image%04d.jpg -r 10 -vcodec libx264 -crf 20 -g 15 timelapse.mp4
+```
+this uses zero padded numbers.
 
-
-#grab a raw video
-raspivid -o Desktop/video.h264
-
-
-
-#raw video format player
+To create a timelapse with non-zero prefixed padding image numbered files
+i.e. 1,2,3...300 rather than 0001,0002,...300.respectively image%00d.jpg rather than obased image%03d.jpg)
+```sh
+avconv -r 10 -i cat-spy_%00d.jpg -r 10 -vcodec libx264 -crf 20 -g 15 timelapse.mp4
+```
+
+Composite Image generation
+--------------------------
+Using Python PIL (pillow) package to generate a Composite Image
+https://pythontic.com/image-processing/pillow/alpha-composite
+PIL Image class provides two options here (see above link) blend() and alpha_composite()
+[see here:](composite-img/pil-composite.py)
+
+Using ImageMagick 
+Composite Func
+https://imagemagick.org/script/composite.php
+Blend Func
+https://imagemagick.org/script/command-line-options.php#blend
+
+Playback (video .h256)
+--------
+raw video format player
 playing on pi3 .h256 raw video  (on pi4 the vlc works but not pi3)
 see https://www.raspberrypi.org/documentation/usage/video/
-
 using omxplayer
+```sh
 omxplayer video.h256
-
-confvert to mpg
+```
+convert to mpg
+```sh
 ffmpeg -r 30 -i video.h264 -c:v copy video.mp4
-
-
-#using avconv for timelapse sequence video collation
-create a timelapse with non-zero prefixed input image numbering
-
-i.e. 1,2,3...300 rather than 0001,0002,...300.respectively image%00d.jpg rather than obased image%03d.jpg)
-avconv -r 10 -i cat-spy_%00d.jpg -r 10 -vcodec libx264 -crf 20 -g 15 timelapse.mp4
-
+```