7 |
|
#ifndef _RAD_TONEMAP_H_ |
8 |
|
#define _RAD_TONEMAP_H_ |
9 |
|
|
10 |
< |
#include "tifftypes.h" |
10 |
> |
#include "tiff.h" /* needed for int32, etc. */ |
11 |
|
|
12 |
|
#ifdef __cplusplus |
13 |
|
extern "C" { |
14 |
|
#endif |
15 |
|
|
16 |
|
/**** Argument Macros ****/ |
17 |
< |
/* Flags of what to do */ |
17 |
> |
/* flags of what to do */ |
18 |
|
#define TM_F_HCONTR 01 /* human contrast sensitivity */ |
19 |
|
#define TM_F_MESOPIC 02 /* mesopic color sensitivity */ |
20 |
|
#define TM_F_LINEAR 04 /* linear brightness mapping */ |
32 |
|
|
33 |
|
/* special pointer values */ |
34 |
|
#define TM_XYZPRIM (RGBPRIMP)NULL /* indicate XYZ primaries (Note 1) */ |
35 |
< |
#define TM_NOCHROM (BYTE *)NULL /* indicate no chrominance */ |
36 |
< |
#define TM_NOCHROMP (BYTE **)NULL /* indicate no chrominances */ |
35 |
> |
#define TM_NOCHROM (uby8 *)NULL /* indicate no chrominance */ |
36 |
> |
#define TM_NOCHROMP (uby8 **)NULL /* indicate no chrominances */ |
37 |
|
#define TM_GETFILE (FILE *)NULL /* indicate file must be opened */ |
38 |
|
|
39 |
|
|
51 |
|
|
52 |
|
/**** Conversion Constants and Table Sizes ****/ |
53 |
|
|
54 |
< |
#define TM_BRTSCALE 128 /* brightness scale factor (integer) */ |
54 |
> |
#define TM_BRTSCALE 256 /* brightness scale factor (integer) */ |
55 |
|
|
56 |
< |
#define TM_NOBRT (-1<<15) /* bogus brightness value */ |
56 |
> |
#define TM_NOBRT (~0x7fff) /* bogus brightness value */ |
57 |
|
#define TM_NOLUM (1e-17) /* ridiculously small luminance */ |
58 |
|
|
59 |
+ |
#define TM_BRES 4096 /* luminance tone-map resolution */ |
60 |
+ |
|
61 |
|
#define TM_MAXPKG 8 /* maximum number of color formats */ |
62 |
|
|
63 |
|
|
66 |
|
#ifndef MEM_PTR |
67 |
|
#define MEM_PTR void * |
68 |
|
#endif |
69 |
+ |
#ifndef HIST_TYP |
70 |
+ |
#define HIST_TYP unsigned long |
71 |
+ |
#endif |
72 |
+ |
#ifndef TMAP_TYP |
73 |
+ |
#define TMAP_TYP uint16 |
74 |
+ |
#endif |
75 |
|
|
76 |
|
extern char *tmErrorMessage[]; /* error messages */ |
77 |
|
|
78 |
|
typedef short TMbright; /* encoded luminance type */ |
79 |
|
|
80 |
|
/* basic tone mapping data structure */ |
81 |
< |
typedef struct tmStruct { |
81 |
> |
typedef struct { |
82 |
|
int flags; /* flags of what to do */ |
83 |
|
RGBPRIMP monpri; /* monitor RGB primaries */ |
84 |
|
double mongam; /* monitor gamma value (approx.) */ |
86 |
|
int cdiv[3]; /* computed color divisors */ |
87 |
|
RGBPRIMP inppri; /* current input primaries */ |
88 |
|
double inpsf; /* current input scalefactor */ |
89 |
+ |
MEM_PTR inpdat; /* current input client data */ |
90 |
|
COLORMAT cmat; /* color conversion matrix */ |
91 |
|
TMbright hbrmin, hbrmax; /* histogram brightness limits */ |
92 |
< |
int *histo; /* input histogram */ |
92 |
> |
HIST_TYP *histo; /* input histogram */ |
93 |
|
TMbright mbrmin, mbrmax; /* mapped brightness limits */ |
94 |
< |
unsigned short *lumap; /* computed luminance map */ |
94 |
> |
TMAP_TYP *lumap; /* computed luminance map */ |
95 |
|
MEM_PTR pd[TM_MAXPKG]; /* pointers to private data */ |
96 |
|
int lastError; /* last error incurred */ |
97 |
|
const char *lastFunc; /* error-generating function name */ |
126 |
|
|
127 |
|
/**** Library Function Calls ****/ |
128 |
|
|
129 |
+ |
extern TMbright |
130 |
+ |
tmCvLuminance(double lum); |
131 |
+ |
/* |
132 |
+ |
Convert a single luminance value to an encoded brightness value. |
133 |
+ |
*/ |
134 |
|
|
135 |
+ |
extern int |
136 |
+ |
tmCvLums(TMbright *ls, float *scan, int len); |
137 |
+ |
/* |
138 |
+ |
Convert luminance values to encoded brightness values using lookup. |
139 |
+ |
|
140 |
+ |
ls - returned encoded luminance values. |
141 |
+ |
scan - input scanline. |
142 |
+ |
len - scanline length. |
143 |
+ |
|
144 |
+ |
returns - 0 on success, TM_E_* on error. |
145 |
+ |
*/ |
146 |
+ |
|
147 |
|
extern TMstruct * |
148 |
|
tmInit(int flags, RGBPRIMP monpri, double gamval); |
149 |
|
/* |
157 |
|
*/ |
158 |
|
|
159 |
|
extern int |
160 |
< |
tmSetSpace(TMstruct *tms, RGBPRIMP pri, double sf); |
160 |
> |
tmSetSpace(TMstruct *tms, RGBPRIMP pri, double sf, MEM_PTR dat); |
161 |
|
/* |
162 |
|
Set color primaries and scale factor for incoming scanlines. |
163 |
|
|
164 |
|
tms - tone mapping structure pointer. |
165 |
|
pri - RGB color input primaries (Note 1). |
166 |
|
sf - scale factor to get to luminance in cd/m^2. |
167 |
+ |
dat - application-specific data (NULL if not needed) |
168 |
|
|
169 |
|
returns - 0 on success, TM_E_* code on failure. |
170 |
|
*/ |
191 |
|
*/ |
192 |
|
|
193 |
|
extern int |
194 |
< |
tmFixedMapping(TMstruct *tms, double expmult, double gamval); |
194 |
> |
tmFixedMapping(TMstruct *tms, double expmult, double gamval, double Lddyn); |
195 |
|
/* |
196 |
|
Assign a fixed, linear tone-mapping using the given multiplier, |
197 |
|
which is the ratio of maximum output to uncalibrated input. |
202 |
|
tms - tone mapping structure pointer. |
203 |
|
expmult - the fixed exposure multiplier to use. |
204 |
|
gamval - display gamma response (0. for default). |
205 |
+ |
Lddyn - the display's dynamic range (0. for default). |
206 |
|
|
207 |
|
returns - 0 on success, TM_E_* on error. |
208 |
|
*/ |
224 |
|
*/ |
225 |
|
|
226 |
|
extern int |
227 |
< |
tmMapPixels(TMstruct *tms, BYTE *ps, TMbright *ls, BYTE *cs, int len); |
227 |
> |
tmMapPixels(TMstruct *tms, uby8 *ps, TMbright *ls, uby8 *cs, int len); |
228 |
|
/* |
229 |
|
Apply tone mapping function to pixel values. |
230 |
|
|
256 |
|
*/ |
257 |
|
|
258 |
|
extern int |
259 |
< |
tmCvColors(TMstruct *tms, TMbright *ls, BYTE *cs, COLOR *scan, int len); |
259 |
> |
tmCvGrays(TMstruct *tms, TMbright *ls, float *scan, int len); |
260 |
|
/* |
261 |
< |
Convert RGB/XYZ float scanline to encoded luminance and chrominance. |
261 |
> |
Convert gray float scanline to encoded luminance. |
262 |
|
|
263 |
|
tms - tone mapping structure pointer. |
264 |
|
ls - returned encoded luminance values. |
237 |
– |
cs - returned encoded chrominance values (Note 2). |
265 |
|
scan - input scanline. |
266 |
|
len - scanline length. |
267 |
|
|
269 |
|
*/ |
270 |
|
|
271 |
|
extern int |
272 |
< |
tmCvGrays(TMstruct *tms, TMbright *ls, float *scan, int len); |
272 |
> |
tmCvColors(TMstruct *tms, TMbright *ls, uby8 *cs, COLOR *scan, int len); |
273 |
|
/* |
274 |
< |
Convert gray float scanline to encoded luminance. |
274 |
> |
Convert RGB/XYZ float scanline to encoded luminance and chrominance. |
275 |
|
|
276 |
|
tms - tone mapping structure pointer. |
277 |
|
ls - returned encoded luminance values. |
278 |
+ |
cs - returned encoded chrominance values (Note 2). |
279 |
|
scan - input scanline. |
280 |
|
len - scanline length. |
281 |
|
|
283 |
|
*/ |
284 |
|
|
285 |
|
extern int |
286 |
< |
tmCvColrs(TMstruct *tms, TMbright *ls, BYTE *cs, COLR *scan, int len); |
286 |
> |
tmCvColrs(TMstruct *tms, TMbright *ls, uby8 *cs, COLR *scan, int len); |
287 |
|
/* |
288 |
|
Convert RGBE/XYZE scanline to encoded luminance and chrominance. |
289 |
|
|
297 |
|
*/ |
298 |
|
|
299 |
|
extern int |
300 |
< |
tmLoadPicture(TMstruct *tms, TMbright **lpp, BYTE **cpp, int *xp, int *yp, |
300 |
> |
tmLoadPicture(TMstruct *tms, TMbright **lpp, uby8 **cpp, int *xp, int *yp, |
301 |
|
char *fname, FILE *fp); |
302 |
|
/* |
303 |
|
Load Radiance picture and convert to tone mapping representation. |
316 |
|
*/ |
317 |
|
|
318 |
|
extern int |
319 |
< |
tmMapPicture(BYTE **psp, int *xp, int *yp, int flags, |
319 |
> |
tmMapPicture(uby8 **psp, int *xp, int *yp, int flags, |
320 |
|
RGBPRIMP monpri, double gamval, double Lddyn, double Ldmax, |
321 |
|
char *fname, FILE *fp); |
322 |
|
/* |
341 |
|
*/ |
342 |
|
|
343 |
|
extern int |
344 |
< |
tmCvRGB48(TMstruct *tms, TMbright *ls, BYTE *cs, uint16 (*scan)[3], |
344 |
> |
tmCvRGB48(TMstruct *tms, TMbright *ls, uby8 *cs, uint16 (*scan)[3], |
345 |
|
int len, double gv); |
346 |
|
/* |
347 |
|
Convert 48-bit RGB scanline to encoded luminance and chrominance. |