ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/rt/ambient.h
Revision: 2.19
Committed: Fri Apr 11 20:31:37 2014 UTC (10 years ago) by greg
Content type: text/plain
Branch: MAIN
Changes since 2.18: +83 -4 lines
Log Message: 
Partial implementation of Hessian gradient calculation (-DNEWAMB)

File Contents

# User Rev Content
1 greg 2.19 /* RCSid $Id: ambient.h,v 2.18 2011/09/22 02:15:56 greg Exp $ */
2 greg 1.1 /*
3     * Common definitions for interreflection routines.
4 greg 2.7 *
5     * Include after ray.h
6     */
7 greg 2.19
8 schorsch 2.9 #ifndef _RAD_AMBIENT_H_
9     #define _RAD_AMBIENT_H_
10     #ifdef __cplusplus
11     extern "C" {
12     #endif
13 greg 1.1
14 greg 2.19 #ifdef NEWAMB
15    
16     /*
17     * Normal and u-vector directions encoded using dircode.c
18     */
19     typedef struct ambrec {
20     struct ambrec *next; /* next in list */
21     unsigned long latick; /* last accessed tick */
22     float pos[3]; /* position in space */
23     int32 ndir; /* encoded surface normal */
24     int32 udir; /* u-vector direction */
25     int lvl; /* recursion level of parent ray */
26     float weight; /* weight of parent ray */
27     float rad[2]; /* anisotropic radii (rad[0] <= rad[1]) */
28     COLOR val; /* computed ambient value */
29     float gpos[2]; /* (u,v) gradient wrt. position */
30     float gdir[2]; /* (u,v) gradient wrt. direction */
31     } AMBVAL; /* ambient value */
32    
33     typedef struct ambtree {
34     AMBVAL *alist; /* ambient value list */
35     struct ambtree *kid; /* 8 child nodes */
36     } AMBTREE; /* ambient octree */
37    
38     typedef struct {
39     COLOR v; /* division sum (partial) */
40     float r; /* 1/distance sum */
41     float k; /* variance for this division */
42     int n; /* number of subsamples */
43     unsigned short t, p; /* theta, phi indices */
44     } AMBSAMP; /* ambient sample division */
45    
46     typedef struct {
47     FVECT ux, uy, uz; /* x, y and z axis directions */
48     COLOR acoef; /* division contribution coefficient */
49     int ns; /* number of super-samples */
50     int nt, np; /* number of theta and phi directions */
51     } AMBHEMI; /* ambient sample hemisphere */
52    
53     extern double maxarad; /* maximum ambient radius */
54     extern double minarad; /* minimum ambient radius */
55    
56     #ifndef AVGREFL
57     #define AVGREFL 0.5 /* assumed average reflectance */
58     #endif
59    
60     #define AMBVALSIZ 63 /* number of bytes in portable AMBVAL struct */
61     #define AMBMAGIC 558 /* magic number for ambient value files */
62     #define AMBFMT "Radiance_ambval" /* format id string */
63    
64     /* defined in ambient.c */
65     extern void setambres(int ar);
66     extern void setambacc(double newa);
67     extern void setambient(void);
68     extern void multambient(COLOR aval, RAY *r, FVECT nrm);
69     extern void ambdone(void);
70     extern void ambnotify(OBJECT obj);
71     extern double sumambient(COLOR acol, RAY *r, FVECT rn, int al,
72     AMBTREE *at, FVECT c0, double s);
73     extern int makeambient(COLOR acol, RAY *r, FVECT rn, int al);
74     extern void extambient(COLOR cr, AMBVAL *ap, FVECT pv, FVECT nv);
75     extern int ambsync(void);
76     /* defined in ambcomp.c */
77     extern int doambient(COLOR acol, RAY *r, double wt,
78     FVECT uv[2], float rad[2],
79     float gpos[2], float gdir[2]);
80     extern void inithemi(AMBHEMI *hp, COLOR ac, RAY *r, double wt);
81     extern int divsample(AMBSAMP *dp, AMBHEMI *h, RAY *r);
82     extern void comperrs(AMBSAMP *da, AMBHEMI *hp);
83     extern void posgradient(FVECT gv, AMBSAMP *da, AMBHEMI *hp);
84     extern void dirgradient(FVECT gv, AMBSAMP *da, AMBHEMI *hp);
85     /* defined in ambio.c */
86     extern void putambmagic(FILE *fp);
87     extern int hasambmagic(FILE *fp);
88     extern int writambval(AMBVAL *av, FILE *fp);
89     extern int ambvalOK(AMBVAL *av);
90     extern int readambval(AMBVAL *av, FILE *fp);
91    
92     #else /* ! NEWAMB */
93    
94 greg 1.1 /*
95     * Since we've defined our vectors as float below to save space,
96     * watch out for changes in the definitions of VCOPY() and DOT()
97     * and don't pass these vectors to fvect routines.
98     */
99     typedef struct ambrec {
100 greg 2.18 struct ambrec *next; /* next in list */
101 greg 2.5 unsigned long latick; /* last accessed tick */
102 greg 1.1 float pos[3]; /* position in space */
103     float dir[3]; /* normal direction */
104 greg 2.14 int lvl; /* recursion level of parent ray */
105 greg 1.1 float weight; /* weight of parent ray */
106     float rad; /* validity radius */
107     COLOR val; /* computed ambient value */
108     float gpos[3]; /* gradient wrt. position */
109     float gdir[3]; /* gradient wrt. direction */
110     } AMBVAL; /* ambient value */
111    
112 greg 2.7 typedef struct ambtree {
113     AMBVAL *alist; /* ambient value list */
114     struct ambtree *kid; /* 8 child nodes */
115     } AMBTREE; /* ambient octree */
116    
117     typedef struct {
118 greg 2.15 COLOR v; /* division sum (partial) */
119 greg 2.7 float r; /* 1/distance sum */
120     float k; /* variance for this division */
121 greg 2.17 int n; /* number of subsamples */
122     unsigned short t, p; /* theta, phi indices */
123 greg 2.7 } AMBSAMP; /* ambient sample division */
124    
125     typedef struct {
126 greg 2.16 FVECT ux, uy, uz; /* x, y and z axis directions */
127 greg 2.15 COLOR acoef; /* division contribution coefficient */
128 greg 2.16 int ns; /* number of super-samples */
129 greg 2.17 int nt, np; /* number of theta and phi directions */
130 greg 2.7 } AMBHEMI; /* ambient sample hemisphere */
131    
132 greg 1.1 extern double maxarad; /* maximum ambient radius */
133     extern double minarad; /* minimum ambient radius */
134    
135 greg 2.11 #ifndef AVGREFL
136 greg 1.2 #define AVGREFL 0.5 /* assumed average reflectance */
137 greg 2.11 #endif
138 greg 2.2
139     #define AMBVALSIZ 75 /* number of bytes in portable AMBVAL struct */
140 greg 2.4 #define AMBMAGIC 557 /* magic number for ambient value files */
141 greg 2.3 #define AMBFMT "Radiance_ambval" /* format id string */
142 greg 2.7
143     /* defined in ambient.c */
144     extern void setambres(int ar);
145     extern void setambacc(double newa);
146     extern void setambient(void);
147 greg 2.12 extern void multambient(COLOR aval, RAY *r, FVECT nrm);
148 greg 2.7 extern void ambdone(void);
149     extern void ambnotify(OBJECT obj);
150 greg 2.15 extern double sumambient(COLOR acol, RAY *r, FVECT rn, int al,
151 greg 2.7 AMBTREE *at, FVECT c0, double s);
152 greg 2.15 extern double makeambient(COLOR acol, RAY *r, FVECT rn, int al);
153 greg 2.7 extern void extambient(COLOR cr, AMBVAL *ap, FVECT pv, FVECT nv);
154     extern int ambsync(void);
155 greg 2.12 /* defined in ambcomp.c */
156 greg 2.15 extern double doambient(COLOR acol, RAY *r, double wt,
157 greg 2.12 FVECT pg, FVECT dg);
158 greg 2.15 extern void inithemi(AMBHEMI *hp, COLOR ac, RAY *r, double wt);
159 greg 2.12 extern int divsample(AMBSAMP *dp, AMBHEMI *h, RAY *r);
160     extern void comperrs(AMBSAMP *da, AMBHEMI *hp);
161     extern void posgradient(FVECT gv, AMBSAMP *da, AMBHEMI *hp);
162     extern void dirgradient(FVECT gv, AMBSAMP *da, AMBHEMI *hp);
163 greg 2.7 /* defined in ambio.c */
164     extern void putambmagic(FILE *fp);
165     extern int hasambmagic(FILE *fp);
166     extern int writambval(AMBVAL *av, FILE *fp);
167     extern int ambvalOK(AMBVAL *av);
168     extern int readambval(AMBVAL *av, FILE *fp);
169    
170 greg 2.19 #endif /* ! NEWAMB */
171 schorsch 2.9
172     #ifdef __cplusplus
173     }
174 greg 2.7 #endif
175 schorsch 2.9 #endif /* _RAD_AMBIENT_H_ */
176