ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/common/tonemap.c
Revision: 3.38
Committed: Wed Jan 6 19:25:00 2021 UTC (3 years, 4 months ago) by greg
Content type: text/plain
Branch: MAIN
Changes since 3.37: +17 -16 lines
Log Message:
refactor: added defined types for histogram and map tables

File Contents

# Content
1 #ifndef lint
2 static const char RCSid[] = "$Id: tonemap.c,v 3.37 2011/05/20 02:06:38 greg Exp $";
3 #endif
4 /*
5 * Tone mapping functions.
6 * See tonemap.h for detailed function descriptions.
7 * Added von Kries white-balance calculations 10/01 (GW).
8 *
9 * Externals declared in tonemap.h
10 */
11
12 #include "copyright.h"
13
14 #include <stdio.h>
15 #include <stdlib.h>
16 #include <math.h>
17 #include <string.h>
18 #include "tmprivat.h"
19 #include "tmerrmsg.h"
20
21 #define exp10(x) exp(M_LN10*(x))
22
23 /* our list of conversion packages */
24 struct tmPackage *tmPkg[TM_MAXPKG];
25 int tmNumPkgs = 0; /* number of registered packages */
26
27 /* luminance->brightness lookup */
28 static TMbright *tmFloat2BrtLUT = NULL;
29
30 #define tmCvLumLUfp(pf) tmFloat2BrtLUT[*(int32 *)(pf) >> 15]
31
32
33 TMstruct *
34 tmInit( /* initialize new tone mapping */
35 int flags,
36 RGBPRIMP monpri,
37 double gamval
38 )
39 {
40 COLORMAT cmat;
41 TMstruct *tmnew;
42 int i;
43 /* allocate structure */
44 tmnew = (TMstruct *)malloc(sizeof(TMstruct));
45 if (tmnew == NULL)
46 return(NULL);
47
48 tmnew->flags = flags & ~TM_F_UNIMPL;
49 if (tmnew->flags & TM_F_BW)
50 tmnew->flags &= ~TM_F_MESOPIC;
51 /* set monitor transform */
52 if (monpri == NULL || monpri == stdprims || tmnew->flags & TM_F_BW) {
53 tmnew->monpri = stdprims;
54 tmnew->clf[RED] = rgb2xyzmat[1][0];
55 tmnew->clf[GRN] = rgb2xyzmat[1][1];
56 tmnew->clf[BLU] = rgb2xyzmat[1][2];
57 } else {
58 comprgb2xyzmat(cmat, tmnew->monpri=monpri);
59 tmnew->clf[RED] = cmat[1][0];
60 tmnew->clf[GRN] = cmat[1][1];
61 tmnew->clf[BLU] = cmat[1][2];
62 }
63 /* set gamma value */
64 if (gamval < MINGAM)
65 tmnew->mongam = DEFGAM;
66 else
67 tmnew->mongam = gamval;
68 /* set color divisors */
69 for (i = 0; i < 3; i++)
70 tmnew->cdiv[i] = 256.*pow(tmnew->clf[i], 1./tmnew->mongam);
71
72 /* set input transform */
73 tmnew->inppri = tmnew->monpri;
74 tmnew->cmat[0][0] = tmnew->cmat[1][1] = tmnew->cmat[2][2] =
75 tmnew->inpsf = WHTEFFICACY;
76 tmnew->cmat[0][1] = tmnew->cmat[0][2] = tmnew->cmat[1][0] =
77 tmnew->cmat[1][2] = tmnew->cmat[2][0] = tmnew->cmat[2][1] = 0.;
78 tmnew->inpdat = NULL;
79 tmnew->hbrmin = 10; tmnew->hbrmax = -10;
80 tmnew->histo = NULL;
81 tmnew->mbrmin = 10; tmnew->mbrmax = -10;
82 tmnew->lumap = NULL;
83 /* zero private data */
84 for (i = TM_MAXPKG; i--; )
85 tmnew->pd[i] = NULL;
86 tmnew->lastError = TM_E_OK;
87 tmnew->lastFunc = "NoErr";
88 /* return new TMstruct */
89 return(tmnew);
90 }
91
92
93 int
94 tmSetSpace( /* set input color space for conversions */
95 TMstruct *tms,
96 RGBPRIMP pri,
97 double sf,
98 MEM_PTR dat
99 )
100 {
101 static const char funcName[] = "tmSetSpace";
102 int i, j;
103 /* error check */
104 if (tms == NULL)
105 returnErr(TM_E_TMINVAL);
106 if (sf <= 1e-12)
107 returnErr(TM_E_ILLEGAL);
108 /* check if no change */
109 if (pri == tms->inppri && FEQ(sf, tms->inpsf) && dat == tms->inpdat)
110 returnOK;
111 tms->inppri = pri; /* let's set it */
112 tms->inpsf = sf;
113 tms->inpdat = dat;
114
115 if (tms->flags & TM_F_BW) { /* color doesn't matter */
116 tms->monpri = tms->inppri; /* eliminate xform */
117 if (tms->inppri == TM_XYZPRIM) {
118 tms->clf[CIEX] = tms->clf[CIEZ] = 0.;
119 tms->clf[CIEY] = 1.;
120 } else {
121 comprgb2xyzmat(tms->cmat, tms->monpri);
122 tms->clf[RED] = tms->cmat[1][0];
123 tms->clf[GRN] = tms->cmat[1][1];
124 tms->clf[BLU] = tms->cmat[1][2];
125 }
126 tms->cmat[0][0] = tms->cmat[1][1] = tms->cmat[2][2] =
127 tms->inpsf;
128 tms->cmat[0][1] = tms->cmat[0][2] = tms->cmat[1][0] =
129 tms->cmat[1][2] = tms->cmat[2][0] = tms->cmat[2][1] = 0.;
130
131 } else if (tms->inppri == TM_XYZPRIM) /* input is XYZ */
132 compxyz2rgbWBmat(tms->cmat, tms->monpri);
133
134 else { /* input is RGB */
135 if (tms->inppri != tms->monpri &&
136 PRIMEQ(tms->inppri, tms->monpri))
137 tms->inppri = tms->monpri; /* no xform */
138 if (!comprgb2rgbWBmat(tms->cmat, tms->inppri, tms->monpri))
139 returnErr(TM_E_ILLEGAL);
140 }
141 for (i = 0; i < 3; i++)
142 for (j = 0; j < 3; j++)
143 tms->cmat[i][j] *= tms->inpsf;
144 /* set color divisors */
145 for (i = 0; i < 3; i++)
146 tms->cdiv[i] = 256.*pow(tms->clf[i] < .001 ? .001 :
147 tms->clf[i], 1./tms->mongam);
148 /* notify packages */
149 for (i = tmNumPkgs; i--; )
150 if (tms->pd[i] != NULL && tmPkg[i]->NewSpace != NULL)
151 (*tmPkg[i]->NewSpace)(tms);
152 returnOK;
153 }
154
155
156 void
157 tmClearHisto( /* clear current histogram */
158 TMstruct *tms
159 )
160 {
161 if (tms == NULL || tms->histo == NULL)
162 return;
163 free((MEM_PTR)tms->histo);
164 tms->histo = NULL;
165 }
166
167
168 TMbright
169 tmCvLuminance( /* convert a single luminance */
170 double lum
171 )
172 {
173 double d;
174
175 #ifdef isfinite
176 if (!isfinite(lum) || lum <= TM_NOLUM)
177 #else
178 if (lum <= TM_NOLUM)
179 #endif
180 return(TM_NOBRT);
181 d = TM_BRTSCALE*log(lum);
182 return((TMbright)(d + .5 - (d < 0.)));
183 }
184
185
186 int
187 tmCvLums( /* convert luminances using lookup */
188 TMbright *ls,
189 float *scan,
190 int len
191 )
192 {
193 if (tmFloat2BrtLUT == NULL) { /* initialize lookup table */
194 int32 i;
195 tmFloat2BrtLUT = (TMbright *)malloc(sizeof(TMbright)*0x10000);
196 if (tmFloat2BrtLUT == NULL)
197 return(TM_E_NOMEM);
198 for (i = 0; i < 0x10000; i++) {
199 int32 l = (i<<1 | 1) << 14;
200 #ifndef isfinite
201 if ((l & 0x7f800000) == 0x7f800000)
202 tmFloat2BrtLUT[i] = TM_NOBRT;
203 else
204 #endif
205 tmFloat2BrtLUT[i] = tmCvLuminance(*(float *)&l);
206 }
207 }
208 if (len <= 0)
209 return(TM_E_OK);
210 if ((ls == NULL) | (scan == NULL))
211 return(TM_E_ILLEGAL);
212 while (len--) {
213 if (*scan <= TM_NOLUM) {
214 *ls++ = TM_NOBRT;
215 ++scan;
216 continue;
217 }
218 *ls++ = tmCvLumLUfp(scan++);
219 }
220 return(TM_E_OK);
221 }
222
223
224 int
225 tmCvGrays( /* convert float gray values */
226 TMstruct *tms,
227 TMbright *ls,
228 float *scan,
229 int len
230 )
231 {
232 static const char funcName[] = "tmCvGrays";
233 int i;
234
235 if (tms == NULL)
236 returnErr(TM_E_TMINVAL);
237 if ((ls == NULL) | (scan == NULL) | (len < 0))
238 returnErr(TM_E_ILLEGAL);
239 if (tmFloat2BrtLUT == NULL) /* initialize */
240 tmCvLums(NULL, NULL, 0);
241 for (i = len; i--; ) {
242 float lum = tms->inpsf * scan[i];
243 if (lum <= TM_NOLUM)
244 ls[i] = TM_NOBRT;
245 else
246 ls[i] = tmCvLumLUfp(&lum);
247 }
248 returnOK;
249 }
250
251
252 int
253 tmCvColors( /* convert float colors */
254 TMstruct *tms,
255 TMbright *ls,
256 uby8 *cs,
257 COLOR *scan,
258 int len
259 )
260 {
261 static const char funcName[] = "tmCvColors";
262 static uby8 gamtab[1024];
263 static double curgam = .0;
264 COLOR cmon;
265 float lum, slum, d;
266 int i;
267
268 if (tms == NULL)
269 returnErr(TM_E_TMINVAL);
270 if ((ls == NULL) | (scan == NULL) | (len < 0))
271 returnErr(TM_E_ILLEGAL);
272 if (tmFloat2BrtLUT == NULL) /* initialize */
273 tmCvLums(NULL, NULL, 0);
274 if (cs != TM_NOCHROM && fabs(tms->mongam - curgam) > .02) {
275 curgam = tms->mongam; /* (re)build table */
276 for (i = 1024; i--; )
277 gamtab[i] = (int)(256.*pow((i+.5)/1024., 1./curgam));
278 }
279 for (i = len; i--; ) {
280 if (tmNeedMatrix(tms)) { /* get monitor RGB */
281 colortrans(cmon, tms->cmat, scan[i]);
282 } else {
283 cmon[RED] = tms->inpsf*scan[i][RED];
284 cmon[GRN] = tms->inpsf*scan[i][GRN];
285 cmon[BLU] = tms->inpsf*scan[i][BLU];
286 }
287 #ifdef isfinite
288 if (!isfinite(cmon[RED]) || cmon[RED] < .0f) cmon[RED] = .0f;
289 if (!isfinite(cmon[GRN]) || cmon[GRN] < .0f) cmon[GRN] = .0f;
290 if (!isfinite(cmon[BLU]) || cmon[BLU] < .0f) cmon[BLU] = .0f;
291 #else
292 if (cmon[RED] < .0f) cmon[RED] = .0f;
293 if (cmon[GRN] < .0f) cmon[GRN] = .0f;
294 if (cmon[BLU] < .0f) cmon[BLU] = .0f;
295 #endif
296 /* world luminance */
297 lum = tms->clf[RED]*cmon[RED] +
298 tms->clf[GRN]*cmon[GRN] +
299 tms->clf[BLU]*cmon[BLU] ;
300 if (lum <= TM_NOLUM) { /* convert brightness */
301 lum = cmon[RED] = cmon[GRN] = cmon[BLU] = TM_NOLUM;
302 ls[i] = TM_NOBRT;
303 } else
304 ls[i] = tmCvLumLUfp(&lum);
305 if (cs == TM_NOCHROM) /* no color? */
306 continue;
307 if (tms->flags & TM_F_MESOPIC && lum < LMESUPPER) {
308 slum = scotlum(cmon); /* mesopic adj. */
309 if (lum < LMESLOWER) {
310 cmon[RED] = cmon[GRN] = cmon[BLU] = slum;
311 } else {
312 d = (lum - LMESLOWER)/(LMESUPPER - LMESLOWER);
313 if (tms->flags & TM_F_BW)
314 cmon[RED] = cmon[GRN] =
315 cmon[BLU] = d*lum;
316 else
317 scalecolor(cmon, d);
318 d = (1.f-d)*slum;
319 cmon[RED] += d;
320 cmon[GRN] += d;
321 cmon[BLU] += d;
322 }
323 } else if (tms->flags & TM_F_BW) {
324 cmon[RED] = cmon[GRN] = cmon[BLU] = lum;
325 }
326 d = tms->clf[RED]*cmon[RED]/lum;
327 cs[3*i ] = d>=.999f ? 255 : gamtab[(int)(1024.f*d)];
328 d = tms->clf[GRN]*cmon[GRN]/lum;
329 cs[3*i+1] = d>=.999f ? 255 : gamtab[(int)(1024.f*d)];
330 d = tms->clf[BLU]*cmon[BLU]/lum;
331 cs[3*i+2] = d>=.999f ? 255 : gamtab[(int)(1024.f*d)];
332 }
333 returnOK;
334 }
335
336
337 int
338 tmAddHisto( /* add values to histogram */
339 TMstruct *tms,
340 TMbright *ls,
341 int len,
342 int wt
343 )
344 {
345 static const char funcName[] = "tmAddHisto";
346 int oldorig=0, oldlen, horig, hlen;
347 int i, j;
348
349 if (tms == NULL)
350 returnErr(TM_E_TMINVAL);
351 if (len < 0)
352 returnErr(TM_E_ILLEGAL);
353 if (len == 0)
354 returnOK;
355 /* first, grow limits */
356 if (tms->histo == NULL) {
357 for (i = len; i-- && ls[i] < MINBRT; )
358 ;
359 if (i < 0)
360 returnOK;
361 tms->hbrmin = tms->hbrmax = ls[i];
362 oldlen = 0;
363 } else {
364 oldorig = HISTI(tms->hbrmin);
365 oldlen = HISTI(tms->hbrmax) + 1 - oldorig;
366 }
367 for (i = len; i--; ) {
368 if ((j = ls[i]) < MINBRT)
369 continue;
370 if (j < tms->hbrmin)
371 tms->hbrmin = j;
372 else if (j > tms->hbrmax)
373 tms->hbrmax = j;
374 }
375 horig = HISTI(tms->hbrmin);
376 hlen = HISTI(tms->hbrmax) + 1 - horig;
377 if (hlen > oldlen) { /* (re)allocate histogram */
378 HIST_TYP *newhist = (HIST_TYP *)calloc(hlen, sizeof(HIST_TYP));
379 if (newhist == NULL)
380 returnErr(TM_E_NOMEM);
381 if (oldlen) { /* copy and free old */
382 memcpy((MEM_PTR)newhist+(oldorig-horig),
383 (MEM_PTR)tms->histo, oldlen*sizeof(HIST_TYP));
384 free((MEM_PTR)tms->histo);
385 }
386 tms->histo = newhist;
387 }
388 if (wt == 0)
389 returnOK;
390 for (i = len; i--; ) /* add in new counts */
391 if (ls[i] >= MINBRT)
392 tms->histo[ HISTI(ls[i]) - horig ] += wt;
393 returnOK;
394 }
395
396
397 static double
398 htcontrs( /* human threshold contrast sensitivity, dL(La) */
399 double La
400 )
401 {
402 double l10La, l10dL;
403 /* formula taken from Ferwerda et al. [SG96] */
404 if (La < 1.148e-4)
405 return(1.38e-3);
406 l10La = log10(La);
407 if (l10La < -1.44) /* rod response regime */
408 l10dL = pow(.405*l10La + 1.6, 2.18) - 2.86;
409 else if (l10La < -.0184)
410 l10dL = l10La - .395;
411 else if (l10La < 1.9) /* cone response regime */
412 l10dL = pow(.249*l10La + .65, 2.7) - .72;
413 else
414 l10dL = l10La - 1.255;
415
416 return(exp10(l10dL));
417 }
418
419
420 int
421 tmFixedMapping( /* compute fixed, linear tone-mapping */
422 TMstruct *tms,
423 double expmult,
424 double gamval
425 )
426 {
427 static const char funcName[] = "tmFixedMapping";
428 double d;
429 int i;
430
431 if (!tmNewMap(tms))
432 returnErr(TM_E_NOMEM);
433 if (expmult <= .0)
434 expmult = 1.;
435 if (gamval < MINGAM)
436 gamval = tms->mongam;
437 d = log(expmult/tms->inpsf);
438 for (i = tms->mbrmax-tms->mbrmin+1; i--; ) {
439 double val = 256. * exp(
440 ( d + (tms->mbrmin+i)*(1./TM_BRTSCALE) )
441 / gamval);
442 tms->lumap[i] = val >= (double)0xffff ? 0xffff : (int)val;
443 }
444 returnOK;
445 }
446
447
448 int
449 tmComputeMapping( /* compute histogram tone-mapping */
450 TMstruct *tms,
451 double gamval,
452 double Lddyn,
453 double Ldmax
454 )
455 {
456 static const char funcName[] = "tmComputeMapping";
457 HIST_TYP *histo;
458 float *cumf;
459 int brt0, histlen;
460 HIST_TYP threshold, ceiling, trimmings;
461 double logLddyn, Ldmin, Ldavg, Lwavg, Tr, Lw, Ld;
462 HIST_TYP histot;
463 double sum;
464 double d;
465 int i, j;
466
467 if (tms == NULL || tms->histo == NULL)
468 returnErr(TM_E_TMINVAL);
469 /* check arguments */
470 if (Lddyn < MINLDDYN) Lddyn = DEFLDDYN;
471 if (Ldmax < MINLDMAX) Ldmax = DEFLDMAX;
472 if (gamval < MINGAM) gamval = tms->mongam;
473 /* compute handy values */
474 Ldmin = Ldmax/Lddyn;
475 logLddyn = log(Lddyn);
476 Ldavg = sqrt(Ldmax*Ldmin);
477 i = HISTI(tms->hbrmin);
478 brt0 = HISTV(i);
479 histlen = HISTI(tms->hbrmax) + 1 - i;
480 /* histogram total and mean */
481 histot = 0; sum = 0;
482 j = brt0 + histlen*HISTEP;
483 for (i = histlen; i--; ) {
484 histot += tms->histo[i];
485 sum += (double)(j -= HISTEP) * tms->histo[i];
486 }
487 threshold = histot*0.005 + .5;
488 if (!histot)
489 returnErr(TM_E_TMFAIL);
490 Lwavg = tmLuminance( (double)sum / histot );
491 /* use linear tone mapping? */
492 if (tms->flags & TM_F_LINEAR || threshold < 4 ||
493 tms->hbrmax - tms->hbrmin < TM_BRTSCALE*logLddyn)
494 goto linearmap;
495 /* clamp histogram */
496 histo = (HIST_TYP *)malloc(histlen*sizeof(HIST_TYP));
497 cumf = (float *)malloc((histlen+2)*sizeof(float));
498 if ((histo == NULL) | (cumf == NULL))
499 returnErr(TM_E_NOMEM);
500 cumf[histlen+1] = 1.; /* guard for assignment code */
501 for (i = histlen; i--; ) /* make malleable copy */
502 histo[i] = tms->histo[i];
503 do { /* iterate to solution */
504 sum = 0; /* cumulative probability */
505 for (i = 0; i < histlen; i++) {
506 cumf[i] = (double)sum/histot;
507 sum += histo[i];
508 }
509 cumf[histlen] = 1.;
510 Tr = histot * (double)(tms->hbrmax - tms->hbrmin) /
511 ((double)histlen*TM_BRTSCALE) / logLddyn;
512 ceiling = Tr + 1.;
513 trimmings = 0; /* clip to envelope */
514 for (i = histlen; i--; ) {
515 if (tms->flags & TM_F_HCONTR) {
516 Lw = tmLuminance(brt0 + i*HISTEP);
517 Ld = Ldmin * exp( logLddyn *
518 .5*(cumf[i]+cumf[i+1]) );
519 ceiling = Tr * (htcontrs(Ld) * Lw) /
520 (htcontrs(Lw) * Ld) + 1.;
521 }
522 if (histo[i] > ceiling) {
523 trimmings += histo[i] - ceiling;
524 histo[i] = ceiling;
525 }
526 }
527 /* check if we're out of data */
528 if ((histot -= trimmings) <= threshold) {
529 free((MEM_PTR)histo);
530 free((MEM_PTR)cumf);
531 goto linearmap;
532 }
533 } while (trimmings > threshold);
534 /* allocate space for mapping */
535 if (!tmNewMap(tms))
536 returnErr(TM_E_NOMEM);
537 /* assign tone-mapping */
538 for (i = tms->mbrmax-tms->mbrmin+1; i--; ) {
539 j = d = (double)i/(tms->mbrmax-tms->mbrmin)*histlen;
540 d -= (double)j;
541 Ld = Ldmin*exp(logLddyn*((1.-d)*cumf[j]+d*cumf[j+1]));
542 d = (Ld - Ldmin)/(Ldmax - Ldmin);
543 tms->lumap[i] = 256.*pow(d, 1./gamval);
544 }
545 free((MEM_PTR)histo); /* clean up and return */
546 free((MEM_PTR)cumf);
547 returnOK;
548 linearmap: /* linear tone-mapping */
549 if (tms->flags & TM_F_HCONTR)
550 d = htcontrs(Ldavg) / htcontrs(Lwavg);
551 else
552 d = Ldavg / Lwavg;
553 return(tmFixedMapping(tms, tms->inpsf*d/Ldmax, gamval));
554 }
555
556
557 int
558 tmMapPixels( /* apply tone-mapping to pixel(s) */
559 TMstruct *tms,
560 uby8 *ps,
561 TMbright *ls,
562 uby8 *cs,
563 int len
564 )
565 {
566 static const char funcName[] = "tmMapPixels";
567 int32 li, pv;
568
569 if (tms == NULL || tms->lumap == NULL)
570 returnErr(TM_E_TMINVAL);
571 if ((ps == NULL) | (ls == NULL) | (len < 0))
572 returnErr(TM_E_ILLEGAL);
573 while (len--) {
574 if ((li = *ls++) < tms->mbrmin) {
575 li = 0;
576 } else {
577 if (li > tms->mbrmax)
578 li = tms->mbrmax;
579 li = tms->lumap[li - tms->mbrmin];
580 }
581 if (cs == TM_NOCHROM)
582 *ps++ = li>255 ? 255 : li;
583 else {
584 pv = *cs++ * li / tms->cdiv[RED];
585 *ps++ = pv>255 ? 255 : pv;
586 pv = *cs++ * li / tms->cdiv[GRN];
587 *ps++ = pv>255 ? 255 : pv;
588 pv = *cs++ * li / tms->cdiv[BLU];
589 *ps++ = pv>255 ? 255 : pv;
590 }
591 }
592 returnOK;
593 }
594
595
596 TMstruct *
597 tmDup( /* duplicate top tone mapping */
598 TMstruct *tms
599 )
600 {
601 int len;
602 int i;
603 TMstruct *tmnew;
604
605 if (tms == NULL) /* anything to duplicate? */
606 return(NULL);
607 tmnew = (TMstruct *)malloc(sizeof(TMstruct));
608 if (tmnew == NULL)
609 return(NULL);
610 *tmnew = *tms; /* copy everything */
611 if (tmnew->histo != NULL) { /* duplicate histogram */
612 len = HISTI(tmnew->hbrmax) + 1 - HISTI(tmnew->hbrmin);
613 tmnew->histo = (HIST_TYP *)malloc(len*sizeof(HIST_TYP));
614 if (tmnew->histo != NULL)
615 memcpy((MEM_PTR)tmnew->histo, (MEM_PTR)tms->histo,
616 len*sizeof(HIST_TYP));
617 }
618 if (tmnew->lumap != NULL) { /* duplicate luminance mapping */
619 len = tmnew->mbrmax-tmnew->mbrmin+1;
620 tmnew->lumap = (TMAP_TYP *)malloc(len*sizeof(TMAP_TYP));
621 if (tmnew->lumap != NULL)
622 memcpy((MEM_PTR)tmnew->lumap, (MEM_PTR)tms->lumap,
623 len*sizeof(TMAP_TYP));
624 }
625 /* clear package data */
626 for (i = tmNumPkgs; i--; )
627 tmnew->pd[i] = NULL;
628 /* return copy */
629 return(tmnew);
630 }
631
632
633 void
634 tmDone(tms) /* done with tone mapping -- destroy it */
635 TMstruct *tms;
636 {
637 int i;
638 /* NULL arg. is equiv. to tms */
639 if (tms == NULL)
640 return;
641 /* free tables */
642 if (tms->histo != NULL)
643 free((MEM_PTR)tms->histo);
644 if (tms->lumap != NULL)
645 free((MEM_PTR)tms->lumap);
646 /* free private data */
647 for (i = tmNumPkgs; i--; )
648 if (tms->pd[i] != NULL)
649 (*tmPkg[i]->Free)(tms->pd[i]);
650 free((MEM_PTR)tms); /* free basic structure */
651 }
652
653 /******************** Shared but Private library routines *********************/
654
655 uby8 tmMesofact[BMESUPPER-BMESLOWER];
656
657 void
658 tmMkMesofact() /* build mesopic lookup factor table */
659 {
660 int i;
661
662 if (tmMesofact[BMESUPPER-BMESLOWER-1])
663 return;
664
665 for (i = BMESLOWER; i < BMESUPPER; i++)
666 tmMesofact[i-BMESLOWER] = 256. *
667 (tmLuminance(i) - LMESLOWER) /
668 (LMESUPPER - LMESLOWER);
669 }
670
671
672 int
673 tmNewMap( /* allocate new tone-mapping array */
674 TMstruct *tms
675 )
676 {
677 if (tms->lumap != NULL && (tms->mbrmax - tms->mbrmin) !=
678 (tms->hbrmax - tms->hbrmin)) {
679 free((MEM_PTR)tms->lumap);
680 tms->lumap = NULL;
681 }
682 tms->mbrmin = tms->hbrmin;
683 tms->mbrmax = tms->hbrmax;
684 if (tms->mbrmin > tms->mbrmax)
685 return 0;
686 if (tms->lumap == NULL)
687 tms->lumap = (TMAP_TYP *)malloc(sizeof(TMAP_TYP)*
688 (tms->mbrmax-tms->mbrmin+1));
689 return(tms->lumap != NULL);
690 }
691
692
693 int
694 tmErrorReturn( /* error return (with message) */
695 const char *func,
696 TMstruct *tms,
697 int err
698 )
699 {
700 if (tms != NULL) {
701 tms->lastFunc = func;
702 tms->lastError = err;
703 if (tms->flags & TM_F_NOSTDERR)
704 return(err);
705 }
706 fputs(func, stderr);
707 fputs(": ", stderr);
708 fputs(tmErrorMessage[err], stderr);
709 fputs("!\n", stderr);
710 return(err);
711 }