ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/rt/ray.h
Revision: 2.13
Committed: Tue Feb 25 02:47:23 2003 UTC (21 years, 2 months ago) by greg
Content type: text/plain
Branch: MAIN
Changes since 2.12: +2 -57 lines
Log Message:
Replaced inline copyright notice with #include "copyright.h"

File Contents

# User Rev Content
1 greg 2.13 /* RCSid $Id$ */
2 greg 1.1 /*
3     * ray.h - header file for routines using rays.
4 greg 2.12 */
5    
6 greg 2.13 #include "copyright.h"
7 greg 1.1
8     #include "standard.h"
9    
10 greg 2.12 #include "octree.h"
11    
12 greg 1.1 #include "object.h"
13    
14     #include "color.h"
15    
16 greg 2.6 #define MAXDIM 32 /* maximum number of dimensions */
17    
18 greg 1.1 /* ray type flags */
19     #define PRIMARY 01 /* original ray */
20     #define SHADOW 02 /* ray to light source */
21     #define REFLECTED 04 /* reflected ray */
22     #define REFRACTED 010 /* refracted (bent) ray */
23     #define TRANS 020 /* transmitted/transferred ray */
24     #define AMBIENT 040 /* ray scattered for interreflection */
25 greg 2.2 #define SPECULAR 0100 /* ray scattered for specular */
26 greg 1.1
27     /* reflected ray types */
28 greg 2.2 #define RAYREFL (SHADOW|REFLECTED|AMBIENT|SPECULAR)
29 greg 1.1
30     typedef struct ray {
31 greg 2.3 unsigned long rno; /* unique ray number */
32 greg 2.12 int rlvl; /* number of reflections for this ray */
33     float rweight; /* cumulative weight of this ray */
34     short rtype; /* ray type */
35     short crtype; /* cumulative ray type */
36 greg 1.1 struct ray *parent; /* ray this originated from */
37 greg 2.12 FVECT rorg; /* origin of ray */
38     FVECT rdir; /* normalized direction of ray */
39     double rmax; /* maximum distance (aft clipping plane) */
40     int rsrc; /* source we're aiming for */
41     OBJECT *clipset; /* set of objects currently clipped */
42     OBJECT *newcset; /* next clipset, used for transmission */
43     void (*revf)(); /* evaluation function for this ray */
44 greg 2.11 OBJECT robj; /* intersected object number */
45 greg 2.12 OBJREC *ro; /* intersected object (one with material) */
46     double rot; /* distance to object */
47     FVECT rop; /* intersection point */
48     FVECT ron; /* intersection surface normal */
49     double rod; /* -DOT(rdir, ron) */
50     FULLXF *rox; /* object transformation */
51     FVECT pert; /* surface normal perturbation */
52     COLOR pcol; /* pattern color */
53     COLOR rcol; /* returned ray value */
54     double rt; /* returned effective ray length */
55     COLOR cext; /* medium extinction coefficient */
56     COLOR albedo; /* medium scattering albedo */
57     float gecc; /* scattering eccentricity coefficient */
58     int *slights; /* list of lights to test for scattering */
59 greg 1.1 } RAY;
60    
61 greg 2.12 #define rayvalue(r) (*(r)->revf)(r)
62    
63     extern char VersionID[]; /* Radiance version ID string */
64 greg 1.6
65 greg 2.12 extern CUBE thescene; /* our scene */
66     extern OBJECT nsceneobjs; /* number of objects in our scene */
67 greg 2.5
68 greg 2.12 extern unsigned long raynum; /* next ray ID */
69     extern unsigned long nrays; /* total rays traced so far */
70 greg 1.5
71 greg 2.12 extern OBJREC Lamb; /* a Lambertian surface */
72     extern OBJREC Aftplane; /* aft clipping object */
73    
74     extern void (*trace)(); /* global trace reporting callback */
75    
76     extern int dimlist[]; /* dimension list for distribution */
77     extern int ndims; /* number of dimensions so far */
78     extern int samplendx; /* index for this sample */
79    
80     extern int ray_savesiz; /* size of parameter save buffer */
81    
82     extern int do_irrad; /* compute irradiance? */
83    
84     extern double dstrsrc; /* square source distribution */
85     extern double shadthresh; /* shadow threshold */
86     extern double shadcert; /* shadow testing certainty */
87     extern int directrelay; /* number of source relays */
88     extern int vspretest; /* virtual source pretest density */
89     extern int directvis; /* light sources visible to eye? */
90     extern double srcsizerat; /* maximum source size/dist. ratio */
91    
92     extern double specthresh; /* specular sampling threshold */
93     extern double specjitter; /* specular sampling jitter */
94    
95     extern COLOR cextinction; /* global extinction coefficient */
96     extern COLOR salbedo; /* global scattering albedo */
97     extern double seccg; /* global scattering eccentricity */
98     extern double ssampdist; /* scatter sampling distance */
99    
100     extern int backvis; /* back face visibility */
101    
102     extern int maxdepth; /* maximum recursion depth */
103     extern double minweight; /* minimum ray weight */
104    
105     extern char *ambfile; /* ambient file name */
106     extern COLOR ambval; /* ambient value */
107     extern int ambvwt; /* initial weight for ambient value */
108     extern double ambacc; /* ambient accuracy */
109     extern int ambres; /* ambient resolution */
110     extern int ambdiv; /* ambient divisions */
111     extern int ambssamp; /* ambient super-samples */
112     extern int ambounce; /* ambient bounces */
113     extern char *amblist[]; /* ambient include/exclude list */
114     extern int ambincl; /* include == 1, exclude == 0 */
115    
116     extern int ray_pnprocs; /* number of child processes */
117     extern int ray_pnidle; /* number of idle processes */
118    
119     #define AMBLLEN 128 /* max. ambient list length */
120     #define AMBWORD 8 /* average word length */
121    
122     typedef struct { /* rendering parameter holder */
123     int do_irrad;
124     double dstrsrc;
125     double shadthresh;
126     double shadcert;
127     int directrelay;
128     int vspretest;
129     int directvis;
130     double srcsizerat;
131     COLOR cextinction;
132     COLOR salbedo;
133     double seccg;
134     double ssampdist;
135     double specthresh;
136     double specjitter;
137     int backvis;
138     int maxdepth;
139     double minweight;
140     char ambfile[512];
141     COLOR ambval;
142     int ambvwt;
143     double ambacc;
144     int ambres;
145     int ambdiv;
146     int ambssamp;
147     int ambounce;
148     int ambincl;
149     short amblndx[AMBLLEN+1];
150     char amblval[AMBLLEN*AMBWORD];
151     } RAYPARAMS;
152    
153     #define rpambmod(p,i) ( (i)>=AMBLLEN||(p)->amblndx[i]<0 ? \
154     (char *)NULL : (p)->amblval+(p)->amblndx[i] )
155    
156     #ifdef NOPROTO
157    
158     extern void headclean();
159     extern void openheader();
160     extern void dupheader();
161     extern void pfdetach();
162     extern void pfclean();
163     extern void pflock();
164     extern void pfhold();
165     extern void io_process();
166     extern int free_objs();
167     extern void free_objmem();
168     extern int load_os();
169     extern void preload_objs();
170     extern void ray_init();
171     extern void ray_trace();
172     extern void ray_done();
173     extern void ray_save();
174     extern void ray_restore();
175     extern void ray_defaults();
176     extern void ray_pinit();
177     extern void ray_psend();
178     extern int ray_pqueue();
179     extern int ray_presult();
180     extern void ray_pdone();
181     extern void ray_popen();
182     extern void ray_pclose();
183     extern int rayorigin();
184     extern void rayclear();
185     extern void raytrace();
186     extern void raycont();
187     extern void raytrans();
188     extern int rayshade();
189     extern void rayparticipate();
190     extern int raymixture();
191     extern double raydist();
192     extern double raynormal();
193     extern void newrayxf();
194     extern void flipsurface();
195     extern int localhit();
196     extern int getrenderopt();
197     extern void print_rdefaults();
198     extern void drawsources();
199     extern void rtrace();
200     extern void rview();
201     extern void rpict();
202    
203     #else
204     /* defined in duphead.c */
205     extern void headclean(void);
206     extern void openheader(void);
207     extern void dupheader(void);
208     extern void pfdetach(void);
209     extern void pfclean(void);
210     extern void pflock(int lf);
211     extern void pfhold(void);
212     extern void io_process(void);
213     /* defined in freeobjmem.c */
214     extern int free_objs(OBJECT on, OBJECT no);
215     extern void free_objmem(void);
216     /* defined in preload.c */
217     extern int load_os(OBJREC *op);
218     extern void preload_objs(void);
219     /* defined in raycalls.c */
220     extern void ray_init(char *otnm);
221     extern void ray_trace(RAY *r);
222     extern void ray_done(int freall);
223     extern void ray_save(RAYPARAMS *rp);
224     extern void ray_restore(RAYPARAMS *rp);
225     extern void ray_defaults(RAYPARAMS *rp);
226     /* defined in raypcalls.c */
227     extern void ray_pinit(char *otnm, int nproc);
228     extern void ray_psend(RAY *r);
229     extern int ray_pqueue(RAY *r);
230     extern int ray_presult(RAY *r, int poll);
231     extern void ray_pdone(int freall);
232     extern void ray_popen(int nadd);
233     extern void ray_pclose(int nsub);
234     /* defined in raytrace.c */
235     extern int rayorigin(RAY *r, RAY *ro, int rt, double rw);
236     extern void rayclear(RAY *r);
237     extern void raytrace(RAY *r);
238     extern void raycont(RAY *r);
239     extern void raytrans(RAY *r);
240     extern int rayshade(RAY *r, int mod);
241     extern void rayparticipate(RAY *r);
242     extern int raymixture(RAY *r, OBJECT fore, OBJECT back, double coef);
243     extern double raydist(RAY *r, int flags);
244     extern double raynormal(FVECT norm, RAY *r);
245     extern void newrayxf(RAY *r);
246     extern void flipsurface(RAY *r);
247     extern int localhit(RAY *r, CUBE *scene);
248     /* defined in renderopts.c */
249     extern int getrenderopt(int ac, char *av[]);
250     extern void print_rdefaults(void);
251     /* defined in srcdraw.c */
252     extern void drawsources(COLOR *pic[], float *zbf[],
253     int x0, int xsiz, int y0, int ysiz);
254     /* module main procedures */
255     extern void rtrace(char *fname);
256     extern void rview(void);
257     extern void rpict(int seq, char *pout, char *zout, char *prvr);
258 greg 1.6
259 greg 2.12 #endif