ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/common/color.h
(Generate patch)

Comparing ray/src/common/color.h (file contents):
Revision 2.2 by greg, Thu Dec 19 14:45:43 1991 UTC vs.
Revision 2.20 by greg, Tue May 13 17:58:32 2003 UTC

# Line 1 | Line 1
1 < /* Copyright (c) 1991 Regents of the University of California */
2 <
3 < /* SCCSid "$SunId$ LBL" */
4 <
1 > /* RCSid $Id$ */
2   /*
3   *  color.h - header for routines using pixel color values.
4   *
5 < *     12/31/85
5 > *  Must be included after X11 headers, since they declare a BYTE type.
6   *
7   *  Two color representations are used, one for calculation and
8   *  another for storage.  Calculation is done with three floats
# Line 13 | Line 10
10   *  three single byte mantissas and a common exponent.
11   */
12  
13 + #include "copyright.h"
14 +
15 + #include <stdio.h>
16 + #include <stdlib.h>
17 +
18 + #ifdef __cplusplus
19 + extern "C" {
20 + #endif
21 +
22   #define  RED            0
23   #define  GRN            1
24   #define  BLU            2
25 < #define  EXP            3
25 > #define  CIEX           0       /* or, if input is XYZ... */
26 > #define  CIEY           1
27 > #define  CIEZ           2
28 > #define  EXP            3       /* exponent same for either format */
29   #define  COLXS          128     /* excess used for exponent */
30 + #define  WHT            3       /* used for RGBPRIMS type */
31  
32 < typedef unsigned char  BYTE;    /* 8-bit unsigned integer */
32 > #undef  BYTE
33 > #define  BYTE   unsigned char   /* 8-bit unsigned integer */
34  
35 < typedef BYTE  COLR[4];          /* red, green, blue, exponent */
35 > typedef BYTE  COLR[4];          /* red, green, blue (or X,Y,Z), exponent */
36  
37 + typedef float  COLOR[3];        /* red, green, blue (or X,Y,Z) */
38 +
39 + typedef float  RGBPRIMS[4][2];  /* (x,y) chromaticities for RGBW */
40 + typedef float  (*RGBPRIMP)[2];  /* pointer to RGBPRIMS array */
41 +
42 + typedef float  COLORMAT[3][3];  /* color coordinate conversion matrix */
43 +
44   #define  copycolr(c1,c2)        (c1[0]=c2[0],c1[1]=c2[1], \
45                                  c1[2]=c2[2],c1[3]=c2[3])
46  
29 typedef float  COLOR[3];        /* red, green, blue */
30
47   #define  colval(col,pri)        ((col)[pri])
48  
49   #define  setcolor(col,r,g,b)    ((col)[RED]=(r),(col)[GRN]=(g),(col)[BLU]=(b))
# Line 41 | Line 57 | typedef float  COLOR[3];       /* red, green, blue */
57   #define  multcolor(c1,c2)       ((c1)[0]*=(c2)[0],(c1)[1]*=(c2)[1],(c1)[2]*=(c2)[2])
58  
59   #ifdef  NTSC
60 < #define  bright(col)            (.295*(col)[RED]+.636*(col)[GRN]+.070*(col)[BLU])
61 < #define  normbright(c)          (int)((74L*(c)[RED]+164L*(c)[GRN]+18L*(c)[BLU])/256)
60 > #define  CIE_x_r                0.670           /* standard NTSC primaries */
61 > #define  CIE_y_r                0.330
62 > #define  CIE_x_g                0.210
63 > #define  CIE_y_g                0.710
64 > #define  CIE_x_b                0.140
65 > #define  CIE_y_b                0.080
66 > #define  CIE_x_w                0.3333          /* use true white */
67 > #define  CIE_y_w                0.3333
68   #else
69 < #define  bright(col)            (.263*(col)[RED]+.655*(col)[GRN]+.082*(col)[BLU])
70 < #define  normbright(c)          (int)((67L*(c)[RED]+168L*(c)[GRN]+21L*(c)[BLU])/256)
69 > #define  CIE_x_r                0.640           /* nominal CRT primaries */
70 > #define  CIE_y_r                0.330
71 > #define  CIE_x_g                0.290
72 > #define  CIE_y_g                0.600
73 > #define  CIE_x_b                0.150
74 > #define  CIE_y_b                0.060
75 > #define  CIE_x_w                0.3333          /* use true white */
76 > #define  CIE_y_w                0.3333
77   #endif
78  
79 + #define  STDPRIMS       {{CIE_x_r,CIE_y_r},{CIE_x_g,CIE_y_g}, \
80 +                                {CIE_x_b,CIE_y_b},{CIE_x_w,CIE_y_w}}
81 +
82 + #define CIE_D           (       CIE_x_r*(CIE_y_g - CIE_y_b) + \
83 +                                CIE_x_g*(CIE_y_b - CIE_y_r) + \
84 +                                CIE_x_b*(CIE_y_r - CIE_y_g)     )
85 + #define CIE_C_rD        ( (1./CIE_y_w) * \
86 +                                ( CIE_x_w*(CIE_y_g - CIE_y_b) - \
87 +                                  CIE_y_w*(CIE_x_g - CIE_x_b) + \
88 +                                  CIE_x_g*CIE_y_b - CIE_x_b*CIE_y_g     ) )
89 + #define CIE_C_gD        ( (1./CIE_y_w) * \
90 +                                ( CIE_x_w*(CIE_y_b - CIE_y_r) - \
91 +                                  CIE_y_w*(CIE_x_b - CIE_x_r) - \
92 +                                  CIE_x_r*CIE_y_b + CIE_x_b*CIE_y_r     ) )
93 + #define CIE_C_bD        ( (1./CIE_y_w) * \
94 +                                ( CIE_x_w*(CIE_y_r - CIE_y_g) - \
95 +                                  CIE_y_w*(CIE_x_r - CIE_x_g) + \
96 +                                  CIE_x_r*CIE_y_g - CIE_x_g*CIE_y_r     ) )
97 +
98 + #define CIE_rf          (CIE_y_r*CIE_C_rD/CIE_D)
99 + #define CIE_gf          (CIE_y_g*CIE_C_gD/CIE_D)
100 + #define CIE_bf          (CIE_y_b*CIE_C_bD/CIE_D)
101 +
102 + /* As of 9-94, CIE_rf=.265074126, CIE_gf=.670114631 and CIE_bf=.064811243 */
103 +
104 + /***** The following definitions are valid for RGB colors only... *****/
105 +
106 + #define  bright(col)    (CIE_rf*(col)[RED]+CIE_gf*(col)[GRN]+CIE_bf*(col)[BLU])
107 + #define  normbright(c)  ( ( (long)(CIE_rf*256.+.5)*(c)[RED] + \
108 +                            (long)(CIE_gf*256.+.5)*(c)[GRN] + \
109 +                            (long)(CIE_bf*256.+.5)*(c)[BLU] ) >> 8 )
110 +
111                                  /* luminous efficacies over visible spectrum */
112   #define  MAXEFFICACY            683.            /* defined maximum at 550 nm */
113   #define  WHTEFFICACY            179.            /* uniform white light */
# Line 59 | Line 119 | typedef float  COLOR[3];       /* red, green, blue */
119  
120   #define  luminance(col)         (WHTEFFICACY * bright(col))
121  
122 + /***** ...end of stuff specific to RGB colors *****/
123 +
124   #define  intens(col)            ( (col)[0] > (col)[1] \
125                                  ? (col)[0] > (col)[2] ? (col)[0] : (col)[2] \
126                                  : (col)[1] > (col)[2] ? (col)[1] : (col)[2] )
# Line 74 | Line 136 | typedef float  COLOR[3];       /* red, green, blue */
136  
137                                  /* picture format identifier */
138   #define  COLRFMT                "32-bit_rle_rgbe"
139 + #define  CIEFMT                 "32-bit_rle_xyze"
140 + #define  PICFMT                 "32-bit_rle_???e"       /* matches either */
141 + #define  LPICFMT                15                      /* max format id len */
142  
143                                  /* macros for exposures */
144   #define  EXPOSSTR               "EXPOSURE="
# Line 89 | Line 154 | typedef float  COLOR[3];       /* red, green, blue */
154   #define  aspectval(hl)          atof((hl)+LASPECTSTR)
155   #define  fputaspect(pa,fp)      fprintf(fp,"%s%f\n",ASPECTSTR,pa)
156  
157 +                                /* macros for primary specifications */
158 + #define  PRIMARYSTR             "PRIMARIES="
159 + #define  LPRIMARYSTR            10
160 + #define  isprims(hl)            (!strncmp(hl,PRIMARYSTR,LPRIMARYSTR))
161 + #define  primsval(p,hl)         sscanf(hl+LPRIMARYSTR, \
162 +                                        "%f %f %f %f %f %f %f %f", \
163 +                                        &(p)[RED][CIEX],&(p)[RED][CIEY], \
164 +                                        &(p)[GRN][CIEX],&(p)[GRN][CIEY], \
165 +                                        &(p)[BLU][CIEX],&(p)[BLU][CIEY], \
166 +                                        &(p)[WHT][CIEX],&(p)[WHT][CIEY])
167 + #define  fputprims(p,fp)        fprintf(fp, \
168 +                                "%s %.4f %.4f %.4f %.4f %.4f %.4f %.4f %.4f\n",\
169 +                                        PRIMARYSTR, \
170 +                                        (p)[RED][CIEX],(p)[RED][CIEY], \
171 +                                        (p)[GRN][CIEX],(p)[GRN][CIEY], \
172 +                                        (p)[BLU][CIEX],(p)[BLU][CIEY], \
173 +                                        (p)[WHT][CIEX],(p)[WHT][CIEY])
174 +
175                                  /* macros for color correction */
176   #define  COLCORSTR              "COLORCORR="
177   #define  LCOLCORSTR             10
# Line 98 | Line 181 | typedef float  COLOR[3];       /* red, green, blue */
181   #define  fputcolcor(cc,fp)      fprintf(fp,"%s %f %f %f\n",COLCORSTR, \
182                                          (cc)[RED],(cc)[GRN],(cc)[BLU])
183  
184 < extern double  ldexp();
185 < #ifndef atof                    /* atof's a macro on some systems! */
186 < extern double  atof();
184 > /*
185 > * Conversions to and from XYZ space generally don't apply WHTEFFICACY.
186 > * If you need Y to be luminance (cd/m^2), this must be applied when
187 > * converting from radiance (watts/sr/m^2).
188 > */
189 >
190 > extern RGBPRIMS  stdprims;      /* standard primary chromaticities */
191 > extern COLORMAT  rgb2xyzmat;    /* RGB to XYZ conversion matrix */
192 > extern COLORMAT  xyz2rgbmat;    /* XYZ to RGB conversion matrix */
193 > extern COLOR  cblack, cwhite;   /* black (0,0,0) and white (1,1,1) */
194 >
195 > #define  CGAMUT_LOWER           01
196 > #define  CGAMUT_UPPER           02
197 > #define  CGAMUT                 (CGAMUT_LOWER|CGAMUT_UPPER)
198 >
199 > #define  rgb_cie(xyz,rgb)       colortrans(xyz,rgb2xyzmat,rgb)
200 >
201 > #ifdef BSD
202 > #define  cpcolormat(md,ms)      bcopy((void *)ms,(void *)md,sizeof(COLORMAT))
203 > #else
204 > #define  cpcolormat(md,ms)      memcpy((void *)md,(void *)ms,sizeof(COLORMAT))
205 > #endif
206 >
207 > #ifdef NOPROTO
208 >                                        /* defined in color.c */
209 > extern char     *tempbuffer();
210 > extern int      fwritecolrs();
211 > extern int      freadcolrs();
212 > extern int      fwritescan();
213 > extern int      freadscan();
214 > extern void     setcolr();
215 > extern void     colr_color();
216 > extern int      bigdiff();
217 >                                        /* defined in spec_rgb.c */
218 > extern void     spec_rgb();
219 > extern void     spec_cie();
220 > extern void     cie_rgb();
221 > extern int      clipgamut();
222 > extern void     colortrans();
223 > extern void     multcolormat();
224 > extern void     compxyz2rgbmat();
225 > extern void     comprgb2xyzmat();
226 > extern void     comprgb2rgbmat();
227 > extern void     compxyzWBmat();
228 > extern void     compxyz2rgbWBmat();
229 > extern void     comprgb2xyzWBmat();
230 > extern void     comprgb2rgbWBmat();
231 >                                        /* defined in colrops.c */
232 > extern int      setcolrcor();
233 > extern int      setcolrinv();
234 > extern int      setcolrgam();
235 > extern int      colrs_gambs();
236 > extern int      gambs_colrs();
237 > extern void     shiftcolrs();
238 > extern void     normcolrs();
239 >
240 > #else
241 >                                        /* defined in color.c */
242 > extern char     *tempbuffer(unsigned int len);
243 > extern int      fwritecolrs(COLR *scanline, int len, FILE *fp);
244 > extern int      freadcolrs(COLR *scanline, int len, FILE *fp);
245 > extern int      fwritescan(COLOR *scanline, int len, FILE *fp);
246 > extern int      freadscan(COLOR *scanline, int len, FILE *fp);
247 > extern void     setcolr(COLR clr, double r, double g, double b);
248 > extern void     colr_color(COLOR col, COLR clr);
249 > extern int      bigdiff(COLOR c1, COLOR c2, double md);
250 >                                        /* defined in spec_rgb.c */
251 > extern void     spec_rgb(COLOR col, int s, int e);
252 > extern void     spec_cie(COLOR col, int s, int e);
253 > extern void     cie_rgb(COLOR rgb, COLOR xyz);
254 > extern int      clipgamut(COLOR col, double brt, int gamut,
255 >                                COLOR lower, COLOR upper);
256 > extern void     colortrans(COLOR c2, COLORMAT mat, COLOR c1);
257 > extern void     multcolormat(COLORMAT m3, COLORMAT m2,
258 >                                        COLORMAT m1);
259 > extern void     compxyz2rgbmat(COLORMAT mat, RGBPRIMS pr);
260 > extern void     comprgb2xyzmat(COLORMAT mat, RGBPRIMS pr);
261 > extern void     comprgb2rgbmat(COLORMAT mat, RGBPRIMS pr1, RGBPRIMS pr2);
262 > extern void     compxyzWBmat(COLORMAT mat, float wht1[2],
263 >                                float wht2[2]);
264 > extern void     compxyz2rgbWBmat(COLORMAT mat, RGBPRIMS pr);
265 > extern void     comprgb2xyzWBmat(COLORMAT mat, RGBPRIMS pr);
266 > extern void     comprgb2rgbWBmat(COLORMAT mat, RGBPRIMS pr1, RGBPRIMS pr2);
267 >                                        /* defined in colrops.c */
268 > extern int      setcolrcor(double (*f)(), double a2);
269 > extern int      setcolrinv(double (*f)(), double a2);
270 > extern int      setcolrgam(double g);
271 > extern int      colrs_gambs(COLR *scan, int len);
272 > extern int      gambs_colrs(COLR *scan, int len);
273 > extern void     shiftcolrs(COLR *scan, int len, int adjust);
274 > extern void     normcolrs(COLR *scan, int len, int adjust);
275 >
276 > #endif
277 >
278 > #ifdef __cplusplus
279 > }
280   #endif

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines