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

Comparing ray/src/common/tonemap.h (file contents):
Revision 3.15 by greg, Mon Jul 14 04:56:54 2003 UTC vs.
Revision 3.17 by greg, Fri Jan 7 20:33:02 2005 UTC

# Line 6 | Line 6
6   */
7   #ifndef _RAD_TONEMAP_H_
8   #define _RAD_TONEMAP_H_
9 +
10 + #include        "tifftypes.h"
11 +
12   #ifdef __cplusplus
13   extern "C" {
14   #endif
15  
13 – #include        "tifftypes.h"
14 –
16   /****    Argument Macros    ****/
17                                  /* Flags of what to do */
18   #define TM_F_HCONTR     01              /* human contrast sensitivity */
# Line 71 | Line 72 | extern char    *tmLastFunction;        /* error-generating funct
72   typedef short   TMbright;               /* encoded luminance type */
73  
74                                  /* basic tone mapping data structure */
75 < extern struct tmStruct {
75 > typedef struct tmStruct {
76          int             flags;          /* flags of what to do */
77          RGBPRIMP        monpri;         /* monitor RGB primaries */
78          double          mongam;         /* monitor gamma value (approx.) */
# Line 84 | Line 85 | extern struct tmStruct {
85          int             *histo;         /* input histogram */
86          TMbright        mbrmin, mbrmax; /* mapped brightness limits */
87          unsigned short  *lumap;         /* computed luminance map */
87 –        struct tmStruct *tmprev;        /* previous tone mapping */
88          MEM_PTR         pd[TM_MAXPKG];  /* pointers to private data */
89 < }       *tmTop;                 /* current tone mapping stack */
89 > } TMstruct;
90  
91                                  /* conversion package functions */
92   struct tmPackage {
93 <        MEM_PTR         (*Init)(struct tmStruct *tms);
94 <        void            (*NewSpace)(struct tmStruct *tms);
93 >        MEM_PTR         (*Init)(TMstruct *tms);
94 >        void            (*NewSpace)(TMstruct *tms);
95          void            (*Free)(MEM_PTR pp);
96   };
97                                  /* our list of conversion packages */
# Line 118 | Line 118 | extern int     tmNumPkgs;      /* number of registered packages
118   /****    Library Function Calls    ****/
119  
120  
121 < extern struct tmStruct *
121 > extern TMstruct *
122   tmInit(int flags, RGBPRIMP monpri, double gamval);
123   /*
124 <        Initialize new tone mapping and push it onto stack.
124 >        Allocate and initialize new tone mapping.
125  
126          flags   -       TM_F_* flags indicating what is to be done.
127          monpri  -       display monitor primaries (Note 1).
128          gamval  -       display gamma response (can be approximate).
129  
130 <        returns -       new tmTop, or NULL if insufficient memory.
130 >        returns -       new tone-mapping pointer, or NULL if no memory.
131   */
132  
133   extern int
134 < tmSetSpace(RGBPRIMP pri, double sf);
134 > tmSetSpace(TMstruct *tms, RGBPRIMP pri, double sf);
135   /*
136          Set color primaries and scale factor for incoming scanlines.
137  
138 +        tms     -       tone mapping structure pointer.
139          pri     -       RGB color input primaries (Note 1).
140          sf      -       scale factor to get to luminance in cd/m^2.
141  
# Line 142 | Line 143 | tmSetSpace(RGBPRIMP pri, double sf);
143   */
144  
145   extern void
146 < tmClearHisto(void);
146 > tmClearHisto(TMstruct *tms);
147   /*
148          Clear histogram for current tone mapping.
149 +
150 +        tms     -       tone mapping structure pointer.
151   */
152  
153   extern int
154 < tmAddHisto(TMbright *ls, int len, int wt);
154 > tmAddHisto(TMstruct *tms, TMbright *ls, int len, int wt);
155   /*
156          Add brightness values to current histogram.
157  
158 +        tms     -       tone mapping structure pointer.
159          ls      -       encoded luminance values.
160          len     -       number of luminance values.
161          wt      -       integer weight to use for each value (usually 1 or -1).
# Line 160 | Line 164 | tmAddHisto(TMbright *ls, int len, int wt);
164   */
165  
166   extern int
167 < tmFixedMapping(double expmult, double gamval);
167 > tmFixedMapping(TMstruct *tms, double expmult, double gamval);
168   /*
169          Assign a fixed, linear tone-mapping using the given multiplier,
170          which is the ratio of maximum output to uncalibrated input.
# Line 168 | Line 172 | tmFixedMapping(double expmult, double gamval);
172          until a new tone mapping is computed.
173          Only the min. and max. values are used from the histogram.
174          
175 +        tms     -       tone mapping structure pointer.
176          expmult -       the fixed exposure multiplier to use.
177          gamval  -       display gamma response (0. for default).
178          returns -       0 on success, TM_E_* on error.
179   */
180  
181   extern int
182 < tmComputeMapping(double gamval, double Lddyn, double Ldmax);
182 > tmComputeMapping(TMstruct *tms, double gamval, double Lddyn, double Ldmax);
183   /*
184          Compute tone mapping function from the current histogram.
185          This mapping will be used in subsequent calls to tmMapPixels()
186          until a new tone mapping is computed.
187          I.e., calls to tmAddHisto() have no immediate effect.
188  
189 +        tms     -       tone mapping structure pointer.
190          gamval  -       display gamma response (0. for default).
191          Lddyn   -       the display's dynamic range (0. for default).
192          Ldmax   -       maximum display luminance in cd/m^2 (0. for default).
# Line 189 | Line 195 | tmComputeMapping(double gamval, double Lddyn, double L
195   */
196  
197   extern int
198 < tmMapPixels(BYTE *ps, TMbright *ls, BYTE *cs, int len);
198 > tmMapPixels(TMstruct *tms, BYTE *ps, TMbright *ls, BYTE *cs, int len);
199   /*
200          Apply tone mapping function to pixel values.
201  
202 +        tms     -       tone mapping structure pointer.
203          ps      -       returned pixel values (Note 2).
204          ls      -       encoded luminance values.
205          cs      -       encoded chrominance values (Note 2).
# Line 201 | Line 208 | tmMapPixels(BYTE *ps, TMbright *ls, BYTE *cs, int len)
208          returns -       0 on success, TM_E_* on failure.
209   */
210  
211 < extern struct tmStruct *
212 < tmPop(void);
211 > extern TMstruct *
212 > tmDup(TMstruct *orig);
213   /*
214 <        Pops current tone mapping from stack.
214 >        Duplicate the given tone mapping into a new struct.
215  
216 <        returns -       pointer to tone mapping structure, or NULL if none.
216 >        orig    -       tone mapping structure to duplicate.
217 >        returns -       pointer to new struct, or NULL on error.
218   */
219  
212 – extern int
213 – tmPull(struct tmStruct *tms);
214 – /*
215 –        Pull tone mapping from anywhere in stack.
216 –
217 –        tms     -       tone mapping structure to find.
218 –
219 –        returns -       1 if found in stack, 0 otherwise.
220 – */
221 –
222 – extern int
223 – tmPush(struct tmStruct *tms);
224 – /*
225 –        Make tone mapping active by (pulling it and) pushing it to the top.
226 –
227 –        tms     -       initialized tone mapping structure.
228 –
229 –        returns -       0 on success, TM_E_* if tms is invalid.
230 – */
231 –
232 – extern struct tmStruct *
233 – tmDup(void);
234 – /*
235 –        Duplicate the current tone mapping into a new structure on the stack.
236 –
237 –        returns -       pointer to new top, or NULL on error.
238 – */
239 –
220   extern void
221 < tmDone(struct tmStruct *tms);
221 > tmDone(TMstruct *tms);
222   /*
223          Free data associated with the given tone mapping structure.
244 –        Calls tmPull() first to remove it from the stack if present.
245 –        The calls tmDone(tmPop()), tmDone(tmTop) and tmDone(NULL)
246 –        all have the same effect, which is to remove and free
247 –        the current tone mapping.
224  
225          tms     -       tone mapping structure to free.
226   */
227  
228   extern int
229 < tmCvColors(TMbright *ls, BYTE *cs, COLOR *scan, int len);
229 > tmCvColors(TMstruct *tms, TMbright *ls, BYTE *cs, COLOR *scan, int len);
230   /*
231          Convert RGB/XYZ float scanline to encoded luminance and chrominance.
232  
233 +        tms     -       tone mapping structure pointer.
234          ls      -       returned encoded luminance values.
235          cs      -       returned encoded chrominance values (Note 2).
236          scan    -       input scanline.
# Line 263 | Line 240 | tmCvColors(TMbright *ls, BYTE *cs, COLOR *scan, int le
240   */
241  
242   extern int
243 < tmCvGrays(TMbright *ls, float *scan, int len);
243 > tmCvGrays(TMstruct *tms, TMbright *ls, float *scan, int len);
244   /*
245          Convert gray float scanline to encoded luminance.
246  
247 +        tms     -       tone mapping structure pointer.
248          ls      -       returned encoded luminance values.
249          scan    -       input scanline.
250          len     -       scanline length.
# Line 275 | Line 253 | tmCvGrays(TMbright *ls, float *scan, int len);
253   */
254  
255   extern int
256 < tmCvColrs(TMbright *ls, BYTE *cs, COLR *scan, int len);
256 > tmCvColrs(TMstruct *tms, TMbright *ls, BYTE *cs, COLR *scan, int len);
257   /*
258          Convert RGBE/XYZE scanline to encoded luminance and chrominance.
259  
260 +        tms     -       tone mapping structure pointer.
261          ls      -       returned encoded luminance values.
262          cs      -       returned encoded chrominance values (Note 2).
263          scan    -       input scanline.
# Line 288 | Line 267 | tmCvColrs(TMbright *ls, BYTE *cs, COLR *scan, int len)
267   */
268  
269   extern int
270 < tmLoadPicture(TMbright **lpp, BYTE **cpp, int *xp, int *yp,
270 > tmLoadPicture(TMstruct *tms, TMbright **lpp, BYTE **cpp, int *xp, int *yp,
271                  char *fname, FILE *fp);
272   /*
273          Load Radiance picture and convert to tone mapping representation.
# Line 296 | Line 275 | tmLoadPicture(TMbright **lpp, BYTE **cpp, int *xp, int
275          malloc(3), and should be freed with free(3) when no longer needed.
276          Calls tmSetSpace() to calibrate input color space.
277  
278 +        tms     -       tone mapping structure pointer.
279          lpp     -       returned array of encoded luminances, picture ordering.
280          cpp     -       returned array of encoded chrominances (Note 2).
281          xp, yp  -       returned picture dimensions.
# Line 311 | Line 291 | tmMapPicture(BYTE **psp, int *xp, int *yp, int flags,
291                  char *fname, FILE *fp);
292   /*
293          Load and apply tone mapping to Radiance picture.
314 –        Stack is restored to its original state upon return.
294          If fp is TM_GETFILE and (flags&TM_F_UNIMPL)!=0, tmMapPicture()
295          calls pcond to perform the actual conversion, which takes
296          longer but gives access to all the TM_F_* features.
# Line 332 | Line 311 | tmMapPicture(BYTE **psp, int *xp, int *yp, int flags,
311   */
312  
313   extern int
314 < tmCvRGB48(TMbright *ls, BYTE *cs, uint16 (*scan)[3], int len, double gv);
314 > tmCvRGB48(TMstruct *tms, TMbright *ls, BYTE *cs, uint16 (*scan)[3],
315 >                int len, double gv);
316   /*
317          Convert 48-bit RGB scanline to encoded luminance and chrominance.
318  
319 +        tms     -       tone mapping structure pointer.
320          ls      -       returned encoded luminance values.
321          cs      -       returned encoded chrominance values (Note 2).
322          scan    -       input scanline.
# Line 346 | Line 327 | tmCvRGB48(TMbright *ls, BYTE *cs, uint16 (*scan)[3], i
327   */
328  
329   extern int
330 < tmCvGray16(TMbright *ls, uint16 *scan, int len, double gv);
330 > tmCvGray16(TMstruct *tms, TMbright *ls, uint16 *scan, int len, double gv);
331   /*
332          Convert 16-bit gray scanline to encoded luminance.
333  
334 +        tms     -       tone mapping structure pointer.
335          ls      -       returned encoded luminance values.
336          scan    -       input scanline.
337          len     -       scanline length.

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines