ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/rt/raytrace.c
Revision: 2.82
Committed: Mon Jan 4 19:07:15 2021 UTC (3 years, 4 months ago) by greg
Content type: text/plain
Branch: MAIN
Changes since 2.81: +3 -1 lines
Log Message:
refactor: added default initialization of RAY ron, rod members

File Contents

# Content
1 #ifndef lint
2 static const char RCSid[] = "$Id: raytrace.c,v 2.81 2020/03/29 18:21:57 greg Exp $";
3 #endif
4 /*
5 * raytrace.c - routines for tracing and shading rays.
6 *
7 * External symbols declared in ray.h
8 */
9
10 #include "copyright.h"
11
12 #include "ray.h"
13 #include "source.h"
14 #include "otypes.h"
15 #include "otspecial.h"
16 #include "random.h"
17 #include "pmap.h"
18
19 #define MAXCSET ((MAXSET+1)*2-1) /* maximum check set size */
20
21 RNUMBER raynum = 0; /* next unique ray number */
22 RNUMBER nrays = 0; /* number of calls to localhit */
23
24 static RREAL Lambfa[5] = {PI, PI, PI, 0.0, 0.0};
25 OBJREC Lamb = {
26 OVOID, MAT_PLASTIC, "Lambertian",
27 {NULL, Lambfa, 0, 5}, NULL
28 }; /* a Lambertian surface */
29
30 OBJREC Aftplane; /* aft clipping plane object */
31
32 #define RAYHIT (-1) /* return value for intercepted ray */
33
34 static int raymove(FVECT pos, OBJECT *cxs, int dirf, RAY *r, CUBE *cu);
35 static int checkhit(RAY *r, CUBE *cu, OBJECT *cxs);
36 static void checkset(OBJECT *os, OBJECT *cs);
37
38
39 int
40 rayorigin( /* start new ray from old one */
41 RAY *r,
42 int rt,
43 const RAY *ro,
44 const COLOR rc
45 )
46 {
47 double rw, re;
48 /* assign coefficient/weight */
49 if (rc == NULL) {
50 rw = 1.0;
51 setcolor(r->rcoef, 1., 1., 1.);
52 } else {
53 rw = intens(rc);
54 if (rw > 1.0)
55 rw = 1.0; /* avoid calculation growth */
56 if (rc != r->rcoef)
57 copycolor(r->rcoef, rc);
58 }
59 if ((r->parent = ro) == NULL) { /* primary ray */
60 r->rlvl = 0;
61 r->rweight = rw;
62 r->crtype = r->rtype = rt;
63 r->rsrc = -1;
64 r->clipset = NULL;
65 r->revf = raytrace;
66 copycolor(r->cext, cextinction);
67 copycolor(r->albedo, salbedo);
68 r->gecc = seccg;
69 r->slights = NULL;
70 } else { /* spawned ray */
71 if (ro->rot >= FHUGE*.99) {
72 memset(r, 0, sizeof(RAY));
73 return(-1); /* illegal continuation */
74 }
75 r->rlvl = ro->rlvl;
76 if (rt & RAYREFL) {
77 r->rlvl++;
78 r->rsrc = -1;
79 r->clipset = ro->clipset;
80 r->rmax = 0.0;
81 } else {
82 r->rsrc = ro->rsrc;
83 r->clipset = ro->newcset;
84 r->rmax = ro->rmax <= FTINY ? 0.0 : ro->rmax - ro->rot;
85 }
86 r->revf = ro->revf;
87 copycolor(r->cext, ro->cext);
88 copycolor(r->albedo, ro->albedo);
89 r->gecc = ro->gecc;
90 r->slights = ro->slights;
91 r->crtype = ro->crtype | (r->rtype = rt);
92 VCOPY(r->rorg, ro->rop);
93 r->rweight = ro->rweight * rw;
94 /* estimate extinction */
95 re = colval(ro->cext,RED) < colval(ro->cext,GRN) ?
96 colval(ro->cext,RED) : colval(ro->cext,GRN);
97 if (colval(ro->cext,BLU) < re) re = colval(ro->cext,BLU);
98 re *= ro->rot;
99 if (re > 0.1) {
100 if (re > 92.) {
101 r->rweight = 0.0;
102 } else {
103 r->rweight *= exp(-re);
104 }
105 }
106 }
107 rayclear(r);
108 if (r->rweight <= 0.0) /* check for expiration */
109 return(-1);
110 if (r->crtype & SHADOW) /* shadow commitment */
111 return(0);
112 /* ambient in photon map? */
113 if (ro != NULL && ro->crtype & AMBIENT) {
114 if (causticPhotonMapping)
115 return(-1);
116 if (photonMapping && rt != TRANS)
117 return(-1);
118 }
119 if ((maxdepth <= 0) & (rc != NULL)) { /* Russian roulette */
120 if (minweight <= 0.0)
121 error(USER, "zero ray weight in Russian roulette");
122 if ((maxdepth < 0) & (r->rlvl > -maxdepth))
123 return(-1); /* upper reflection limit */
124 if (r->rweight >= minweight)
125 return(0);
126 if (frandom() > r->rweight/minweight)
127 return(-1);
128 rw = minweight/r->rweight; /* promote survivor */
129 scalecolor(r->rcoef, rw);
130 r->rweight = minweight;
131 return(0);
132 }
133 return((r->rweight >= minweight) & (r->rlvl <= abs(maxdepth)) ? 0 : -1);
134 }
135
136
137 void
138 rayclear( /* clear a ray for (re)evaluation */
139 RAY *r
140 )
141 {
142 r->rno = raynum++;
143 r->newcset = r->clipset;
144 r->hitf = rayhit;
145 r->robj = OVOID;
146 r->ro = NULL;
147 r->rox = NULL;
148 r->rxt = r->rmt = r->rot = FHUGE;
149 VCOPY(r->rop, r->rorg);
150 r->ron[0] = -r->rdir[0]; r->ron[1] = -r->rdir[1]; r->ron[2] = -r->rdir[2];
151 r->rod = 1.0;
152 r->pert[0] = r->pert[1] = r->pert[2] = 0.0;
153 r->rflips = 0;
154 r->uv[0] = r->uv[1] = 0.0;
155 setcolor(r->pcol, 1.0, 1.0, 1.0);
156 setcolor(r->mcol, 0.0, 0.0, 0.0);
157 setcolor(r->rcol, 0.0, 0.0, 0.0);
158 }
159
160
161 void
162 raytrace( /* trace a ray and compute its value */
163 RAY *r
164 )
165 {
166 if (localhit(r, &thescene))
167 raycont(r); /* hit local surface, evaluate */
168 else if (r->ro == &Aftplane) {
169 r->ro = NULL; /* hit aft clipping plane */
170 r->rot = FHUGE;
171 } else if (sourcehit(r))
172 rayshade(r, r->ro->omod); /* distant source */
173
174 if (trace != NULL)
175 (*trace)(r); /* trace execution */
176
177 rayparticipate(r); /* for participating medium */
178 }
179
180
181 void
182 raycont( /* check for clipped object and continue */
183 RAY *r
184 )
185 {
186 if ((r->clipset != NULL && inset(r->clipset, r->ro->omod)) ||
187 !rayshade(r, r->ro->omod))
188 raytrans(r);
189 }
190
191
192 void
193 raytrans( /* transmit ray as is */
194 RAY *r
195 )
196 {
197 RAY tr;
198
199 rayorigin(&tr, TRANS, r, NULL); /* always continue */
200 VCOPY(tr.rdir, r->rdir);
201 rayvalue(&tr);
202 copycolor(r->mcol, tr.mcol);
203 copycolor(r->rcol, tr.rcol);
204 r->rmt = r->rot + tr.rmt;
205 r->rxt = r->rot + tr.rxt;
206 }
207
208
209 int
210 raytirrad( /* irradiance hack */
211 OBJREC *m,
212 RAY *r
213 )
214 {
215 if (ofun[m->otype].flags & (T_M|T_X) && m->otype != MAT_CLIP) {
216 if (istransp(m->otype) || isBSDFproxy(m)) {
217 raytrans(r);
218 return(1);
219 }
220 if (!islight(m->otype))
221 return((*ofun[Lamb.otype].funp)(&Lamb, r));
222 }
223 return(0); /* not a qualifying surface */
224 }
225
226
227 int
228 rayshade( /* shade ray r with material mod */
229 RAY *r,
230 int mod
231 )
232 {
233 int tst_irrad = do_irrad && !(r->crtype & ~(PRIMARY|TRANS));
234 OBJREC *m;
235
236 r->rxt = r->rot; /* preset effective ray length */
237 for ( ; mod != OVOID; mod = m->omod) {
238 m = objptr(mod);
239 /****** unnecessary test since modifier() is always called
240 if (!ismodifier(m->otype)) {
241 sprintf(errmsg, "illegal modifier \"%s\"", m->oname);
242 error(USER, errmsg);
243 }
244 ******/
245 /* hack for irradiance calculation */
246 if (tst_irrad && raytirrad(m, r))
247 return(1);
248
249 if ((*ofun[m->otype].funp)(m, r))
250 return(1); /* materials call raytexture() */
251 }
252 return(0); /* no material! */
253 }
254
255
256 void
257 rayparticipate( /* compute ray medium participation */
258 RAY *r
259 )
260 {
261 COLOR ce, ca;
262 double re, ge, be;
263
264 if (intens(r->cext) <= 1./FHUGE)
265 return; /* no medium */
266 re = r->rot*colval(r->cext,RED);
267 ge = r->rot*colval(r->cext,GRN);
268 be = r->rot*colval(r->cext,BLU);
269 if (r->crtype & SHADOW) { /* no scattering for sources */
270 re *= 1. - colval(r->albedo,RED);
271 ge *= 1. - colval(r->albedo,GRN);
272 be *= 1. - colval(r->albedo,BLU);
273 }
274 setcolor(ce, re<=FTINY ? 1. : re>92. ? 0. : exp(-re),
275 ge<=FTINY ? 1. : ge>92. ? 0. : exp(-ge),
276 be<=FTINY ? 1. : be>92. ? 0. : exp(-be));
277 multcolor(r->rcol, ce); /* path extinction */
278 if (r->crtype & SHADOW || intens(r->albedo) <= FTINY)
279 return; /* no scattering */
280
281 /* PMAP: indirect inscattering accounted for by volume photons? */
282 if (!volumePhotonMapping) {
283 setcolor(ca,
284 colval(r->albedo,RED)*colval(ambval,RED)*(1.-colval(ce,RED)),
285 colval(r->albedo,GRN)*colval(ambval,GRN)*(1.-colval(ce,GRN)),
286 colval(r->albedo,BLU)*colval(ambval,BLU)*(1.-colval(ce,BLU)));
287 addcolor(r->rcol, ca); /* ambient in scattering */
288 }
289
290 srcscatter(r); /* source in scattering */
291 }
292
293
294 void
295 raytexture( /* get material modifiers */
296 RAY *r,
297 OBJECT mod
298 )
299 {
300 OBJREC *m;
301 /* execute textures and patterns */
302 for ( ; mod != OVOID; mod = m->omod) {
303 m = objptr(mod);
304 /****** unnecessary test since modifier() is always called
305 if (!ismodifier(m->otype)) {
306 sprintf(errmsg, "illegal modifier \"%s\"", m->oname);
307 error(USER, errmsg);
308 }
309 ******/
310 if ((*ofun[m->otype].funp)(m, r)) {
311 sprintf(errmsg, "conflicting material \"%s\"",
312 m->oname);
313 objerror(r->ro, USER, errmsg);
314 }
315 }
316 }
317
318
319 int
320 raymixture( /* mix modifiers */
321 RAY *r,
322 OBJECT fore,
323 OBJECT back,
324 double coef
325 )
326 {
327 RAY fr, br;
328 double mfore, mback;
329 int foremat, backmat;
330 int i;
331 /* bound coefficient */
332 if (coef > 1.0)
333 coef = 1.0;
334 else if (coef < 0.0)
335 coef = 0.0;
336 /* compute foreground and background */
337 foremat = backmat = 0;
338 /* foreground */
339 fr = *r;
340 if (coef > FTINY) {
341 fr.rweight *= coef;
342 scalecolor(fr.rcoef, coef);
343 foremat = rayshade(&fr, fore);
344 }
345 /* background */
346 br = *r;
347 if (coef < 1.0-FTINY) {
348 br.rweight *= 1.0-coef;
349 scalecolor(br.rcoef, 1.0-coef);
350 backmat = rayshade(&br, back);
351 }
352 /* check for transparency */
353 if (backmat ^ foremat) {
354 if (backmat && coef > FTINY)
355 raytrans(&fr);
356 else if (foremat && coef < 1.0-FTINY)
357 raytrans(&br);
358 }
359 /* mix perturbations */
360 for (i = 0; i < 3; i++)
361 r->pert[i] = coef*fr.pert[i] + (1.0-coef)*br.pert[i];
362 /* mix pattern colors */
363 scalecolor(fr.pcol, coef);
364 scalecolor(br.pcol, 1.0-coef);
365 copycolor(r->pcol, fr.pcol);
366 addcolor(r->pcol, br.pcol);
367 /* return value tells if material */
368 if (!foremat & !backmat)
369 return(0);
370 /* mix returned ray values */
371 scalecolor(fr.rcol, coef);
372 scalecolor(br.rcol, 1.0-coef);
373 copycolor(r->rcol, fr.rcol);
374 addcolor(r->rcol, br.rcol);
375 scalecolor(fr.mcol, coef);
376 scalecolor(br.mcol, 1.0-coef);
377 copycolor(r->mcol, fr.mcol);
378 addcolor(r->mcol, br.mcol);
379 mfore = bright(fr.mcol); mback = bright(br.mcol);
380 r->rmt = mfore > mback ? fr.rmt : br.rmt;
381 r->rxt = bright(fr.rcol)-mfore > bright(br.rcol)-mback ?
382 fr.rxt : br.rxt;
383 return(1);
384 }
385
386
387 double
388 raydist( /* compute (cumulative) ray distance */
389 const RAY *r,
390 int flags
391 )
392 {
393 double sum = 0.0;
394
395 while (r != NULL && r->crtype&flags) {
396 sum += r->rot;
397 r = r->parent;
398 }
399 return(sum);
400 }
401
402
403 void
404 raycontrib( /* compute (cumulative) ray contribution */
405 RREAL rc[3],
406 const RAY *r,
407 int flags
408 )
409 {
410 static int warnedPM = 0;
411
412 rc[0] = rc[1] = rc[2] = 1.;
413
414 while (r != NULL && r->crtype&flags) {
415 int i = 3;
416 while (i--)
417 rc[i] *= colval(r->rcoef,i);
418 /* check for participating medium */
419 if (!warnedPM && (bright(r->cext) > FTINY) |
420 (bright(r->albedo) > FTINY)) {
421 error(WARNING,
422 "ray contribution calculation does not support participating media");
423 warnedPM++;
424 }
425 r = r->parent;
426 }
427 }
428
429
430 double
431 raynormal( /* compute perturbed normal for ray */
432 FVECT norm,
433 RAY *r
434 )
435 {
436 double newdot;
437 int i;
438
439 /* The perturbation is added to the surface normal to obtain
440 * the new normal. If the new normal would affect the surface
441 * orientation wrt. the ray, a correction is made. The method is
442 * still fraught with problems since reflected rays and similar
443 * directions calculated from the surface normal may spawn rays behind
444 * the surface. The only solution is to curb textures at high
445 * incidence (namely, keep DOT(rdir,pert) < Rdot).
446 */
447
448 for (i = 0; i < 3; i++)
449 norm[i] = r->ron[i] + r->pert[i];
450
451 if (normalize(norm) == 0.0) {
452 objerror(r->ro, WARNING, "illegal normal perturbation");
453 VCOPY(norm, r->ron);
454 return(r->rod);
455 }
456 newdot = -DOT(norm, r->rdir);
457 if ((newdot > 0.0) != (r->rod > 0.0)) { /* fix orientation */
458 for (i = 0; i < 3; i++)
459 norm[i] += 2.0*newdot*r->rdir[i];
460 newdot = -newdot;
461 }
462 return(newdot);
463 }
464
465
466 void
467 newrayxf( /* get new tranformation matrix for ray */
468 RAY *r
469 )
470 {
471 static struct xfn {
472 struct xfn *next;
473 FULLXF xf;
474 } xfseed = { &xfseed }, *xflast = &xfseed;
475 struct xfn *xp;
476 const RAY *rp;
477
478 /*
479 * Search for transform in circular list that
480 * has no associated ray in the tree.
481 */
482 xp = xflast;
483 for (rp = r->parent; rp != NULL; rp = rp->parent)
484 if (rp->rox == &xp->xf) { /* xp in use */
485 xp = xp->next; /* move to next */
486 if (xp == xflast) { /* need new one */
487 xp = (struct xfn *)bmalloc(sizeof(struct xfn));
488 if (xp == NULL)
489 error(SYSTEM,
490 "out of memory in newrayxf");
491 /* insert in list */
492 xp->next = xflast->next;
493 xflast->next = xp;
494 break; /* we're done */
495 }
496 rp = r; /* start check over */
497 }
498 /* got it */
499 r->rox = &xp->xf;
500 xflast = xp;
501 }
502
503
504 void
505 flipsurface( /* reverse surface orientation */
506 RAY *r
507 )
508 {
509 r->rod = -r->rod;
510 r->ron[0] = -r->ron[0];
511 r->ron[1] = -r->ron[1];
512 r->ron[2] = -r->ron[2];
513 r->pert[0] = -r->pert[0];
514 r->pert[1] = -r->pert[1];
515 r->pert[2] = -r->pert[2];
516 r->rflips++;
517 }
518
519
520 void
521 rayhit( /* standard ray hit test */
522 OBJECT *oset,
523 RAY *r
524 )
525 {
526 OBJREC *o;
527 int i;
528
529 for (i = oset[0]; i > 0; i--) {
530 o = objptr(oset[i]);
531 if ((*ofun[o->otype].funp)(o, r))
532 r->robj = oset[i];
533 }
534 }
535
536
537 int
538 localhit( /* check for hit in the octree */
539 RAY *r,
540 CUBE *scene
541 )
542 {
543 OBJECT cxset[MAXCSET+1]; /* set of checked objects */
544 FVECT curpos; /* current cube position */
545 int sflags; /* sign flags */
546 double t, dt;
547 int i;
548
549 nrays++; /* increment trace counter */
550 sflags = 0;
551 for (i = 0; i < 3; i++) {
552 curpos[i] = r->rorg[i];
553 if (r->rdir[i] > 1e-7)
554 sflags |= 1 << i;
555 else if (r->rdir[i] < -1e-7)
556 sflags |= 0x10 << i;
557 }
558 if (!sflags) {
559 error(WARNING, "zero ray direction in localhit");
560 return(0);
561 }
562 /* start off assuming nothing hit */
563 if (r->rmax > FTINY) { /* except aft plane if one */
564 r->ro = &Aftplane;
565 r->rot = r->rmax;
566 VSUM(r->rop, r->rorg, r->rdir, r->rot);
567 }
568 /* find global cube entrance point */
569 t = 0.0;
570 if (!incube(scene, curpos)) {
571 /* find distance to entry */
572 for (i = 0; i < 3; i++) {
573 /* plane in our direction */
574 if (sflags & 1<<i)
575 dt = scene->cuorg[i];
576 else if (sflags & 0x10<<i)
577 dt = scene->cuorg[i] + scene->cusize;
578 else
579 continue;
580 /* distance to the plane */
581 dt = (dt - r->rorg[i])/r->rdir[i];
582 if (dt > t)
583 t = dt; /* farthest face is the one */
584 }
585 t += FTINY; /* fudge to get inside cube */
586 if (t >= r->rot) /* clipped already */
587 return(0);
588 /* advance position */
589 VSUM(curpos, curpos, r->rdir, t);
590
591 if (!incube(scene, curpos)) /* non-intersecting ray */
592 return(0);
593 }
594 cxset[0] = 0;
595 raymove(curpos, cxset, sflags, r, scene);
596 return((r->ro != NULL) & (r->ro != &Aftplane));
597 }
598
599
600 static int
601 raymove( /* check for hit as we move */
602 FVECT pos, /* current position, modified herein */
603 OBJECT *cxs, /* checked objects, modified by checkhit */
604 int dirf, /* direction indicators to speed tests */
605 RAY *r,
606 CUBE *cu
607 )
608 {
609 int ax;
610 double dt, t;
611
612 if (istree(cu->cutree)) { /* recurse on subcubes */
613 CUBE cukid;
614 int br, sgn;
615
616 cukid.cusize = cu->cusize * 0.5; /* find subcube */
617 VCOPY(cukid.cuorg, cu->cuorg);
618 br = 0;
619 if (pos[0] >= cukid.cuorg[0]+cukid.cusize) {
620 cukid.cuorg[0] += cukid.cusize;
621 br |= 1;
622 }
623 if (pos[1] >= cukid.cuorg[1]+cukid.cusize) {
624 cukid.cuorg[1] += cukid.cusize;
625 br |= 2;
626 }
627 if (pos[2] >= cukid.cuorg[2]+cukid.cusize) {
628 cukid.cuorg[2] += cukid.cusize;
629 br |= 4;
630 }
631 for ( ; ; ) {
632 cukid.cutree = octkid(cu->cutree, br);
633 if ((ax = raymove(pos,cxs,dirf,r,&cukid)) == RAYHIT)
634 return(RAYHIT);
635 sgn = 1 << ax;
636 if (sgn & dirf) /* positive axis? */
637 if (sgn & br)
638 return(ax); /* overflow */
639 else {
640 cukid.cuorg[ax] += cukid.cusize;
641 br |= sgn;
642 }
643 else
644 if (sgn & br) {
645 cukid.cuorg[ax] -= cukid.cusize;
646 br &= ~sgn;
647 } else
648 return(ax); /* underflow */
649 }
650 /*NOTREACHED*/
651 }
652 if (isfull(cu->cutree)) {
653 if (checkhit(r, cu, cxs))
654 return(RAYHIT);
655 } else if (r->ro == &Aftplane && incube(cu, r->rop))
656 return(RAYHIT);
657 /* advance to next cube */
658 if (dirf&0x11) {
659 dt = dirf&1 ? cu->cuorg[0] + cu->cusize : cu->cuorg[0];
660 t = (dt - pos[0])/r->rdir[0];
661 ax = 0;
662 } else
663 t = FHUGE;
664 if (dirf&0x22) {
665 dt = dirf&2 ? cu->cuorg[1] + cu->cusize : cu->cuorg[1];
666 dt = (dt - pos[1])/r->rdir[1];
667 if (dt < t) {
668 t = dt;
669 ax = 1;
670 }
671 }
672 if (dirf&0x44) {
673 dt = dirf&4 ? cu->cuorg[2] + cu->cusize : cu->cuorg[2];
674 dt = (dt - pos[2])/r->rdir[2];
675 if (dt < t) {
676 t = dt;
677 ax = 2;
678 }
679 }
680 VSUM(pos, pos, r->rdir, t);
681 return(ax);
682 }
683
684
685 static int
686 checkhit( /* check for hit in full cube */
687 RAY *r,
688 CUBE *cu,
689 OBJECT *cxs
690 )
691 {
692 OBJECT oset[MAXSET+1];
693
694 objset(oset, cu->cutree);
695 checkset(oset, cxs); /* avoid double-checking */
696
697 (*r->hitf)(oset, r); /* test for hit in set */
698
699 if (r->robj == OVOID)
700 return(0); /* no scores yet */
701
702 return(incube(cu, r->rop)); /* hit OK if in current cube */
703 }
704
705
706 static void
707 checkset( /* modify checked set and set to check */
708 OBJECT *os, /* os' = os - cs */
709 OBJECT *cs /* cs' = cs + os */
710 )
711 {
712 OBJECT cset[MAXCSET+MAXSET+1];
713 int i, j;
714 int k;
715 /* copy os in place, cset <- cs */
716 cset[0] = 0;
717 k = 0;
718 for (i = j = 1; i <= os[0]; i++) {
719 while (j <= cs[0] && cs[j] < os[i])
720 cset[++cset[0]] = cs[j++];
721 if (j > cs[0] || os[i] != cs[j]) { /* object to check */
722 os[++k] = os[i];
723 cset[++cset[0]] = os[i];
724 }
725 }
726 if (!(os[0] = k)) /* new "to check" set size */
727 return; /* special case */
728 while (j <= cs[0]) /* get the rest of cs */
729 cset[++cset[0]] = cs[j++];
730 if (cset[0] > MAXCSET) /* truncate "checked" set if nec. */
731 cset[0] = MAXCSET;
732 /* setcopy(cs, cset); */ /* copy cset back to cs */
733 os = cset;
734 for (i = os[0]; i-- >= 0; )
735 *cs++ = *os++;
736 }