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

Comparing ray/src/common/bsdf.h (file contents):
Revision 2.19 by greg, Sun Sep 2 15:33:15 2012 UTC vs.
Revision 2.28 by greg, Sat Mar 27 17:50:18 2021 UTC

# Line 25 | Line 25
25  
26   #include "fvect.h"
27   #include "ccolor.h"
28 + #include "platform.h"
29  
30   #ifdef __cplusplus
31   extern "C" {
32   #endif
33  
33 #ifdef _WIN32
34 #define strcasecmp      stricmp
35 #endif
36
34   #define SDnameLn        128             /* maximum BSDF name length */
35   #define SDmaxCh         3               /* maximum # spectral channels */
36  
# Line 58 | Line 55 | extern "C" {
55   typedef enum {SDEnone=0, SDEmemory, SDEfile, SDEformat, SDEargument,
56                  SDEdata, SDEsupport, SDEinternal, SDEunknown} SDError;
57  
58 < /* English ASCII strings corresponding to ennumerated errors */
58 > /* English strings corresponding to ennumerated errors */
59   extern const char       *SDerrorEnglish[];
60  
61 < /* Additional information on last error (ASCII English) */
61 > /* Pointer to error list in preferred language */
62 > extern const char       **SDerrorList;
63 >
64 > /* Additional information on last error (generally in English) */
65   extern char             SDerrorDetail[];
66  
67   /* Holder for BSDF value and spectral color */
# Line 84 | Line 84 | extern const SDCDst    SDemptyCD;      /* empty distribution *
84   typedef struct SDComp_s SDComponent;
85  
86   /* Methods needed to handle BSDF components (nothing is optional) */
87 < typedef const struct {
87 > typedef struct {
88                                          /* return non-diffuse BSDF */
89          int             (*getBSDFs)(float coef[SDmaxCh], const FVECT outVec,
90                                      const FVECT inVec, SDComponent *sdc);
# Line 104 | Line 104 | typedef const struct {
104   /* Structure to hold a spectral BSDF component (typedef SDComponent above) */
105   struct SDComp_s {
106          C_COLOR         cspec[SDmaxCh]; /* component spectral bases */
107 <        SDFunc          *func;          /* methods for this component */
107 >        const SDFunc    *func;          /* methods for this component */
108          void            *dist;          /* loaded distribution data */
109          SDCDst          *cdList;        /* cumulative distribution cache */
110   };
# Line 123 | Line 123 | typedef struct {
123          char            matn[SDnameLn]; /* material name */
124          char            makr[SDnameLn]; /* manufacturer */
125          char            *mgf;           /* geometric description (if any) */
126 <        float           dim[3];         /* width, height, thickness (meters) */
126 >        double          dim[3];         /* width, height, thickness (meters) */
127          SDValue         rLambFront;     /* diffuse front reflectance */
128          SDValue         rLambBack;      /* diffuse rear reflectance */
129 <        SDValue         tLamb;          /* diffuse transmission */
129 >        SDValue         tLambFront;     /* diffuse front transmittance */
130 >        SDValue         tLambBack;      /* diffuse back transmittance */
131          SDSpectralDF    *rf, *rb;       /* non-diffuse BRDF components */
132          SDSpectralDF    *tf, *tb;       /* non-diffuse BTDF components */
133   } SDData;
# Line 145 | Line 146 | extern struct SDCache_s {
146   #define SDretainAll     2               /* also keep cumulative cache data */
147  
148   extern int              SDretainSet;    /* =SDretainNone by default */
149 + extern unsigned long    SDmaxCache;     /* =0 (unlimited) by default */
150  
151   /*****************************************************************
152   * The following routines are less commonly used by applications.
# Line 152 | Line 154 | extern int             SDretainSet;    /* =SDretainNone by default *
154  
155   #define SDisLoaded(sd)  ((sd)->rLambFront.spec.flags != 0)
156  
157 < /* Report an error to the indicated stream (in English) */
158 < extern SDError          SDreportEnglish(SDError ec, FILE *fp);
157 > /* Report an error to the indicated stream */
158 > extern SDError          SDreportError(SDError ec, FILE *fp);
159  
160   /* Shorten file path to useable BSDF name, removing suffix */
161   extern void             SDclipName(char res[SDnameLn], const char *fname);
# Line 190 | Line 192 | extern SDError         SDsampComponent(SDValue *sv, FVECT ioV
192   extern void             SDmultiSamp(double t[], int n, double randX);
193  
194   /* Map a [0,1]^2 square to a unit radius disk */
195 < void                    SDsquare2disk(double ds[2], double seedx, double seedy);
195 > extern void             SDsquare2disk(double ds[2], double seedx, double seedy);
196  
197   /* Map point on unit disk to a unit square in [0,1]^2 range */
198 < void                    SDdisk2square(double sq[2], double diskx, double disky);
198 > extern void             SDdisk2square(double sq[2], double diskx, double disky);
199  
200   /*****************************************************************
201   * The calls below are the ones most applications require.
# Line 201 | Line 203 | void                   SDdisk2square(double sq[2], double diskx, doubl
203   */
204  
205   /* Get BSDF from cache (or load and cache it on first call) */
206 < /* Report any problems to stderr (in English), return NULL on failure */
206 > /* Report any problems to stderr, return NULL on failure */
207   extern const SDData     *SDcacheFile(const char *fname);
208  
209   /* Free a BSDF from our cache (clear all if sd==NULL) */
# Line 245 | Line 247 | extern SDData          *loadBSDF(char *name);
247  
248   /* Application-specific BSDF error translator (not part of our library) */
249   extern char             *transSDError(SDError ec);
248
249 /*################################################################*/
250 /*######### DEPRECATED DEFINITIONS AWAITING PERMANENT REMOVAL #######*/
251 /*
252 * Header for BSDF i/o and access routines
253 */
254
255 #include "mat4.h"
256                                /* up directions */
257 typedef enum {
258        UDzneg=-3,
259        UDyneg=-2,
260        UDxneg=-1,
261        UDunknown=0,
262        UDxpos=1,
263        UDypos=2,
264        UDzpos=3
265 } UpDir;
266                                /* BSDF coordinate calculation routines */
267                                /* vectors always point away from surface */
268
269 typedef int     b_vecf2(FVECT v, int n, void *cd);
270 typedef int     b_ndxf2(FVECT v, void *cd);
271 typedef double  b_radf2(int n, void *cd);
272
273 /* Bidirectional Scattering Distribution Function */
274 struct BSDF_data {
275        int     ninc;                   /* number of incoming directions */
276        int     nout;                   /* number of outgoing directions */
277        float   dim[3];                 /* width, height, thickness (meters) */
278        char    *mgf;                   /* geometric description (if any) */
279        void    *ib_priv;               /* input basis private data */
280        b_vecf2 *ib_vec;                /* get input vector from index */
281        b_ndxf2 *ib_ndx;                /* get input index from vector */
282        b_radf2 *ib_ohm;                /* get input radius for index */
283        void    *ob_priv;               /* output basis private data */
284        b_vecf2 *ob_vec;                /* get output vector from index */
285        b_ndxf2 *ob_ndx;                /* get output index from vector */
286        b_radf2 *ob_ohm;                /* get output radius for index */
287        float   *bsdf;                  /* scattering distribution data */
288 };                              /* bidirectional scattering distrib. func. */
289
290 #define getBSDF_incvec(v,b,i)   (*(b)->ib_vec)(v,i,(b)->ib_priv)
291 #define getBSDF_incndx(b,v)     (*(b)->ib_ndx)(v,(b)->ib_priv)
292 #define getBSDF_incohm(b,i)     (*(b)->ib_ohm)(i,(b)->ib_priv)
293 #define getBSDF_outvec(v,b,o)   (*(b)->ob_vec)(v,o,(b)->ob_priv)
294 #define getBSDF_outndx(b,v)     (*(b)->ob_ndx)(v,(b)->ob_priv)
295 #define getBSDF_outohm(b,o)     (*(b)->ob_ohm)(o,(b)->ob_priv)
296 #define BSDF_value(b,i,o)       (b)->bsdf[(o)*(b)->ninc + (i)]
297
298 extern struct BSDF_data *load_BSDF(char *fname);
299 extern void free_BSDF(struct BSDF_data *b);
300 extern int r_BSDF_incvec(FVECT v, struct BSDF_data *b, int i,
301                                double rv, MAT4 xm);
302 extern int r_BSDF_outvec(FVECT v, struct BSDF_data *b, int o,
303                                double rv, MAT4 xm);
304 extern int getBSDF_xfm(MAT4 xm, FVECT nrm, UpDir ud, char *xfbuf);
305
306 /*######### END DEPRECATED DEFINITIONS #######*/
307 /*################################################################*/
250  
251   #ifdef __cplusplus
252   }

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines