See SBIG or APOGEE for instructions on building and installing the
software for your camera.

It helps to have a recent Linux operating system installed.  
This version of XmCCD has been developed and tested in April 2018
64-bit OpenSUSE Leap 42.3.

The default installation of OpenSUSE will need additional software. 
At a minimum add the Motif development and fxload (for SBIG) packages. 


Edit protocol.h for the filter wheel and maximum filter count in your system. 

With recent versions of Linux, ds9, and xpa you must add this to the
local profile (e.g. in /etc/profile.local for global use):

export XPA_METHOD=local

Otherwise, you will see an error message when ds9 starts, and xmccd and ds9
cannot communicate.

It is also helpful to add these commands to startup scripts so that ds9 is
in the right state to handle the images pushed from xmccd:

# Set ds9 preferences

xpaset -p ds9 preserve scale yes
xpaset -p ds9 preserve pan yes
xpaset -p ds9 preserve regions yes
xpaset -p ds9 colorbar no
xpaset -p ds9 regions centroid radius 40

# Set ds9 for N up W right Cassegrain telescope pointing east

xpaset -p ds9 orient x
xpaset -p ds9 rotate 180

# Set ds9 for N up W right Cassegrain telescope pointing west

xpaset -p ds9 orient x
xpaset -p ds9 rotate 0


Examples of scripts that use xmccd and ds9 are in the scripts directory.
