home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Mac Game Programming Gurus / TricksOfTheMacGameProgrammingGurus.iso / More Source / Libraries / VideoToolbox 95.04.18 / Utilities / CalibrateLuminance / CalibrateLuminance.c < prev    next >
Encoding:
Text File  |  1995-01-11  |  42.4 KB  |  1,101 lines  |  [TEXT/MMCC]
  1. /*
  2. CalibrateLuminance.c
  3. by Denis Pelli, Lan Zhang, and Preeti Verghese
  4. You will need "Numerical Recipes in C" in order to compile this file; see
  5. limitations below.
  6.  
  7. USE
  8.  
  9. You must run this program (or your own equivalent) to calibrate your video card,
  10. ISR Video Attenuator, and monochrome monitor, as described by Pelli & Zhang
  11. (1991).
  12.  
  13. D.G. Pelli and L. Zhang (1991) Accurate control of contrast on microcomputer
  14. displays. Vision Research, 31:1337-1360.
  15.  
  16. The program's results are stored in a file called LuminanceRecord?.h that you
  17. can then use in the rest of your C programs. "?" will be a digit indicating
  18. which monitor. LuminanceRecord?.h describes the gains of the three video
  19. pathways of your video card and ISR Video Attenuator, and describes the gamma
  20. function of your monitor, to allow automatic gamma correction later, using
  21. SetLuminance(), etc.
  22.  
  23. There are two ways of using the LuminanceRecord file. You can use the
  24. preprocessor #include statement, in the midst of your C code, provided you've
  25. got a LuminanceRecord structure called LR. Or you can use the VideoToolbox
  26. routine called ReadLuminanceRecord() to read the data (at runtime) into a
  27. LuminanceRecord of any name.
  28.  
  29. For historical reasons this program not only measures the gamma function, but
  30. also fits a variety of functions to it. In fact the latest implementation of
  31. Luminance.c, which is the only routine that makes direct use of the gamma
  32. description, would be quite content with just the tabulated gamma function. At
  33. present the gamma function is tabulated very coarsely by CalibrateLuminance, so
  34. it doesn't bother to put this table into the header file LuminanceRecord.h.
  35. However, if you'd rather write your own substitute for this program, then I
  36. would suggest just measuring the luminance at 256 different levels (from 0 to
  37. VMax) and saving the table in the header file. You will also need to measure
  38. the RGB gains, but that can easily be done directly, using an oscilloscope,
  39. rather than trying to be clever, as in here, where we invert the nonlinearity to
  40. infer voltages from the nonlinear luminances that we measure.
  41.  
  42. CalibrateLuminance also produces a CricketGraph file, CalibrateLuminance%d.data
  43. (where %d is replaced by the monitor number), which is suitable for graphing the
  44. monitor's gamma function. Use the CricketGraph format file CalibrateLuminance.format.
  45.  
  46. This program measures the luminance of a patch on the screen, using a photometer
  47. and, optionally, a 12-bit Analog to Digital Converter (ADC). If you have a Data
  48. Translation Forerunner Analog-to-Digital card, then GetVoltage.c will
  49. automatically find and use it. You can set the MANUAL flag to force manual
  50. operation. If your photometer has an analog output, it's convenient and more
  51. accurate to have all the voltages read in automatically via an ADC, but you
  52. won't need to run CalibrateLuminance very often, and you can get by with manual
  53. calibration.
  54.  
  55. You should set the background luminance to approximately the same value as you
  56. will use in your experiment. Note that the channels gains depend on the DACs as
  57. well as the ISR Video Attenuator, and will vary from DAC to DAC by ±5%. That's
  58. why you must do this calibration yourself using your own video card and monitor.
  59.  
  60. This program can calibrate any of your screens, including the main screen. It
  61. now works fine with a single screen, alternating the user dialog with the
  62. measurements.
  63.  
  64. LIMITATIONS
  65.  
  66. CalibrateLuminance uses routines from Numerical Recipes in C to do the
  67. polynomial and power law fits to the gamma function. They're copyrighted, so I
  68. can't distribute them. Note: I HAVE included a compiled application
  69. CalibrateLuminance that you can use NOW. You only need to buy the Numerical
  70. Recipes if you want to MODIFY CalibrateLuminance.c. See "Improve Numerical Recipes" 
  71. in the VideoToolbox Notes folder.
  72.  
  73. HISTORY
  74.  
  75. 4/25/89    Preeti and Denis
  76. 6/18/89    Denis added numerical display of clut index and triple grating for first screen.
  77. 8/4/89    Denis replaced SetEntries call by GDSetEntries, and generally updated everything.
  78. 8/18/89    Lan Measure the whole routine(R+G+B and R G B gain) 40 times to eliminate the
  79.         effect of screen luminance drift.
  80. 9/8/89    Lan & Denis generally tidied it up.
  81. 9/8/89    denis: replaced polynomial fit by powerlaw fit
  82. 9/10/89 denis: got gain measurement to work with sufficient accuracy. 
  83.         This involved many small changes. I now
  84.         wait for a second after any large luminance change to allow the
  85.         photometer to settle. I also measure the channel gains at many different
  86.         settings of the other DACs, in order to average out the effect of DAC
  87.         inaccuracies.
  88. 10/30/89 Lan & Denis: introduced the option of manual readings, and made console smaller.
  89. 11/17/89 Lan & Denis: cleaned up for general release.
  90. 11/30/89 Denis: added comment to LuminanceRecord.h explaining power[] parameters.
  91. 3/29/90    dgp    2.15 Updated to use new GetVoltage that looks for ForeRunner card,
  92.             and new GDOpenWindow() that uses CWindowPtr instead of WindowPtr. Introduced
  93.             conditionals so it compiles without errors under MPW C 3.1. 
  94. 4/21/90    dgp    2.20. Fixed the bug in the fixed-power power law fit. Updated whole file
  95.             to be compatible with latest versions of all subroutines. Corrected printout
  96.             of nBackground.
  97. 7/28/90    dgp    2.3. Added code (in GetALuminance.c) to find the equivalent number to
  98.             produce any desired background luminance.
  99.             All luminance measurement is now done via the new subroutine GetALuminance. 
  100.             Automatic and manual measurements now use the exactly the same code.
  101.             Calibration of (linear) RGB gains is now optional.
  102. 9/18/90    dgp    2.4. Changed all instances of "v" to "V". Pelli
  103.             & Zhang (1991) refer to a nominal voltage v; this file
  104.             now refers to the "equivalent number" V; they are related by V=VMax*v.
  105. 9/22/90    dgp    2.5. Fixed cosmetic errors that prevented use of this program on the main
  106.             screen. The trick is appropriate use of BringToFront() and SendBehind()
  107.             referring only to my own window. Trying to do BringToFront() on the console
  108.             often caused a bus error, for no obvious reason. I'll have to ask Mike
  109.             Kahl.
  110. 9/24/90    dgp    2.6. Added screen to the LuminanceRecord.h file and appended it to
  111.             the LuminanceRecord.h and .data filenames. This makes it easy to calibrate
  112.             all your monitors and keep the records straight.
  113.             Added LR.date string.
  114.             New default is to retain old gainAccuracy when rgb gains are not remeasured.
  115. 10/10/90 dgp Added SetDepth(). Fixed bug that reducing the number of frames sampled
  116.             per a/d measurement by the number of cycles. The number of frames per
  117.             measurement is now fixed.
  118. 10/12/90 dgp Added LR.dpi and LR.Hz to the LuminanceRecord?.h file.
  119. 10/17/90 dgp Removed unused variables. Added reference to paper to LuminanceRecord?.h.
  120. 12/12/90 dgp Measure and subtract off the dark voltage.
  121.             Fixed dumb error of assuming wrong type when printing LP->VMax
  122.             & LP->coefficients, which was resulting in zeroes in the LuminanceRecord.
  123. 4/15/91    dgp Check for NewPaletteManager().
  124. 8/24/91    dgp    made compatible with THINK C 5. This required introducing several
  125.             casts: (unsigned long *) and (unsigned char *). Hopefully, this won't
  126.             compromise compatibility with old THINK C 4.
  127. 3/10/92    dgp    include mc68881.h
  128. 6/23/92    dgp    added quick check of photometer gain.
  129. 8/27/92    dgp    replace SysEnvirons() by Gestalt()
  130. 10/23/92 dgp read latest LuminanceRecord for default values. Mentioned ReadLuminanceRecord()
  131.             in the LuminanceRecord header file.
  132. 10/24/92 dgp use GDFrameRate() to measure the frame rate.
  133. 11/13/92 dgp advertise ReadLuminanceRecord.c
  134. 12/17/92 dgp Enhanced to support arbitrary dacSize. Get dacSize by calling GDGetGamma(). 
  135.             Mostly I just replaced 255 by LP->VMax. Didn't test it after changes.
  136. 12/21/92 dgp No longer load unused dac bits.
  137. 2/23/93    dgp    Use new GDOpenWindow1 and GDDisposeWindow1.
  138. 4/3/93    dgp    Fix bug that causes GetALuminance to fail (i.e. always set entry to black)
  139.             if the LuminanceRecord hasn't been initialized.
  140. 4/18/93    dgp    Replaced ctSize by clutSize. Now call GDClutSize. Fixed call to SetDepth.
  141. 5/4/93    dgp    Leave gray/color mode alone, but warn if in gray mode.
  142. 5/12/93    dgp When in gray mode don't bother to offer to calibrate rgb gains.
  143. 6/4/93    dgp Conditionally changed the data-saving subroutine to use the
  144.             new WriteLuminanceRecord subroutine. This hasn't been tested yet, and
  145.             we can revert back to the old code by changing the #if 1 to #if 0.
  146.             The virtue of the new code is that it verifies what was written.
  147. 5/28/94 dgp Changed the second argument of FillRect() to be "&qd.black" instead of 
  148. "qd.black" for compatibility with Apple's redefinition of Pattern as a struct 
  149. instead of an array. This makes the call compatible with Apple's Universal Headers.
  150. 5/31/94    dgp    added (ConstPatternParam) cast to above, to retain compatibility
  151. with the old definition of Pattern.
  152. 9/5/94 dgp removed assumption in printf's that int==short.
  153. 11/17/94 dgp updated to use ChooseScreen. Added conditional code for CodeWarrior.
  154. */
  155. #include "VideoToolbox.h"
  156. #include <math.h>
  157. #include <assert.h>
  158. #include "Luminance.h"
  159. #include <Fonts.h>
  160. #include <Packages.h>
  161. #if (THINK_C || THINK_CPLUS)
  162.     #include <console.h>
  163. #endif
  164. #if __MWERKS__
  165.     #include <SIOUX.h>
  166. #endif
  167. #include "nr.h"            /* prototypes of Numerical Recipes and definition of FLOAT */
  168. #include "nrutil.h"
  169. #if UNIVERSAL_HEADERS
  170.     #include <LowMem.h>
  171. #else
  172.     #define LMGetMBarHeight() (* (short *) 0x0BAA)
  173.     #define LMSetMBarHeight(MBarHeightValue) ((* (short *) 0x0BAA) = (MBarHeightValue))
  174. #endif
  175. long InitializeLuminanceRecord(LuminanceRecord *LP,short flags);
  176.  
  177. #define AUTOMATIC        1    /*     =0:input reading by hand from the photometer to the terminal
  178.                                    =1: use A/D converter to read from the photometer directly */
  179. #define NLRGB            16    /* number of times to measure each RGB gain, should be >1*/
  180. #define LUMINANCES        32    /* approx. number of different luminances to measure */
  181. #define    NFRAME            60    /* number of frames per ADC luminance measurement */
  182. #define ROUND_LUMINANCES (2+(256+256/LUMINANCES-1)/(256/LUMINANCES))
  183.                             /* round LUMINANCES up to the next divisor of 256, add 2 */
  184.  
  185. void main(void);
  186. void CalibrateLuminance(void);
  187. void SaveData(LuminanceRecord *LP,int nL,int V[],double L[]
  188.     ,int nLrgb,int nrgb[3][NLRGB][3],double Lrgb[3][NLRGB],double gain[3]);
  189. void SaveLuminanceRecord(LuminanceRecord *LP);
  190. FLOAT PowerRMSError(FLOAT p[]);
  191. double GetALuminance(LuminanceRecord *LP,GDHandle device,
  192.     int frames,double LuminancePerVoltage,int entry,int red,int green,int blue);
  193. void LToVHunt(LuminanceRecord *LP,GDHandle device,CWindowPtr window,
  194.     double LuminancePerVoltage,int frames,double darkLuminance);
  195.  
  196. /* These variables are out here, as globals, so that PowerRMSError can access them directly */
  197. static int nL=ROUND_LUMINANCES;
  198. static double L[ROUND_LUMINANCES];    /* luminance at V[i] */
  199. static int V[ROUND_LUMINANCES];
  200. static int variables=4;
  201. static FLOAT *p;
  202.  
  203. void CalibrateLuminance(void);
  204.  
  205. void main(void)
  206. {
  207.     long system;
  208.     
  209.     Gestalt(gestaltSystemVersion,&system);
  210.     if(system<0x605)PrintfExit("Sorry, I need at least System 6.05.\n");
  211.     Require(gestalt8BitQD);
  212.     CalibrateLuminance();
  213. }
  214.  
  215. void CalibrateLuminance(void)
  216. {
  217.     int i,j,k,ii,bottom,screen;
  218.     short fontNumber;
  219.     char string[100];
  220.     Rect rect,testRect,labelRect;
  221.     GDHandle device=NULL,oldDevice=NULL;
  222.     WindowPtr window=NULL,oldWindow=NULL;
  223.     int nLrgb=NLRGB;
  224.     static double Lrgb[3][NLRGB];
  225.     static int nrgb[3][NLRGB][3];
  226.     double gain[3],luminancePerVoltage=1000.0;
  227.     static LuminanceRecord LR,*LP;
  228.     double *x,*y,*sig;                        // for polynomial fit
  229.     FLOAT *a,**u,**v,*w,**cvm,chisq;        // for polynomial fit
  230.     int ma;                                    // for polynomial fit
  231.     FLOAT **xi,ftol,fret;                    // for power law fit
  232.     int iter;                                // for power law fit
  233.     double e,f,VV,luminance,darkLuminance;
  234.     int readNumber,readTotal,isGray,testSize,cycles,frames,clutSize,mode;
  235.     Boolean automatic,skipRGB,yes;
  236.     char colorGray[2][8]={"color","gray"};
  237.     
  238.     assert(StackSpace()>4000);
  239.     automatic=AUTOMATIC && (CardSlot(".ForeRunner")>0);    /* disable if card is missing */
  240.     LP=&LR;
  241.     #if (THINK_C || THINK_CPLUS)
  242.         console_options.title="\pCalibrateLuminance";    /* change the console window */
  243.         console_options.nrows=12;
  244.         console_options.top=20;
  245.         console_options.left=1;
  246.         console_options.ncols=105;
  247.         console_options.txSize=9;
  248.         printf("\n");                                    /* ask THINK C to initialize QuickDraw */
  249.         CopyQuickDrawGlobals();                            // Make sure qd is valid.
  250.     #elif __MWERKS__
  251.         SIOUXSettings.toppixel=LMGetMBarHeight()+1;    // allow for menu bar only
  252.         SIOUXSettings.leftpixel=1;
  253.         SIOUXSettings.rows=12;
  254.         SIOUXSettings.columns=105;
  255.         SIOUXSettings.autocloseonquit=1;
  256.         SIOUXSettings.showstatusline=0;
  257.         SIOUXSettings.asktosaveonclose=0;
  258.         SIOUXSettings.fontsize=9;
  259.         printf("\n");
  260.     #else
  261.         InitGraf(&qd.thePort);
  262.         InitWindows();
  263.         InitFonts();
  264.     #endif
  265.  
  266.     printf("\n");    // make sure that oldWindow is the console
  267.     GetPort(&oldWindow);
  268.     oldDevice=GetGDevice();
  269.     SetPort(oldWindow);
  270.     SetGDevice(oldDevice);
  271.  
  272.     printf("Welcome to CalibrateLuminance version %s.\n\n"
  273.     "This program helps you to calibrate your ISR Video Attenuator, as well as your video card\n"
  274.     "and monitor. 'Enter' indicates that you should type in a number or letter followed by 'RETURN'.\n"
  275.     "Most questions provide a default answer (in parentheses).\n"
  276.     "Just hit 'RETURN' if you want the default. (Or hit Command-. to quit.)\n"
  277.     "Where appropriate, the default is taken from latest LuminanceRecord.\n",__DATE__);
  278.  
  279.     if(GetScreenDevice(1) == NULL)screen=0;
  280.     else do{
  281.         screen=1;
  282.         screen=ChooseScreen(screen,"Which screen do you want to calibrate?");
  283.     }while(GetScreenDevice(screen)==NULL);
  284.     if(screen==0){
  285.         #if __MWERKS__
  286.             MoveWindow(oldWindow,0,-100,1);
  287.         #endif
  288.     }
  289.     sprintf(string,"LuminanceRecord%d.h",screen);
  290.     InitializeLuminanceRecord(LP,0);
  291.     i=ReadLuminanceRecord(string,LP,0);        // try to read latest LuminanceRecord
  292.     if(i>0)printf("Successfully read old “%s” to set default values.\n",string);
  293.     else{
  294.         printf("Couldn't find an old copy of “%s”; creating new one from scratch.\n",string);
  295.         LR.dpi=76.0;    /* pixels per inch */
  296.         LP->units="cd/m^2";
  297.     }
  298.     LP->screen=screen;
  299.     LP->rangeSet=0;    /* indicate that range parameters have yet to be set */
  300.     LP->L.exists=0;    /* indicate that luminance table has yet to be initialized */
  301.     GetPort(&oldWindow);
  302.     oldDevice=GetGDevice();
  303.  
  304.     device=GetScreenDevice(LP->screen);        // choose which screen to test
  305.     window=GDOpenWindow1(device);
  306.     SendBehind(window,NULL);
  307.     LP->dacSize=GDDacSize(device);            // Takes 200 µs.
  308.     clutSize=GDClutSize(device);    
  309.     LP->VMin=0;
  310.     LP->VMax=(1L<<LP->dacSize)-1;    /* maximum value that can be loaded into DAC */
  311.     isGray=!TestDeviceAttribute(device,gdDevType);
  312.     printf("Test screen is set to %d colors and %s mode.\n",clutSize,colorGray[isGray]);
  313.     if(clutSize<4){
  314.         for(i=4;i<=32;i*=2){
  315.             mode=HasDepth(device,i,0,0);
  316.             if(mode!=0)break;
  317.         }
  318.         if(mode==0)PrintfExit("\n\007Sorry. This program cannot calibrate a display"
  319.             "with less than 4 colors/grays.");
  320.         printf("Changing screen depth to %d-bit pixels\n",i);
  321.         if(mode==0x100)PrintfExit(BreakLines("Sorry, the HasDepth routine doesn't work properly. "
  322.         "Use the Monitors Control Panel to set the colors/grays and then run "
  323.         "CalibrateLuminance again.\n",80));
  324.         SetDepth(device,mode,0,0);
  325.         clutSize=GDClutSize(device);    
  326.     }
  327.     if(isGray){
  328.         printf("Would you prefer color mode?");
  329.         yes=YesOrNo(0);
  330.         printf("\n");
  331.         if(yes){
  332.             if(HasDepth(device,(**(**device).gdPMap).pixelSize,1,1))
  333.                 SetDepth(device,(**device).gdMode,1,1);
  334.             else printf("Sorry, there is no color mode. Continuing in gray mode.\n");
  335.         }
  336.         isGray=!TestDeviceAttribute(device,gdDevType);
  337.     }
  338.     LP->Hz=GDFrameRate(device);
  339.     // printf("The test screen's frame rate is %.2f Hz\n",LP->Hz);
  340.     
  341.     if(isGray)skipRGB=1;
  342.     else{
  343.         printf("\nThere are two kinds of measurement:\n"
  344.         "1. Compulsory calibration of the (nonlinear) monitor's gamma function.\n"
  345.         "This will be affected by your choice of background luminance.\n"
  346.         "2. Optional calibration of the (linear) ISR Video Attenuator 3 channel gains.\n"
  347.         "This is independent of the background. It takes about 15 minutes.\n\n"
  348.         "Do you wish to skip 2., the optional three-channel calibration?");
  349.         skipRGB=YesOrNo(0);
  350.         printf("\n");
  351.     }
  352.     if(skipRGB)printf("Skipping 3 channel calibration.\n");
  353.     else printf("3 channels will be calibrated.\n");
  354.     
  355.     frames=0;
  356.     if(automatic){
  357.         frames=NFRAME;
  358.         printf("Taking photometer readings automatically.\n"
  359.             "Assuming %.3f milliVolts per %s\n",1000.0/luminancePerVoltage,LP->units);
  360.     }
  361.     else printf("Please enter the photometer readings,in %s, as prompted.\n",LP->units); 
  362.     printf("\n");
  363.  
  364.     printf("First let's check the photometer's gain setting.\n");
  365.     printf("Point the photometer at the screen and hit return:");
  366.     #if __MWERKS__
  367.         SelectWindow(oldWindow);
  368.     #endif
  369.     gets(string);
  370.     clutSize=GDClutSize(device);
  371.     do{
  372.         printf("\r");
  373.         SetPort(window);
  374.         BringToFront(window);
  375.         FillRect(&window->portRect,(ConstPatternParam)&qd.black);
  376.         darkLuminance=GetALuminance(LP,device,frames,luminancePerVoltage,clutSize-1,0,0,0);
  377.         FillRect(&window->portRect,(ConstPatternParam)&qd.white);
  378.         luminance=GetALuminance(LP,device,frames,luminancePerVoltage,0,LP->VMax,LP->VMax,LP->VMax);
  379.         luminance-=darkLuminance;
  380.         SendBehind(window,NULL);
  381.         printf("\rWhite seems to be %.1f %s brighter than black.\n",luminance,LP->units);
  382.         printf("Do you want to try that again?");
  383.     }while(YesOrNo(0));
  384.     printf("\n");
  385.  
  386.     printf("Please occlude the photometer so that I can read the dark level.\n"
  387.     "Hit cr when ready:");
  388.     #if __MWERKS__
  389.         SelectWindow(oldWindow);
  390.     #endif
  391.     gets(string);
  392.     darkLuminance=GetALuminance(LP,device,frames,luminancePerVoltage,0,LP->VMax,LP->VMax,LP->VMax);
  393.     printf("The dark level of %.2f cd/m^2 will be subtracted from all readings\n"
  394.         ,darkLuminance);
  395.     
  396.     testSize=160;
  397.     printf("Enter, in pixels, the diameter of the test patch (%d):",testSize);
  398.     #if __MWERKS__
  399.         SelectWindow(oldWindow);
  400.     #endif
  401.     gets(string);
  402.     sscanf((char *)string,"%d",&testSize);
  403.  
  404.     /* draw circle for placement of photocell */
  405.     SetPort(window);
  406.     rect=window->portRect;
  407.     InsetRect(&rect,(rect.right-testSize)/2,(rect.bottom-testSize)/2);
  408.     PmForeColor(255);
  409.     PenSize(10,10);
  410.     FrameOval(&rect);
  411.     SetPort(oldWindow);
  412.     
  413.     printf("Please remove the occluder. \n");
  414.     printf("Place your photometer so as to read the luminance of the "
  415.         "center of the test screen.\n"); 
  416.  
  417.     if(skipRGB)cycles=1;
  418.     else cycles=4;
  419.     printf("Then enter number of times you wish to repeat the whole cycle of measurement. (%d):"
  420.         ,cycles);
  421.     #if __MWERKS__
  422.         SelectWindow(oldWindow);
  423.     #endif
  424.     gets((char *)string);
  425.     sscanf((char *)string,"%d",&cycles);
  426.     if(cycles<=0)return;
  427.  
  428.     SetPort(window);
  429.     BringToFront(window);
  430.     FillRect(&window->portRect,(ConstPatternParam)&qd.gray);
  431.     luminance=GetALuminance(LP,device,frames,luminancePerVoltage,0,LP->VMax,LP->VMax,LP->VMax);
  432.     luminance-=darkLuminance;
  433.     printf("50%% dithered gray is %.1f %s\n",luminance,LP->units);
  434.     FillRect(&window->portRect,(ConstPatternParam)&qd.white);
  435.     luminance=GetALuminance(LP,device,frames,luminancePerVoltage,0,LP->VMax,LP->VMax,LP->VMax);
  436.     luminance-=darkLuminance;
  437.     printf("White is %.1f %s\n",luminance,LP->units);
  438.     FillRect(&window->portRect,(ConstPatternParam)&qd.black);
  439.     luminance=GetALuminance(LP,device,frames,luminancePerVoltage,0,LP->VMax,LP->VMax,LP->VMax);
  440.     luminance-=darkLuminance;
  441.     printf("Black is %.1f %s\n",luminance,LP->units);
  442.     SendBehind(window,NULL);
  443.  
  444.     printf("It is essential that the calibration be made with the same background\n"
  445.     "luminance as will ultimately be used in your experiments. You may specify the\n"
  446.     "background luminance either as a luminance in %s, or as a corresponding \n"
  447.     "DAC value (0..%d).\n",LP->units,(int)LP->VMax);
  448.     printf("Do you wish to enter a luminance?");
  449.     if(YesOrNo(1)){
  450.         printf("\nEnter the desired background luminance in %s (%f):",LP->units,LP->LBackground);
  451.         #if __MWERKS__
  452.             SelectWindow(oldWindow);
  453.         #endif
  454.         gets(string);
  455.         sscanf(string,"%lf",&LP->LBackground);
  456.         printf("Now hunting for the DAC value . . .\n");
  457.         LToVHunt(LP,device,(CWindowPtr)window,luminancePerVoltage,frames,darkLuminance);
  458.         printf("Will use the nearest DAC value, which is %hd\n",LP->VBackground);
  459.     }
  460.     else {
  461.         printf("\nEnter the DAC value for the background (%hd):",LP->VBackground);
  462.         #if __MWERKS__
  463.             SelectWindow(oldWindow);
  464.         #endif
  465.         gets(string);
  466.         sscanf((char *)string,"%hd",&LP->VBackground);
  467.     }
  468.     LP->table[2].rgb.red=LP->table[2].rgb.green=LP->table[2].rgb.blue=
  469.         LP->VBackground<<LP->leftShift;
  470.     LoadLuminances(device,LP,2,2);
  471.     SetPort(window);
  472.     BringToFront(window);
  473.     PmBackColor(2);
  474.     EraseRect(&window->portRect);
  475.     luminance=GetALuminance(LP,device,frames,luminancePerVoltage,0,LP->VMax,LP->VMax,LP->VMax);
  476.     luminance-=darkLuminance;
  477.     SendBehind(window,NULL);
  478.     SetPort(oldWindow);
  479.     printf("Your background luminance is %.3f %s\n",luminance,LP->units);
  480.  
  481.     /* plan the luminance and gain measurements */
  482.     if(skipRGB)nLrgb=0;
  483.     readTotal=cycles*(ROUND_LUMINANCES+3*nLrgb);
  484.     printf("Now taking %d readings . . .\n",readTotal);
  485.     for (i=0;i<nL;i++) L[i]=0.0;
  486.     k=0;
  487.     for (i=0;i<nL;i++){
  488.         V[i]=k;
  489.         if(k==LP->VMax) {
  490.             if(i+1<nL) V[++i]=k;    /* put two points at VMax, because it's important */
  491.             nL=i+1;
  492.             break;
  493.         }
  494.         k += (LP->VMax+1)/(nL-2);
  495.         if(k>LP->VMax)k=LP->VMax;
  496.     }
  497.     for (k=0;k<3;k++)for(i=0;i<nLrgb;i+=2){
  498.         for(j=0;j<3;j++) nrgb[k][i+1][j]=nrgb[k][i][j]=(LP->VMax+1)*(0.667+0.333*i/nLrgb);
  499.         nrgb[k][i+1][k]=LP->VMax;
  500.         nrgb[k][i][k]=0;
  501.         if(k==2) nrgb[k][i][k]=(LP->VMax+1)/2;    /* take smaller step, because blue gain is highest */
  502.     }
  503.     for(k=0;k<3;k++)for (i=0;i<nLrgb;i++)Lrgb[k][i]=0.0;
  504.     
  505.     /* measure several times to minimize the effect of luminance drift */
  506.     SetPort(window);
  507.     BringToFront(window);
  508.     GetFNum("\pMonaco",&fontNumber);
  509.     TextFont(fontNumber);
  510.     TextSize(36);
  511.     rect=window->portRect;
  512.     bottom=rect.bottom;
  513.     SetRect(&testRect, (rect.right+rect.left-testSize)/2
  514.         ,(rect.top+rect.bottom-testSize)/2
  515.         ,(rect.right+rect.left+testSize)/2
  516.         ,(rect.top+rect.bottom+testSize)/2 );
  517.     
  518.     /* set up background */
  519.     LP->table[2].rgb.red=LP->table[2].rgb.green=LP->table[2].rgb.blue=
  520.         LP->VBackground<<LP->leftShift;
  521.     LoadLuminances(device,LP,1,2);    /* load background into clut */
  522.     PmBackColor(2);                /* our background */
  523.     EraseRect(&rect);
  524.     PmBackColor(1);                /* our test luminance */
  525.     EraseOval(&testRect);
  526.     FlushEvents(everyEvent,0);
  527.     readNumber=0;    /* initialize to count the number of reading */
  528.     for(j=0;j<cycles;j++)    {
  529.         for (k=-1;k<3;k++)    {
  530.             if(k<0) ii=nL;
  531.             else ii=nLrgb;
  532.             for (i=0;i<ii;i++){
  533.                 /* set up test */
  534.                 SetRect(&labelRect,0,bottom-40,300,bottom);
  535.                 SetPort(window);
  536.                 PmBackColor(2);
  537.                 EraseRect(&labelRect);
  538.                 PmForeColor(clutSize-1);                /* black */
  539.                 MoveTo(0,bottom);
  540.                 if(k<0) DrawPrintf("%3d",V[i]);
  541.                 else DrawPrintf("%3d%4d%4d",k,nrgb[k][i][0],nrgb[k][i][1],nrgb[k][i][2]);
  542.                 SetPort(oldWindow);
  543.                 readNumber++;
  544.                 if(!automatic){
  545.                     printf("%d out of %d readings:\t",readNumber,readTotal);    
  546.                 }
  547.                 if(k<0) {
  548.                     luminance=GetALuminance(LP,device,frames,luminancePerVoltage,1
  549.                         ,V[i],V[i],V[i]);
  550.                     luminance-=darkLuminance;
  551.                     L[i] += luminance/cycles;
  552.                 }
  553.                 else {
  554.                     luminance=GetALuminance(LP,device,frames,luminancePerVoltage,1
  555.                         ,nrgb[k][i][0],nrgb[k][i][1],nrgb[k][i][2]);
  556.                     luminance-=darkLuminance;
  557.                     Lrgb[k][i] += luminance/cycles;
  558.                 }
  559.             }
  560.         }
  561.     }
  562.     GDDisposeWindow1(window);
  563.     SetPort(oldWindow);
  564.     SetGDevice(oldDevice);
  565.     
  566.     /* polynomial and quadratic fits */
  567.     ma=MAX_COEFFICIENTS;
  568.     x=vector(1,nL);
  569.     y=vector(1,nL);
  570.     sig=vector(1,nL);
  571.     a=vector(1,nL);
  572.     u=matrix(1,nL,1,ma);
  573.     v=matrix(1,ma,1,ma);
  574.     w=vector(1,ma);
  575.     cvm=matrix(1,ma,1,ma);
  576.     for(i=0;i<nL;i++){
  577.         x[i+1]=V[i];
  578.         y[i+1]=L[i];
  579.         sig[i+1]=10.0;
  580.     }
  581.     svdfit(x,y,sig,nL,a,ma,u,v,w,&chisq,fpoly);    /* ma-1th order polynomial curve fit */
  582.     svdvar(v,ma,w,cvm);
  583.     if(ma>MAX_COEFFICIENTS)PrintfExit("Error: too many coefficients\007\n");
  584.     LP->coefficients=ma;
  585.     for(i=0;i<ma;i++) LP->p[i]=a[i+1];
  586.     printf("L(V) =");
  587.     for(i=0;i<ma;i++) printf(" + %6g V^%d",a[i+1],i);
  588.     printf(".  chisq %g\n",chisq);
  589.     svdfit(x,y,sig,nL,a,3,u,v,w,&chisq,fpoly);    /* 2nd order polynomial curve fit */
  590.     svdvar(v,3,w,cvm);
  591.     printf("\nquadratic fit:\n\n");
  592.     for(i=0;i<3;i++) LP->q[i]=a[i+1];
  593.     printf("L(V) =");
  594.     for(i=0;i<3;i++) printf(" + %g V^%d",a[i+1],i);
  595.     printf(".  chisq %g\n",chisq);
  596.     free_vector(x,1,nL);
  597.     free_vector(y,1,nL);
  598.     free_vector(sig,1,nL);
  599.     free_vector(a,1,nL);
  600.     free_matrix(u,1,nL,1,ma);
  601.     free_matrix(v,1,ma,1,ma);
  602.     free_vector(w,1,ma);
  603.     free_matrix(cvm,1,ma,1,ma);
  604.     e=0.0;
  605.     for(i=0;i<nL;i++){
  606.         f=0.0;
  607.         VV=1.0;
  608.         for(j=0;j<LP->coefficients;j++){
  609.             f+=LP->p[j]*VV;
  610.             VV*=V[i];
  611.         }
  612.         e+=(L[i]-f)*(L[i]-f);
  613.     }
  614.     LP->polynomialError=sqrt(e/nL);
  615.     e=0.0;
  616.     for(i=0;i<nL;i++){
  617.         f=0.0;
  618.         VV=1.0;
  619.         for(j=0;j<3;j++){
  620.             f+=LP->q[j]*VV;
  621.             VV*=V[i];
  622.         }
  623.         e+=(L[i]-f)*(L[i]-f);
  624.     }
  625.     LP->quadraticError=sqrt(e/nL);
  626.     
  627.     /* power law fit */
  628.     /* L=p[1]+Rectify(p[2]+p[3]*V)^p[4] */
  629.     p=vector(1,4);    /* initial starting point */
  630.     /*
  631.         It is necessary to have a reasonable starting point or the search can get
  632.         stuck out in the boondocks. Since the search is quite slow it is desirable to
  633.         give it as good a starting point as possible. Therefore I make use of the
  634.         quadratic fit to try to give it a pretty good starting point.
  635.     */
  636.     /* use the quadratic fit as the starting point */
  637.     p[1]=LP->q[0]-0.25*LP->q[1]*LP->q[1]/LP->q[2];
  638.     p[2]=0.5*LP->q[1]/sqrt(LP->q[2]);
  639.     p[3]=sqrt(LP->q[2]);
  640.     p[4]=2.0;
  641.     /*
  642.         On second thought, try starting with a gamma of 2.3.
  643.         Set the luminance offset p[1] to the measured dc level.
  644.         Set the brightness p[2] so as to match the number offset in the quadratic fit.
  645.         Set the contrast p[3] so as to fit the maximum data point.
  646.         Set gamma p[4] to 2.3
  647.     */
  648.     p[1]=L[1];
  649.     p[2]=0.5*LP->q[1]/sqrt(LP->q[2]);
  650.     p[4]=2.3;
  651.     p[3]=(pow(L[nL-1]-p[1],1.0/p[4])-p[2])/V[nL-1];
  652.     p[2]=p[3]*0.5*LP->q[1]/LP->q[2];
  653.     p[3]=(pow(L[nL-1]-p[1],1.0/p[4])-p[2])/V[nL-1];
  654.     xi=matrix(1,4,1,4);    /* initial set of directions */
  655.     for(i=1;i<=4;i++)for(j=1;j<=4;j++)xi[i][j]=0.0;
  656.     xi[1][1]=0.1;
  657.     xi[2][2]=1.0;
  658.     xi[3][3]=0.1;
  659.     xi[4][4]=0.01;
  660.     ftol=1e-2;    /* fractional tolerance on function value when done */
  661.     printf("\npower law fit:\n\n");
  662.     variables=4;    /* inform PowerRMSError */
  663.     fret=PowerRMSError(p);
  664.     printf("L(V) = %9.4f + Rectify(%9.4f + %9.4f V)^%9.4f ± %9.4f\n",p[1],p[2],p[3],p[4],fret);
  665.     powell(p,xi,4,ftol,&iter,&fret,&PowerRMSError);
  666.     printf("L(V) = %9.4f + Rectify(%9.4f + %9.4f V)^%9.4f ± %9.4f\n",p[1],p[2],p[3],p[4],fret);
  667.     for(i=0;i<4;i++) LP->power[i]=p[i+1];
  668.     free_vector(p,1,4);
  669.     free_matrix(xi,1,4,1,4);
  670.     e=0.0;
  671.     for(i=0;i<nL;i++){
  672.         f=LP->power[1]+LP->power[2]*V[i];
  673.         if(f>0.0) f=LP->power[0]+pow(f,LP->power[3]);
  674.         else f=LP->power[0];
  675.         e+=(L[i]-f)*(L[i]-f);
  676.     }
  677.     LP->powerError=sqrt(e/nL);
  678.     LP->VMin=0;                    /* minimum value that can be loaded into DAC */
  679.     LP->VMax=(1L<<LP->dacSize)-1;    /* maximum value that can be loaded into DAC */
  680.     LP->LMin=VToL(LP,LP->VMin);    /* min luminance */
  681.     LP->LMax=VToL(LP,LP->VMax);    /* max luminance */
  682.     
  683.     /* power law fit with a FIXED gamma */
  684.     /* This is solely for study of the effects of the contrast and brightness knobs */
  685.     /* L=p[1]+Rectify(p[2]+p[3]*V)^p[4] */
  686.     p=vector(1,4);    /* initial starting point */
  687.     /*
  688.         It is necessary to have a reasonable starting point or the search can get
  689.         stuck out in the boondocks. Since the search is quite slow it is desirable to
  690.         give it as good a starting point as possible. 
  691.     */
  692.     for(i=0;i<4;i++)p[i+1]=LP->power[i];
  693.     p[4]=2.28;
  694.     xi=matrix(1,3,1,3);    /* initial set of directions */
  695.     for(i=1;i<=3;i++)for(j=1;j<=3;j++)xi[i][j]=0.0;
  696.     xi[1][1]=0.1;
  697.     xi[2][2]=1.0;
  698.     xi[3][3]=0.1;
  699.     ftol=1e-2;        /* fractional tolerance on function value when done */
  700.     variables=3;    /* global, to inform PowerRMSError() */
  701.     printf("\npower law fit, with fixed gamma:\n\n");
  702.     fret=PowerRMSError(p);
  703.     printf("L(V) = %9.4f + Rectify(%9.4f + %9.4f V)^%9.4f ± %9.4f\n",p[1],p[2],p[3],p[4],fret);
  704.     powell(p,xi,3,ftol,&iter,&fret,&PowerRMSError);
  705.     printf("L(V) = %9.4f + Rectify(%9.4f + %9.4f V)^%9.4f ± %9.4f\n",p[1],p[2],p[3],p[4],fret);
  706.     for(i=0;i<4;i++) LP->fixedPower[i]=p[i+1];
  707.     free_vector(p,1,4);
  708.     free_matrix(xi,1,3,1,3);
  709.     e=0.0;
  710.     for(i=0;i<nL;i++){
  711.         f=LP->fixedPower[1]+LP->fixedPower[2]*V[i];
  712.         if(f>0.0) f=LP->fixedPower[0]+pow(f,LP->fixedPower[3]);
  713.         else f=LP->fixedPower[0];
  714.         e += (L[i]-f)*(L[i]-f);
  715.     }
  716.     LP->fixedPowerError=sqrt(e/nL);
  717.     
  718.     if(skipRGB){
  719.         if(isGray){
  720.             LP->r=LP->b=0.0;
  721.             LP->g=1.0;
  722.         }else{
  723.             printf("Please enter gain of red channel   (%6.4f):",LP->r);
  724.             #if __MWERKS__
  725.                 SelectWindow(oldWindow);
  726.             #endif
  727.             gets(string);
  728.             sscanf((char *)string,"%lf",&LP->r);
  729.             printf("Please enter gain of green channel (%6.4f):",LP->g);
  730.             #if __MWERKS__
  731.                 SelectWindow(oldWindow);
  732.             #endif
  733.             gets(string);
  734.             sscanf((char *)string,"%lf",&LP->g);
  735.             printf("Please enter gain of blue channel  (%6.4f):",LP->b);
  736.             #if __MWERKS__
  737.                 SelectWindow(oldWindow);
  738.             #endif
  739.             gets(string);
  740.             sscanf((char *)string,"%lf",&LP->b);
  741.         }
  742.         gain[0]=LP->r;
  743.         gain[1]=LP->g;
  744.         gain[2]=LP->b;
  745.     }
  746.     else {    
  747.         /* calculate R,G,B gains */
  748.         for(k=0;k<3;k++){
  749.             gain[k]=0.0;
  750.             for(i=0;i<nLrgb;i+=2)
  751.                 gain[k]+=(LToV(LP,Lrgb[k][i])-LToV(LP,Lrgb[k][i+1]))/(nrgb[k][i][k]-nrgb[k][i+1][k]);
  752.             gain[k] /= nLrgb/2;
  753.             printf("gain[%d]=%6.4f\n",k,gain[k]);
  754.         }
  755.     }
  756.     printf("Sum of gains %6.4f\n",gain[0]+gain[1]+gain[2]);
  757.     LP->r=gain[0]/(gain[0]+gain[1]+gain[2]);        /* Normalize gain */
  758.     LP->g=gain[1]/(gain[0]+gain[1]+gain[2]);
  759.     LP->b=gain[2]/(gain[0]+gain[1]+gain[2]);
  760.     e=1.0-(gain[0]+gain[1]+gain[2]);
  761.     if(skipRGB && fabs(e)<1e-6){
  762.         printf("Please enter gain accuracy   (%6.4f):",LP->gainAccuracy);
  763.         #if __MWERKS__
  764.             SelectWindow(oldWindow);
  765.         #endif
  766.         gets(string);
  767.         sscanf((char *)string,"%lf",&LP->gainAccuracy);
  768.     }
  769.     else LP->gainAccuracy=e;
  770.     LP->LBackground=VToL(LP,LP->VBackground);
  771.     LP->gm=(LP->VMax/(2.0*LP->LBackground))
  772.         *(LP->LBackground-VToL(LP,LToV(LP,LP->LBackground)-1.0));
  773.     
  774.     SaveData(LP,nL,V,L,nLrgb,nrgb,Lrgb,gain);
  775.     #if __MWERKS__
  776.         SelectWindow(oldWindow);
  777.     #endif
  778.     SaveLuminanceRecord(LP);
  779.     printf(
  780.         "Congratulations! You've finished the luminance calibration of screen %hd. The calibration results\n"
  781.         "have been saved as CalibrateLuminance%hd.data and LuminanceRecord%hd.h.\n\n"
  782.         
  783.         "The CalibrateLuminance%hd.data file is a text file suitable for graphing the monitor's gamma function.\n"
  784.         "We recommend using CricketGraph with the CalibrateLuminance.format. The V column is the equivalent\n"
  785.         "number loaded into the clut (V=%hd*v), and the L column is the measured luminance.\n\n"
  786.         
  787.         "The program's results have also been stored in a C header file called LuminanceRecord%hd.h that all\n"
  788.         "your programs should read by using either #include at compile time, or ReadLuminanceRecord() at\n"
  789.         "runtime. LuminanceRecord%hd.h describes the gains of the three video pathways of your video card and\n"
  790.         "ISR Video Attenuator, and describes the gamma function of your monitor, to allow automatic gamma\n"
  791.         "correction later, using SetLuminance(), etc. See Pelli & Zhang (1991) Vision Research 31:1337-1360.\n"
  792.         "Hit RETURN to exit. Good luck.\n"
  793.         ,LP->screen,LP->screen,LP->screen,LP->screen,LP->VMax,LP->screen,LP->screen
  794.     );
  795. }
  796.  
  797. void SaveData(LuminanceRecord *LP,int nL,int V[],double L[]
  798.     ,int nLrgb,int nrgb[3][NLRGB][3],double Lrgb[3][NLRGB],double gain[3])
  799. /* create Cricket data file, to graph the gamma function */
  800. {
  801.     FILE *myfile;
  802.     int i,j,k;
  803.     double VV,LFit;
  804.     static char fileName[80];
  805.     
  806.     sprintf(fileName,"LuminanceCalibration%hd.data",LP->screen);
  807.     myfile=fopen(fileName,"w");
  808.     SetFileInfo(fileName,'TEXT','CGRF');
  809.     fprintf(myfile,"*\n");
  810.     fprintf(myfile,"V\tL \tV(L) ");
  811.     fprintf(myfile,"\tquadratic\tpolynomial\tpower ");
  812.     fprintf(myfile,"\tL-quadratic\tL-polynomial\tL-power ");
  813.     fprintf(myfile,"\tVr \tVg \tVb ");
  814.     fprintf(myfile,"\tLr \tLg \tLb \tV(Lr) \tV(Lg) \tV(Lb) ");
  815.     fprintf(myfile,"\tLR.r\tLR.g \tLR.b \tsum of gains");
  816.     for(i=0;i<nL;i++)    {
  817.         fprintf(myfile,"\n%d\t",V[i]);
  818.         fprintf(myfile,"%9.4g\t",L[i]);
  819.         fprintf(myfile,"%9.4g\t",LToV(LP,L[i]));
  820.         /* quadratic fit */
  821.         LFit=0.0;
  822.         VV=1.0;
  823.         for(j=0;j<3;j++){
  824.             LFit += LP->q[j]*VV;
  825.             VV *= V[i];
  826.         }
  827.         fprintf(myfile,"%9.4g\t",LFit);
  828.         /* polynomial fit */
  829.         LFit=0.0;
  830.         VV=1.0;
  831.         for(j=0;j<LP->coefficients;j++){
  832.             LFit += LP->p[j]*VV;
  833.             VV *= V[i];
  834.         }
  835.         fprintf(myfile,"%9.4g\t",LFit);
  836.         /* power law fit */
  837.         LFit=LP->power[1]+LP->power[2]*V[i];
  838.         if(LFit>0.0) LFit=LP->power[0]+pow(LFit,LP->power[3]);
  839.         else LFit=LP->power[0];
  840.         fprintf(myfile,"%9.4g\t",LFit);
  841.  
  842.         /* quadratic fit */
  843.         LFit=0.0;
  844.         VV=1.0;
  845.         for(j=0;j<3;j++){
  846.             LFit += LP->q[j]*VV;
  847.             VV *= V[i];
  848.         }
  849.         fprintf(myfile,"%9.4g\t",L[i]-LFit);
  850.         /* polynomial fit */
  851.         LFit=0.0;
  852.         VV=1.0;
  853.         for(j=0;j<LP->coefficients;j++){
  854.             LFit += LP->p[j]*VV;
  855.             VV *= V[i];
  856.         }
  857.         fprintf(myfile,"%9.4g\t",L[i]-LFit);
  858.         /* power law fit */
  859.         LFit=LP->power[1]+LP->power[2]*V[i];
  860.         if(LFit>0.0) LFit=LP->power[0]+pow(LFit,LP->power[3]);
  861.         else LFit=LP->power[0];
  862.         fprintf(myfile,"%9.4g\t",L[i]-LFit);
  863.  
  864.         if(i<nLrgb) for(k=0;k<3;k++) {
  865.             VV=LP->r*nrgb[k][i][0]+LP->g*nrgb[k][i][1]+LP->b*nrgb[k][i][2];
  866.             fprintf(myfile,"%f\t",VV);
  867.         }
  868.         if(i<nLrgb) for(k=0;k<3;k++) fprintf(myfile,"%f\t",Lrgb[k][i]);
  869.         if(i<nLrgb) for(k=0;k<3;k++) fprintf(myfile,"%f\t",LToV(LP,Lrgb[k][i]));
  870.         if(i==0) fprintf(myfile,"%6g\t%6g\t%6g\t%6g",LP->r,LP->g,LP->b
  871.                 ,gain[0]+gain[1]+gain[2]);
  872.     }
  873.     fclose(myfile);
  874. }
  875.  
  876. #if 1
  877. void SaveLuminanceRecord(LuminanceRecord *LP)
  878. /* Create C header file "LuminanceRecord?.h", where ? is the screen number. */
  879. {
  880.     FILE *file;
  881.     int i;
  882.     static char string[100],filename[100],dateString[100];
  883.     long seconds;
  884.     
  885.     LP->VMin=0;
  886.     LP->VMax=(1L<<LP->dacSize)-1;    /* maximum value that can be loaded into DAC */
  887.     LP->LMin=VToL(LP,LP->VMin);        /* min luminance */
  888.     LP->LMax=VToL(LP,LP->VMax);        /* max luminance */
  889.     LP->L.exists=0;
  890.     sprintf(filename,"LuminanceRecord%hd.h",LP->screen);
  891.     GetDateTime((void *)&seconds);
  892.     printf("Please enter the following descriptive information for the %s file.\n",filename);
  893.  
  894.     /* time and date */
  895.     IUDateString(seconds,longDate,(unsigned char *)string);
  896.     p2cstr((unsigned char *)string);
  897.     IUTimeString(seconds,FALSE,(unsigned char *)dateString);
  898.     p2cstr((unsigned char *)dateString);
  899.     sprintf(dateString,"%s %s",dateString,string);
  900.     LP->date=dateString;
  901.     printf("LR.date=\"%s\";\n",LP->date);    
  902.  
  903.     printf("Enter LR.id, i.e. monitor model and serial # (%s):",LP->id);
  904.     gets(string);
  905.     if(strlen(string)>0)strcpy(LP->id=malloc(strlen(string)+1),string);
  906.     printf("%s\n",LP->id);
  907.  
  908.     printf("Enter LR.name, i.e. informal monitor name \n(%s):",LP->name);
  909.     gets(string);
  910.     if(strlen(string)>0)strcpy(LP->name=malloc(strlen(string)+1),string);
  911.     printf("%s\n",LP->name);
  912.  
  913.     printf("Enter LR.notes, i.e. details of calibration: who & how\n(%s):\n",LP->notes);
  914.     gets(string);
  915.     if(strlen(string)>0) strcpy(LP->notes=malloc(strlen(string)+1),string);
  916.     printf("%s\n",LP->notes);
  917.  
  918.     printf("Nominally, the Apple High-Res. Monochrome Monitor has 76 pixels/inch.\n");
  919.     printf("Nominally, the Apple High-Res. RGB Monitor has 69 pixels/inch.\n");
  920.     printf("Enter LR.dpi, i.e. pixels per inch (%.1f):",LP->dpi);
  921.     gets(string);
  922.     sscanf(string,"%lf",&LP->dpi);
  923.     printf("%.1f\n",LP->dpi);
  924.  
  925.     printf("Enter LR.units luminance units (%s):",LP->units);
  926.     gets(string);
  927.     if(strlen(string)>0)strcpy(LP->units=malloc(strlen(string)+1),string);
  928.     printf("%s\n",LP->units);
  929.  
  930.     // Write comment at top of file.
  931.     file=fopen(filename,"w");
  932.     fprintf(file,"/* This %s file is a description of a monitor produced by the CalibrateLuminance program. */\n",filename);
  933.     fprintf(file,"/* This file may be #included in any C program. It simply fills in a LuminanceRecord data structure. */\n");
  934.     fprintf(file,"/* Or use ReadLuminanceRecord.c to read this file at runtime. */\n");
  935.     fprintf(file,"/* The theory is described by Pelli & Zhang (1991). The data structure is defined in Luminance.h.  */\n");
  936.     fprintf(file,"/* CalibrateLuminance and Luminance.h are part of the VideoToolbox software. */\n");
  937.     fprintf(file,"/* Pelli & Zhang (1991) Accurate control of contrast on microcomputer displays. */\n");
  938.     fprintf(file,"/* Vision Research, 31:1337-1360. */\n");
  939.     fprintf(file,"/* The VideoToolbox software is available, free for research purposes, from Denis Pelli. */\n");
  940.     fprintf(file,"/* Institute for Sensory Research, Syracuse University, Syracuse, NY 13244-5290. */\n");
  941.     fprintf(file,"/* Caution: the screen number used here and in GetScreen Device is NOT the same as */\n");
  942.     fprintf(file,"/* displayed by the Monitors cdev in the Control Panel. */\n");
  943.     fclose(file);
  944.     i=WriteLuminanceRecord(filename,LP,0);// assignNoPrintfExit
  945.     // if(i<0)printf("WARNING: WriteLuminanceRecord returned error %d\n",i);
  946. }
  947. #else
  948. {
  949.     FILE *file;
  950.     int i;
  951.     static char string[100],dateString[100];
  952.     long seconds;
  953.     
  954.     LP->VMin=0;
  955.     LP->VMax=(1L<<LP->dacSize)-1;    /* maximum value that can be loaded into DAC */
  956.     LP->LMin=VToL(LP,LP->VMin);        /* min luminance */
  957.     LP->LMax=VToL(LP,LP->VMax);        /* max luminance */
  958.     sprintf(string,"LuminanceRecord%hd.h",LP->screen);
  959.     GetDateTime((void *)&seconds);
  960.     file=fopen(string,"w");
  961.     SetFileInfo(string,'TEXT','KAHL');
  962.     printf("Please enter the following descriptive information for the %s file.\n",string);
  963.  
  964.     fprintf(file,"/* This %s file is a description of a monitor produced by the CalibrateLuminance program. */\n",string);
  965.     fprintf(file,"/* This file may be #included in any C program. It simply fills in a LuminanceRecord data structure. */\n");
  966.     fprintf(file,"/* Or use ReadLuminanceRecord.c to read this file at runtime. */\n");
  967.     fprintf(file,"/* The theory is described by Pelli & Zhang (1991). The data structure is defined in Luminance.h.  */\n");
  968.     fprintf(file,"/* CalibrateLuminance and Luminance.h are part of the VideoToolbox software. */\n");
  969.     fprintf(file,"/* Pelli & Zhang (1991) Accurate control of contrast on microcomputer displays. */\n");
  970.     fprintf(file,"/* Vision Research, 31:1337-1360. */\n");
  971.     fprintf(file,"/* The VideoToolbox software is available, free for research purposes, from Denis Pelli. */\n");
  972.     fprintf(file,"/* Institute for Sensory Research, Syracuse University, Syracuse, NY 13244-5290. */\n");
  973.     fprintf(file,"/* Caution: the screen number used here and in GetScreen Device is NOT the same as */\n");
  974.     fprintf(file,"/* displayed by the Monitors cdev in the Control Panel. Sorry. The most obvious difference */\n");
  975.     fprintf(file,"/* is that GetScreenDevice always assigns 0 to the main screen, the one with the menu bar. */\n");
  976.     fprintf(file,"LR.screen=%hd;    /* device=GetScreenDevice(LR.screen); */\n"
  977.         ,LP->screen);
  978.     /* time and date */
  979.     IUDateString(seconds,longDate,(unsigned char *)string);
  980.     p2cstr((unsigned char *)string);
  981.     IUTimeString(seconds,FALSE,(unsigned char *)dateString);
  982.     p2cstr((unsigned char *)dateString);
  983.     sprintf(dateString,"%s %s",dateString,string);
  984.     LP->date=dateString;
  985.     fprintf(file,"LR.date=\"%s\";\n",LP->date);
  986.     printf("LR.date=\"%s\";\n",LP->date);    
  987.  
  988.     printf("Enter LR.id, i.e. monitor model and serial # (%s):",LP->id);
  989.     #if __MWERKS__
  990.         SelectWindow(oldWindow);
  991.     #endif
  992.     gets(string);
  993.     if(strlen(string)>0)strcpy(LP->id=malloc(strlen(string)+1),string);
  994.     printf("%s\n",LP->id);
  995.     fprintf(file,"LR.id=\"%s\";\n",LP->id);
  996.  
  997.     printf("Enter LR.name, i.e. informal monitor name \n(%s):",LP->name);
  998.     gets(string);
  999.     if(strlen(string)>0)strcpy(LP->name=malloc(strlen(string)+1),string);
  1000.     printf("%s\n",LP->name);
  1001.     fprintf(file,"LR.name=\"%s\";\n",LP->name);
  1002.  
  1003.     printf("Enter LR.notes, i.e. details of calibration: who & how\n(%s):\n",LP->notes);
  1004.     gets(string);
  1005.     if(strlen(string)>0) strcpy(LP->notes=malloc(strlen(string)+1),string);
  1006.     printf("%s\n",LP->notes);
  1007.     fprintf(file,"LR.notes=\"%s\";\n",LP->notes);
  1008.  
  1009.     printf("Nominally, the Apple High-Res. Monochrome Monitor has 76 pixels/inch.\n");
  1010.     printf("Nominally, the Apple High-Res. RGB Monitor has 69 pixels/inch.\n");
  1011.     printf("Enter LR.dpi, i.e. pixels per inch (%.1f):",LP->dpi);
  1012.     gets(string);
  1013.     sscanf(string,"%lf",&LP->dpi);
  1014.     printf("%.1f\n",LP->dpi);
  1015.     fprintf(file,"LR.dpi=%.1f;\t/* pixels per inch */\n",LP->dpi);
  1016.  
  1017.     fprintf(file,"LR.Hz=%.2f;\t/* frames per second */\n",LP->Hz);
  1018.  
  1019.     printf("Enter LR.units luminance units (%s):",LP->units);
  1020.     gets(string);
  1021.     if(strlen(string)>0)strcpy(LP->units=malloc(strlen(string)+1),string);
  1022.     printf("%s\n",LP->units);
  1023.     fprintf(file,"LR.units=\"%s\";\n",LP->units);
  1024.  
  1025.     fprintf(file,"/* coefficients of polynomial fit */\n");
  1026.     fprintf(file,"LR.coefficients=%ld;    /* # of coefficients in polynomial fit */\n"
  1027.         ,LP->coefficients);
  1028.     fprintf(file,"/* L(V)=p[0]+p[1]*V+p[2]*V*V+ . . . ±polynomialError */\n");
  1029.     for(i=0;i<LP->coefficients;i++)    {
  1030.         fprintf(file,"LR.p[%d]=%6g;\n",i,LP->p[i]);
  1031.     }
  1032.     fprintf(file,"LR.polynomialError=%8.4f;    /* RMS error of fit */\n",LP->polynomialError);
  1033.     fprintf(file,"/* coefficients of quadratic fit */\n");
  1034.     fprintf(file,"/* L(V)=q[0]+q[1]*V+q[2]*V*V±quadraticError */\n");
  1035.     for(i=0;i<3;i++)    {
  1036.         fprintf(file,"LR.q[%d]=%6g;\n",i,LP->q[i]);
  1037.     }
  1038.     fprintf(file,"LR.quadraticError=%8.4f;    /* RMS error of fit */\n",LP->quadraticError);
  1039.     fprintf(file,"/* coefficients of power law fit */\n");
  1040.     fprintf(file,"/* L(V)=power[0]+Rectify(power[1]+power[2]*V)^power[3]±powerError */\n");
  1041.     fprintf(file,"/* where Rectify(x)=x if x≥0, and Rectify(x)=0 otherwise */\n");
  1042.     fprintf(file,"/* Pelli & Zhang (1991) Eqs.9&10 use symbols v=V/VMax, alpha=power[0], beta=power[1], kappa=power[2]*255, gamma=power[3] */\n");
  1043.     for(i=0;i<4;i++)    {
  1044.         fprintf(file,"LR.power[%d]=%6g;\n",i,LP->power[i]);
  1045.     }
  1046.     fprintf(file,"LR.powerError=%8.4f;    /* RMS error of fit */\n",LP->powerError);
  1047.     fprintf(file,"/* coefficients of power law fit, with fixed exponent */\n");
  1048.     fprintf(file,"/* L(V)=fixedPower[0]+Rectify(fixedPower[1]+fixedPower[2]*V)^fixedPower[3]±fixedPowerError */\n");
  1049.     for(i=0;i<4;i++)    {
  1050.         fprintf(file,"LR.fixedPower[%d]=%6g;\n",i,LP->fixedPower[i]);
  1051.     }
  1052.     fprintf(file,"LR.fixedPowerError=%8.4f;    /* RMS error of fit */\n",LP->fixedPowerError);
  1053.     fprintf(file,"LR.r=%6g;\n",LP->r);
  1054.     fprintf(file,"LR.g=%6g;\n",LP->g);
  1055.     fprintf(file,"LR.b=%6g;\n",LP->b);
  1056.     fprintf(file,"LR.gainAccuracy=%6g;\n",LP->gainAccuracy);
  1057.     fprintf(file,"LR.gm=%6g;    /* The monitor's contrast gain. */\n",LP->gm);
  1058.     fprintf(file,"LR.dacSize=%hd;    /* bits */\n",LP->dacSize);
  1059.     fprintf(file,"LR.VMin=%3d;    /* minimum value that can be loaded into DAC */\n",LP->VMin);
  1060.     fprintf(file,"LR.VMax=%3d;    /* maximum value that can be loaded into DAC */\n",LP->VMax);
  1061.     fprintf(file,"LR.LMin=%8.2f;    /* luminance at VMin */\n",LP->LMin);
  1062.     fprintf(file,"LR.LMax=%8.2f;    /* luminance at VMax */\n",LP->LMax);
  1063.     fprintf(file,"LR.LBackground=%8.3f;    /* background luminance during calibration */\n",LP->LBackground);
  1064.     fprintf(file,"LR.VBackground=%hd;    /* background number used during calibration */\n",LP->VBackground);
  1065.     fprintf(file,"LR.rangeSet=0;    /* indicate that range parameters have yet to be set */\n");
  1066.     fprintf(file,"LR.L.exists=0;    /* indicate that luminance table has yet to be initialized */\n");
  1067.     fclose(file);
  1068. }
  1069. #endif
  1070.  
  1071. FLOAT PowerRMSError(FLOAT pp[])
  1072. /*
  1073. Returns average squared error of power law fit.
  1074. pp[] contains the parameters of a power law fit to the
  1075. luminance measurements L[] made at numbers V[].
  1076. */
  1077. {
  1078.     int i;
  1079.     FLOAT f,e,a;
  1080.     extern double L[];
  1081.     extern int V[];
  1082.     extern int nL;
  1083.     extern int variables;
  1084.     extern FLOAT *p;
  1085.     static FLOAT q[5];
  1086.     
  1087.     for(i=1;i<=variables;i++)q[i]=pp[i];    /* copy the variable parameters */
  1088.     for(i=variables+1;i<=4;i++)q[i]=p[i];    /* copy the fixed parameters */
  1089.     e=0.0;
  1090.     for(i=0;i<nL;i++){
  1091.         f=q[2]+q[3]*V[i];
  1092.         if(f>0.0) f=q[1]+pow(f,q[4]);
  1093.         else f=q[1];
  1094.         a=f-L[i];
  1095.         e += a*a;
  1096.     }
  1097.     e=sqrt(e/nL);
  1098.     return e;
  1099. }
  1100.  
  1101.