#########################################################################################
//#########################################################################################
//                 FF File Meteor Capture for 8 Cameras - Driver 
//#########################################################################################
//#########################################################################################
//#########################################################################################
//#########################################################################################
////  FF_Capture8AndDetect can be run by double clicking on the executable, batch file command line.
//
//     IMPORTANT NOTE:  This program is interfaced specifically to the Sensoray 812 board
//
//  Clicking on the FF_Capture8... executable icon will go into interactive mode where 
//     the user enters the parameter configuration file for the frame grabber Sensoray 
//     812 unit, the archive flag to do detection and where to put candidate detection
//     FF file set, the first camera number of 8 sequentially numbered cameras, the
//     number of child detection processes to be spawned, the duration of the capture in 
//     hours, and the drive letter/folder under which a CAMS directory and subdirectories 
//     are created or already exist.
//
//     There are several options for the duration with early exit if the disk availability
//     is limited and the maximum number of FF files has been reached. If the duration is 
//     greater than zero, the capture starts immediately and stops after the designated 
//     "duration" time in hours has elapsed. If the duration entered is zero, the user is
//     prompted to manually start and stop the capture process. The capture will end 
//     automatically if the max number of FF files is reached or 24 hours has elapsed.
//
//     If the duration entered is negative, the program computes the period of time 
//     when the sun is more than the absolute value of the duration (entered now in 
//     degrees) below the local horizon. The program will wait in an idling loop until

//     the sun dips low enough to the user designated angle and then starts capturing. It
//     will run continuously until the user angle limit before dawn, OR the maximum 
//     number of FF files is written. 
//
//     IMPORTANT NOTE - The CameraSites.txt file will need to be in the ...\CAMS\Cal\ 
//     folder and populated with the info for all eight cameras starting with the user 
//     specified camera number, so that the program knows the latitude and longitude of 
//     the camera's site for sun angle calculations.
//     
//
//  Various options for the command line entries:
//
//  Executable_name  config_filename  archive_flag  camera_number  #detect_processes  duration_in_hours  drive_letter/folder:
//
//  FF_Capture16AndDetect                                              User prompted for config, archive, 1st camera num, process count, duration, main data directory
//  FF_Capture16AndDetect  Sensoray812_config.txt                      User prompted for archive, 1st camera num, process count, duration, main data directory
//  FF_Capture16AndDetect  Sensoray812_config.txt  1                   User prompted for 1st camera num, process count, duration, main data directory
//  FF_Capture16AndDetect  Sensoray812_config.txt  1  23               User prompted for process count, duration, main data directory
//  FF_Capture16AndDetect  Sensoray812_config.txt  1  23  4            User prompted for duration, main data directory, 4 detection processes to be run
//  FF_Capture16AndDetect  Sensoray812_config.txt  1  23  4  0.0       User prompted for manual capture start and stop, main data directory
//  FF_Capture16AndDetect  Sensoray812_config.txt  1  23  0  9.5       User prompted for main data directory and runs for 9.5 hours, no detection processing
//  FF_Capture16AndDetect  Sensoray812_config.txt  1  23  4 -6.0       User prompted for main data directory and runs while sun is 6 deg below horizon
//  FF_Capture16AndDetect  Sensoray812_config.txt  1  23  4  7.2  D:   No user prompts and runs for 7.2 hours starting immediately, puts data in D:\CAMS\...
//  FF_Capture16AndDetect  Sensoray812_config.txt  1  23  4 -8.0  D:   No user prompts and runs while sun is 8 deg below horizon, puts data in D:\CAMS\...
//
//  A folder is created for saving the FF files based on the date/UTtime at the start
//  of the executable. The higher level directory is always user specified and the \CAMS\CapturedFiles\ 
//  is appended along with the start date and time. For example, cameras 101-116 whose process starts on 
//  Jan 5, 2011 3:11:05 UT and the directory specified was D:\Test would have FF*.bin files  
//  placed into the folder D:\Test\CAMS\CapturedFiles\2001_01_05_03_11_05\ for cameras 101 through 116 inclusive.
//
//  The code also looks for a Calibration directory as ...\CAMS\Cal\. So for the example the
//  calibration folder is expected to be D:\Test\CAMS\Cal. If not found then the user is 
//  prompted for the folder.
//