ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/rt/raytrace.c
Revision: 2.81
Committed: Sun Mar 29 18:21:57 2020 UTC (4 years, 1 month ago) by greg
Content type: text/plain
Branch: MAIN
CVS Tags: rad5R3
Changes since 2.80: +2 -1 lines
Log Message:
Added prophylaptic value for ray intersection point so no one gets random bits

File Contents

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