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 1.1 by greg, Thu Feb 2 10:34:14 1989 UTC vs.
Revision 2.35 by greg, Sun Nov 14 17:30:02 2021 UTC

# Line 1 | Line 1
1 < /* Copyright (c) 1986 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   *
8 *     12/31/85
9 *
5   *  Two color representations are used, one for calculation and
6   *  another for storage.  Calculation is done with three floats
7   *  for speed.  Stored color values use 4 bytes which contain
8   *  three single byte mantissas and a common exponent.
9   */
10 + #ifndef _RAD_COLOR_H_
11 + #define _RAD_COLOR_H_
12  
13 + #include <stdio.h>
14 + #include <stdlib.h>
15 +
16 + #ifdef __cplusplus
17 + extern "C" {
18 + #endif
19 +
20   #define  RED            0
21   #define  GRN            1
22   #define  BLU            2
23 < #define  EXP            3
23 > #define  CIEX           0       /* or, if input is XYZ... */
24 > #define  CIEY           1
25 > #define  CIEZ           2
26 > #define  EXP            3       /* exponent same for either format */
27   #define  COLXS          128     /* excess used for exponent */
28 + #define  WHT            3       /* used for RGBPRIMS type */
29  
30 < typedef unsigned char  BYTE;    /* 8-bit unsigned integer */
30 > #undef uby8
31 > #define uby8  unsigned char     /* 8-bit unsigned integer */
32  
33 < typedef BYTE  COLR[4];          /* red, green, blue, exponent */
33 > typedef uby8  COLR[4];          /* red, green, blue (or X,Y,Z), exponent */
34  
35 + typedef float COLORV;
36 + typedef COLORV  COLOR[3];       /* red, green, blue (or X,Y,Z) */
37 +
38 + typedef float  RGBPRIMS[4][2];  /* (x,y) chromaticities for RGBW */
39 + typedef float  (*RGBPRIMP)[2];  /* pointer to RGBPRIMS array */
40 +
41 + typedef float  COLORMAT[3][3];  /* color coordinate conversion matrix */
42 +
43   #define  copycolr(c1,c2)        (c1[0]=c2[0],c1[1]=c2[1], \
44                                  c1[2]=c2[2],c1[3]=c2[3])
45  
29 typedef float  COLOR[3];        /* red, green, blue */
30
46   #define  colval(col,pri)        ((col)[pri])
47  
48   #define  setcolor(col,r,g,b)    ((col)[RED]=(r),(col)[GRN]=(g),(col)[BLU]=(b))
# Line 40 | Line 55 | typedef float  COLOR[3];       /* red, green, blue */
55  
56   #define  multcolor(c1,c2)       ((c1)[0]*=(c2)[0],(c1)[1]*=(c2)[1],(c1)[2]*=(c2)[2])
57  
58 < #define  bright(col)            (.30*(col)[RED]+.59*(col)[GRN]+.11*(col)[BLU])
58 > #if defined(NTSC_RGB)
59 > #define  CIE_x_r                0.670           /* standard NTSC primaries */
60 > #define  CIE_y_r                0.330
61 > #define  CIE_x_g                0.210
62 > #define  CIE_y_g                0.710
63 > #define  CIE_x_b                0.140
64 > #define  CIE_y_b                0.080
65 > #define  CIE_x_w                (1./3.)         /* use EE white */
66 > #define  CIE_y_w                (1./3.)
67 > #elif defined(SHARP_RGB)
68 > #define  CIE_x_r                0.6898          /* "sharp" RGB primaries */
69 > #define  CIE_y_r                0.3206
70 > #define  CIE_x_g                0.0736
71 > #define  CIE_y_g                0.9003
72 > #define  CIE_x_b                0.1166
73 > #define  CIE_y_b                0.0374
74 > #define  CIE_x_w                (1./3.)         /* use EE white */
75 > #define  CIE_y_w                (1./3.)
76 > #else
77 > #define  CIE_x_r                0.640           /* nominal CRT primaries */
78 > #define  CIE_y_r                0.330
79 > #define  CIE_x_g                0.290
80 > #define  CIE_y_g                0.600
81 > #define  CIE_x_b                0.150
82 > #define  CIE_y_b                0.060
83 > #define  CIE_x_w                (1./3.)         /* use EE white */
84 > #define  CIE_y_w                (1./3.)
85 > #endif
86  
87 + #define  STDPRIMS       {{CIE_x_r,CIE_y_r},{CIE_x_g,CIE_y_g}, \
88 +                                {CIE_x_b,CIE_y_b},{CIE_x_w,CIE_y_w}}
89 +
90 + #define CIE_D           (       CIE_x_r*(CIE_y_g - CIE_y_b) + \
91 +                                CIE_x_g*(CIE_y_b - CIE_y_r) + \
92 +                                CIE_x_b*(CIE_y_r - CIE_y_g)     )
93 + #define CIE_C_rD        ( (1./CIE_y_w) * \
94 +                                ( CIE_x_w*(CIE_y_g - CIE_y_b) - \
95 +                                  CIE_y_w*(CIE_x_g - CIE_x_b) + \
96 +                                  CIE_x_g*CIE_y_b - CIE_x_b*CIE_y_g     ) )
97 + #define CIE_C_gD        ( (1./CIE_y_w) * \
98 +                                ( CIE_x_w*(CIE_y_b - CIE_y_r) - \
99 +                                  CIE_y_w*(CIE_x_b - CIE_x_r) - \
100 +                                  CIE_x_r*CIE_y_b + CIE_x_b*CIE_y_r     ) )
101 + #define CIE_C_bD        ( (1./CIE_y_w) * \
102 +                                ( CIE_x_w*(CIE_y_r - CIE_y_g) - \
103 +                                  CIE_y_w*(CIE_x_r - CIE_x_g) + \
104 +                                  CIE_x_r*CIE_y_g - CIE_x_g*CIE_y_r     ) )
105 +
106 + #define CIE_rf          (CIE_y_r*CIE_C_rD/CIE_D)
107 + #define CIE_gf          (CIE_y_g*CIE_C_gD/CIE_D)
108 + #define CIE_bf          (CIE_y_b*CIE_C_bD/CIE_D)
109 +
110 + /* Default CIE_rf=.265074126, CIE_gf=.670114631 and CIE_bf=.064811243 */
111 +
112 + /***** The following definitions are valid for RGB colors only... *****/
113 +
114 + #define  bright(col)    (CIE_rf*(col)[RED]+CIE_gf*(col)[GRN]+CIE_bf*(col)[BLU])
115 + #define  normbright(c)  ( ( (long)(CIE_rf*256.+.5)*(c)[RED] + \
116 +                            (long)(CIE_gf*256.+.5)*(c)[GRN] + \
117 +                            (long)(CIE_bf*256.+.5)*(c)[BLU] ) >> 8 )
118 +
119 +                                /* luminous efficacies over visible spectrum */
120 + #define  MAXEFFICACY            683.            /* defined maximum at 550 nm */
121 + #define  WHTEFFICACY            179.            /* uniform white light */
122 + #define  D65EFFICACY            203.            /* standard illuminant D65 */
123 + #define  INCEFFICACY            160.            /* illuminant A (incand.) */
124 + #define  SUNEFFICACY            208.            /* illuminant B (solar dir.) */
125 + #define  SKYEFFICACY            D65EFFICACY     /* skylight (should be 110) */
126 + #define  DAYEFFICACY            D65EFFICACY     /* combined sky and solar */
127 +
128 + #define  luminance(col)         (WHTEFFICACY * bright(col))
129 +
130 + /***** ...end of stuff specific to RGB colors *****/
131 +
132   #define  intens(col)            ( (col)[0] > (col)[1] \
133                                  ? (col)[0] > (col)[2] ? (col)[0] : (col)[2] \
134                                  : (col)[1] > (col)[2] ? (col)[1] : (col)[2] )
135  
136 + #define  colrval(c,p)           ( (c)[EXP] ? \
137 +                                ldexp((c)[p]+.5,(int)(c)[EXP]-(COLXS+8)) : \
138 +                                0. )
139 +
140   #define  WHTCOLOR               {1.0,1.0,1.0}
141   #define  BLKCOLOR               {0.0,0.0,0.0}
142   #define  WHTCOLR                {128,128,128,COLXS+1}
143   #define  BLKCOLR                {0,0,0,0}
144 +
145 +                                /* picture format identifier */
146 + #define  COLRFMT                "32-bit_rle_rgbe"
147 + #define  CIEFMT                 "32-bit_rle_xyze"
148 + #define  PICFMT                 "32-bit_rle_???e"       /* matches either */
149 + #define  LPICFMT                15                      /* max format id len */
150 +
151 +                                /* macros for exposures */
152 + #define  EXPOSSTR               "EXPOSURE="
153 + #define  LEXPOSSTR              9
154 + #define  isexpos(hl)            (!strncmp(hl,EXPOSSTR,LEXPOSSTR))
155 + #define  exposval(hl)           atof((hl)+LEXPOSSTR)
156 + #define  fputexpos(ex,fp)       fprintf(fp,"%s%e\n",EXPOSSTR,ex)
157 +
158 +                                /* macros for pixel aspect ratios */
159 + #define  ASPECTSTR              "PIXASPECT="
160 + #define  LASPECTSTR             10
161 + #define  isaspect(hl)           (!strncmp(hl,ASPECTSTR,LASPECTSTR))
162 + #define  aspectval(hl)          atof((hl)+LASPECTSTR)
163 + #define  fputaspect(pa,fp)      fprintf(fp,"%s%f\n",ASPECTSTR,pa)
164 +
165 +                                /* macros for primary specifications */
166 + #define  PRIMARYSTR             "PRIMARIES="
167 + #define  LPRIMARYSTR            10
168 + #define  isprims(hl)            (!strncmp(hl,PRIMARYSTR,LPRIMARYSTR))
169 + #define  primsval(p,hl)         (sscanf((hl)+LPRIMARYSTR, \
170 +                                        "%f %f %f %f %f %f %f %f", \
171 +                                        &(p)[RED][CIEX],&(p)[RED][CIEY], \
172 +                                        &(p)[GRN][CIEX],&(p)[GRN][CIEY], \
173 +                                        &(p)[BLU][CIEX],&(p)[BLU][CIEY], \
174 +                                        &(p)[WHT][CIEX],&(p)[WHT][CIEY]) == 8)
175 + #define  fputprims(p,fp)        fprintf(fp, \
176 +                                "%s %.4f %.4f %.4f %.4f %.4f %.4f %.4f %.4f\n",\
177 +                                        PRIMARYSTR, \
178 +                                        (p)[RED][CIEX],(p)[RED][CIEY], \
179 +                                        (p)[GRN][CIEX],(p)[GRN][CIEY], \
180 +                                        (p)[BLU][CIEX],(p)[BLU][CIEY], \
181 +                                        (p)[WHT][CIEX],(p)[WHT][CIEY])
182 +
183 +                                /* macros for color correction */
184 + #define  COLCORSTR              "COLORCORR="
185 + #define  LCOLCORSTR             10
186 + #define  iscolcor(hl)           (!strncmp(hl,COLCORSTR,LCOLCORSTR))
187 + #define  colcorval(cc,hl)       sscanf((hl)+LCOLCORSTR,"%f %f %f", \
188 +                                        &(cc)[RED],&(cc)[GRN],&(cc)[BLU])
189 + #define  fputcolcor(cc,fp)      fprintf(fp,"%s %f %f %f\n",COLCORSTR, \
190 +                                        (cc)[RED],(cc)[GRN],(cc)[BLU])
191 +
192 + /*
193 + * Conversions to and from XYZ space generally don't apply WHTEFFICACY.
194 + * If you need Y to be luminance (cd/m^2), this must be applied when
195 + * converting from radiance (watts/sr/m^2).
196 + */
197 +
198 + extern RGBPRIMS  stdprims;      /* standard primary chromaticities */
199 + extern COLORMAT  rgb2xyzmat;    /* RGB to XYZ conversion matrix */
200 + extern COLORMAT  xyz2rgbmat;    /* XYZ to RGB conversion matrix */
201 + extern COLOR  cblack, cwhite;   /* black (0,0,0) and white (1,1,1) */
202 +
203 + #define  CGAMUT_LOWER           01
204 + #define  CGAMUT_UPPER           02
205 + #define  CGAMUT                 (CGAMUT_LOWER|CGAMUT_UPPER)
206 +
207 + #define  rgb_cie(xyz,rgb)       colortrans(xyz,rgb2xyzmat,rgb)
208 +
209 + #define  cpcolormat(md,ms)      memcpy((void *)md,(void *)ms,sizeof(COLORMAT))
210 +
211 +                                        /* defined in color.c */
212 + extern char     *tempbuffer(unsigned int len);
213 + extern int      fwritecolrs(COLR *scanline, int len, FILE *fp);
214 + extern int      freadcolrs(COLR *scanline, int len, FILE *fp);
215 + extern int      fwritescan(COLOR *scanline, int len, FILE *fp);
216 + extern int      freadscan(COLOR *scanline, int len, FILE *fp);
217 + extern void     setcolr(COLR clr, double r, double g, double b);
218 + extern void     colr_color(COLOR col, COLR clr);
219 + extern int      bigdiff(COLOR c1, COLOR c2, double md);
220 +                                        /* defined in spec_rgb.c */
221 + extern void     spec_rgb(COLOR col, int s, int e);
222 + extern void     spec_cie(COLOR col, int s, int e);
223 + extern void     cie_rgb(COLOR rgb, COLOR xyz);
224 + extern int      clipgamut(COLOR col, double brt, int gamut,
225 +                                COLOR lower, COLOR upper);
226 + extern void     colortrans(COLOR c2, COLORMAT mat, COLOR c1);
227 + extern void     multcolormat(COLORMAT m3, COLORMAT m2,
228 +                                        COLORMAT m1);
229 + extern int      colorprimsOK(RGBPRIMS pr);
230 + extern int      compxyz2rgbmat(COLORMAT mat, RGBPRIMS pr);
231 + extern int      comprgb2xyzmat(COLORMAT mat, RGBPRIMS pr);
232 + extern int      comprgb2rgbmat(COLORMAT mat, RGBPRIMS pr1, RGBPRIMS pr2);
233 + extern int      compxyzWBmat(COLORMAT mat, float wht1[2],
234 +                                float wht2[2]);
235 + extern int      compxyz2rgbWBmat(COLORMAT mat, RGBPRIMS pr);
236 + extern int      comprgb2xyzWBmat(COLORMAT mat, RGBPRIMS pr);
237 + extern int      comprgb2rgbWBmat(COLORMAT mat, RGBPRIMS pr1, RGBPRIMS pr2);
238 +                                        /* defined in colrops.c */
239 + extern int      setcolrcor(double (*f)(double, double), double a2);
240 + extern int      setcolrinv(double (*f)(double, double), double a2);
241 + extern int      setcolrgam(double g);
242 + extern int      colrs_gambs(COLR *scan, int len);
243 + extern int      gambs_colrs(COLR *scan, int len);
244 + extern void     shiftcolrs(COLR *scan, int len, int adjust);
245 + extern void     normcolrs(COLR *scan, int len, int adjust);
246 +
247 +
248 + #ifdef __cplusplus
249 + }
250 + #endif
251 + #endif /* _RAD_COLOR_H_ */
252 +

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines