add star bkg

Readme.md

@@ -11,12 +11,15 @@ To restart server (e.g. if hardware was off) kill it with SIGUSR1
 cmake options:
 
 - `-DAPOGEE=ON` - compile Apogee plugin
-- `-DDEBUG=ON` - make with a lot debugging info
-- `-DIMAGEVIEW=ON` - compile with image viewer support (only for standalone) (OpenGL!!!)
+- `-DASTAR=ON` - compile "artifical star" plugin
 - `-DBASLER=ON` - compile Basler support plugin
+- `-DDEBUG=ON` - make with a lot debugging info
+- `-DDUMMY=OFF` - compile without dummy camera plugin
+- `-DEXAMPLES=ON` - compile also some exaples of libccdcapture use
 - `-DFLI=ON` - compile FLI support plugin
-- `-DFLYCAPT=ON` - compile GrassHopper PointGrey plugin
+- `-DFLYCAP=ON` - compile GrassHopper PointGrey plugin
 - `-DHIKROBOT=ON` - compile HikRobot support plugin
+- `-DIMAGEVIEW=OFF` - compile without image viewer support (OpenGL!!!)
 - `-DZWO=ON` - compile ZWO support plugin
 
 
@@ -36,6 +39,7 @@ Usage: ccd_capture [args] [output file prefix]
   -V, --verbose               verbose level (-V - messages, -VV - debug, -VVV - all shit)
   -W, --wheeldev=arg          wheel device plugin (e.g. devdummy.so)
   -Y, --objtype=arg           object type (neon, object, flat etc)
+  -_, --plugincmd             custom camera device plugin command
   -a, --addsteps=arg          move focuser to relative position, mm (only for standalone)
   -c, --conf-ioport=arg       configure I/O port pins to given value (decimal number, pin1 is LSB, 1 == output, 0 == input)
   -d, --dark                  not open shutter, when exposing ("dark frames")
@@ -43,6 +47,7 @@ Usage: ccd_capture [args] [output file prefix]
   -g, --goto=arg              move focuser to absolute position, mm
   -h, --hbin=arg              horizontal binning to N pixels
   -i, --get-ioport            get value of I/O port pins
+  -k, --shmkey=arg            shared memory (with image data) key (default: 7777777)
   -l, --nflushes=arg          N flushes before exposing (default: 1)
   -n, --nframes=arg           make series of N frames
   -o, --outfile=arg           output file name
@@ -64,15 +69,16 @@ Usage: ccd_capture [args] [output file prefix]
   --client                    run as client
   --close-shutter             close shutter
   --focdevno=arg              focuser device number (if many: 0, 1, 2 etc)
+  --forceimsock               force using image through socket transition even if can use SHM
   --gain=arg                  CMOS gain level
   --help                      show this help
-  --imageport=arg             local INET socket port to send/receive images
+  --imageport=arg             INET image socket port
+  --infty=arg                 start (!=0) or stop(==0) infinity capturing loop
   --logfile=arg               logging file name (if run as server)
   --open-shutter              open shutter
-  --path=arg                  UNIX socket name
-  --pidfile=arg               PID file (default: /tmp/CCD_Capture.pid)
+  --path=arg                  UNIX socket name (command socket)
   --plugin=arg                common device plugin (e.g devfli.so)
-  --port=arg                  local INET socket port
+  --port=arg                  local INET command socket port
   --restart                   restart image server
   --rewrite                   rewrite output file if exists
   --set-fan=arg               set fan speed (0 - off, 1 - low, 2 - high)
@@ -106,3 +112,44 @@ Mouse functions:
 - Wheel up - scroll up, or scroll left (with Shift), or zoom+ (with Ctrl).
 - Wheel down - scroll down, or scroll right (with Shift), or zoom- (with Ctrl).
 
+## Plugins custom commands
+Since version 1.2.0 introduced custom camera plugin commands system. Commonly to read help just
+type `-_help`. You can point as much custom commands in one commandline as you need. They can be a
+procedures/flags (like `-_cmd`) or a setters/getters (like `-_key` and `-_key=value`).
+
+### Dummy camera plugin custom commands
+This plugin simply emulates image aqcuisition process where images are 2-D sinusoide with given periods.
+Each next frame will be shifted by one pixel.
+
+Commands:
+
+- px = (double) [1, inf] - set/get sin period over X axis (pix)
+- py = (double) [1, inf] - set/get sin period over Y axis (pix)
+
+
+### Artifical star plugin custom commands
+This plugin lets you to emulate star field with up to 32 stars. You can shift center of field emulating
+telescope correction, also you can rotate field emulating derotation.
+All stars (Moffat) have the same FWHM and scale parameters. Their coordinates are given by arrays `x`
+and `y` with a hardware magnitude `mag`. You can emulate image drift and rotation. Also you can add
+a little image position (full frame position) fluctuations. To emulate poisson noice just point its `lambda`
+value (`lambda==1` means no noise).
+
+Commands:
+
+-    xc = (int) - x center of field in array coordinates
+-    yc = (int) - y center of field in array coordinates
+-    x - X coordinate of next star
+-    y - Y coordinate of next star
+-    fwhm = (double) [0.1, 10] - stars min FWHM, arcsec
+-    scale = (double) [0.001, 3600] - CCD scale: arcsec/pix
+-    mag - Next star magnitude: 0m is 0xffff/0xff (16/8 bit) ADUs per second
+-    mask - load mask image (binary, ANDed)
+-    vx = (double) [-20, 20] - X axe drift speed (arcsec/s)
+-    vy = (double) [-20, 20] - Y axe drift speed (arcsec/s)
+-    vr = (double) [-36000, 36000] - rotation speed (arcsec/s)
+-    fluct = (double) [0, 3] - stars position fluctuations (arcsec per sec)
+-    beta = (double) [0.5, inf] - Moffat `beta` parameter
+-    lambda = (double) [1, inf] - Poisson noice lambda value (>1)
+-    rotangle = (double) [0, 1.296e+06] - Starting rotation angle (arcsec)
+