ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/rt/rtmain.c
Revision: 2.48
Committed: Fri Nov 17 20:02:07 2023 UTC (17 months, 2 weeks ago) by greg
Content type: text/plain
Branch: MAIN
Changes since 2.47: +10 -27 lines
Log Message:
fix: multiple bug fixes in hyperspectral code, added rvu, mkillum, rsensor, and ranimove to "working except photon map" status

File Contents

# Content
1 #ifndef lint
2 static const char RCSid[] = "$Id: rtmain.c,v 2.47 2023/11/15 18:02:53 greg Exp $";
3 #endif
4 /*
5 * rtmain.c - main for rtrace per-ray calculation program
6 */
7
8 #include "copyright.h"
9
10 #include <signal.h>
11
12 #include "platform.h"
13 #include "rtprocess.h" /* getpid() */
14 #include "resolu.h"
15 #include "ray.h"
16 #include "source.h"
17 #include "ambient.h"
18 #include "random.h"
19 #include "paths.h"
20 #include "pmapray.h"
21
22 extern char *progname; /* global argv[0] */
23
24 extern char *shm_boundary; /* boundary of shared memory */
25
26 /* persistent processes define */
27 #ifdef F_SETLKW
28 #define PERSIST 1 /* normal persist */
29 #define PARALLEL 2 /* parallel persist */
30 #define PCHILD 3 /* child of normal persist */
31 #endif
32
33 char *sigerr[NSIG]; /* signal error messages */
34 char *errfile = NULL; /* error output file */
35
36 int nproc = 1; /* number of processes */
37
38 extern int setrtoutput(void); /* set output values */
39
40 int inform = 'a'; /* input format */
41 int outform = 'a'; /* output format */
42 char *outvals = "v"; /* output specification */
43
44 int hresolu = 0; /* horizontal (scan) size */
45 int vresolu = 0; /* vertical resolution */
46
47 extern int castonly; /* only doing ray-casting? */
48
49 int imm_irrad = 0; /* compute immediate irradiance? */
50 int lim_dist = 0; /* limit distance? */
51
52 #ifndef MAXMODLIST
53 #define MAXMODLIST 1024 /* maximum modifiers we'll track */
54 #endif
55
56 extern void (*addobjnotify[])(); /* object notification calls */
57 extern void tranotify(OBJECT obj);
58
59 char *tralist[MAXMODLIST]; /* list of modifers to trace (or no) */
60 int traincl = -1; /* include == 1, exclude == 0 */
61
62 double (*sens_curve)(SCOLOR scol) = NULL; /* spectral conversion for 1-channel */
63 double out_scalefactor = 1; /* output calibration scale factor */
64 RGBPRIMP out_prims = stdprims; /* output color primitives (NULL if spectral) */
65 static RGBPRIMS our_prims; /* private output color primitives */
66
67 static int loadflags = ~IO_FILES; /* what to load from octree */
68
69 static void onsig(int signo);
70 static void sigdie(int signo, char *msg);
71 static void printdefaults(void);
72
73 #ifdef PERSIST
74 #define RTRACE_FEATURES "Persist\nParallelPersist\nMultiprocessing\n" \
75 "IrradianceCalc\nImmediateIrradiance\nDistanceLimiting\n" \
76 "ParticipatingMedia=Mist\n" \
77 "HessianAmbientCache\nAmbientAveraging\n" \
78 "AmbientValueSharing\nAdaptiveShadowTesting\n" \
79 "InputFormats=a,f,d\nOutputFormats=a,f,d,c\n" \
80 "Outputs=o,d,v,V,w,W,l,L,c,p,n,N,s,m,M,r,x,R,X,~\n"
81 #else
82 #define RTRACE_FEATURES "IrradianceCalc\nIrradianceCalc\nDistanceLimiting\n" \
83 "ParticipatingMedia=Mist\n" \
84 "HessianAmbientCache\nAmbientAveraging\n" \
85 "AmbientValueSharing\nAdaptiveShadowTesting\n" \
86 "InputFormats=a,f,d\nOutputFormats=a,f,d,c\n" \
87 "Outputs=o,d,v,V,w,W,l,L,c,p,n,N,s,m,M,r,x,R,X,~\n"
88 #endif
89
90
91 int
92 main(int argc, char *argv[])
93 {
94 #define check(ol,al) if (argv[i][ol] || \
95 badarg(argc-i-1,argv+i+1,al)) \
96 goto badopt
97 #define check_bool(olen,var) switch (argv[i][olen]) { \
98 case '\0': var = !var; break; \
99 case 'y': case 'Y': case 't': case 'T': \
100 case '+': case '1': var = 1; break; \
101 case 'n': case 'N': case 'f': case 'F': \
102 case '-': case '0': var = 0; break; \
103 default: goto badopt; }
104 extern char *octname;
105 int persist = 0;
106 char *octnm = NULL;
107 char **tralp = NULL;
108 int duped1 = -1;
109 int rval;
110 int i;
111 /* global program name */
112 progname = argv[0] = fixargv0(argv[0]);
113 /* feature check only? */
114 strcat(RFeatureList, RTRACE_FEATURES);
115 if (argc > 1 && !strcmp(argv[1], "-features"))
116 return feature_status(argc-2, argv+2);
117 /* add trace notify function */
118 for (i = 0; addobjnotify[i] != NULL; i++)
119 ;
120 addobjnotify[i] = tranotify;
121 /* option city */
122 for (i = 1; i < argc; i++) {
123 /* expand arguments */
124 while ((rval = expandarg(&argc, &argv, i)) > 0)
125 ;
126 if (rval < 0) {
127 sprintf(errmsg, "cannot expand '%s'", argv[i]);
128 error(SYSTEM, errmsg);
129 }
130 if (argv[i] == NULL || argv[i][0] != '-')
131 break; /* break from options */
132 if (!strcmp(argv[i], "-version")) {
133 puts(VersionID);
134 quit(0);
135 }
136 if (!strcmp(argv[i], "-defaults") ||
137 !strcmp(argv[i], "-help")) {
138 printdefaults();
139 quit(0);
140 }
141 rval = getrenderopt(argc-i, argv+i);
142 if (rval >= 0) {
143 i += rval;
144 continue;
145 }
146 switch (argv[i][1]) {
147 case 'n': /* number of cores */
148 check(2,"i");
149 nproc = atoi(argv[++i]);
150 if (nproc <= 0)
151 error(USER, "bad number of processes");
152 break;
153 case 'x': /* x resolution */
154 check(2,"i");
155 hresolu = atoi(argv[++i]);
156 break;
157 case 'y': /* y resolution */
158 check(2,"i");
159 vresolu = atoi(argv[++i]);
160 break;
161 case 'w': /* warnings & spectral */
162 rval = erract[WARNING].pf != NULL;
163 check_bool(2,rval);
164 if (rval) erract[WARNING].pf = wputs;
165 else erract[WARNING].pf = NULL;
166 break;
167 case 'e': /* error file */
168 check(2,"s");
169 errfile = argv[++i];
170 break;
171 case 'l': /* limit distance */
172 if (argv[i][2] != 'd')
173 goto badopt;
174 check_bool(3,lim_dist);
175 break;
176 case 'I': /* immed. irradiance */
177 check_bool(2,imm_irrad);
178 break;
179 case 'f': /* format i/o */
180 switch (argv[i][2]) {
181 case 'a': /* ascii */
182 case 'f': /* float */
183 case 'd': /* double */
184 inform = argv[i][2];
185 break;
186 default:
187 goto badopt;
188 }
189 switch (argv[i][3]) {
190 case '\0':
191 outform = inform;
192 break;
193 case 'a': /* ascii */
194 case 'f': /* float */
195 case 'd': /* double */
196 case 'c': /* color */
197 check(4,"");
198 outform = argv[i][3];
199 break;
200 default:
201 goto badopt;
202 }
203 break;
204 case 'o': /* output */
205 outvals = argv[i]+2;
206 break;
207 case 'h': /* header output */
208 rval = loadflags & IO_INFO;
209 check_bool(2,rval);
210 loadflags = rval ? loadflags | IO_INFO :
211 loadflags & ~IO_INFO;
212 break;
213 case 't': /* trace */
214 switch (argv[i][2]) {
215 case 'i': /* include */
216 case 'I':
217 check(3,"s");
218 if (traincl != 1) {
219 traincl = 1;
220 tralp = tralist;
221 }
222 if (argv[i][2] == 'I') { /* file */
223 rval = wordfile(tralp, MAXMODLIST-(tralp-tralist),
224 getpath(argv[++i],getrlibpath(),R_OK));
225 if (rval < 0) {
226 sprintf(errmsg,
227 "cannot open trace include file \"%s\"",
228 argv[i]);
229 error(SYSTEM, errmsg);
230 }
231 tralp += rval;
232 } else {
233 *tralp++ = argv[++i];
234 *tralp = NULL;
235 }
236 break;
237 case 'e': /* exclude */
238 case 'E':
239 check(3,"s");
240 if (traincl != 0) {
241 traincl = 0;
242 tralp = tralist;
243 }
244 if (argv[i][2] == 'E') { /* file */
245 rval = wordfile(tralp, MAXMODLIST-(tralp-tralist),
246 getpath(argv[++i],getrlibpath(),R_OK));
247 if (rval < 0) {
248 sprintf(errmsg,
249 "cannot open trace exclude file \"%s\"",
250 argv[i]);
251 error(SYSTEM, errmsg);
252 }
253 tralp += rval;
254 } else {
255 *tralp++ = argv[++i];
256 *tralp = NULL;
257 }
258 break;
259 default:
260 goto badopt;
261 }
262 break;
263 case 'p': /* value output */
264 switch (argv[i][2]) {
265 case 'R': /* standard RGB output */
266 if (strcmp(argv[i]+2, "RGB"))
267 goto badopt;
268 out_prims = stdprims;
269 out_scalefactor = 1;
270 sens_curve = NULL;
271 break;
272 case 'X': /* XYZ output */
273 if (strcmp(argv[i]+2, "XYZ"))
274 goto badopt;
275 out_prims = xyzprims;
276 out_scalefactor = WHTEFFICACY;
277 sens_curve = NULL;
278 break;
279 case 'c': {
280 int j;
281 check(3,"ffffffff");
282 rval = 0;
283 for (j = 0; j < 8; j++) {
284 our_prims[0][j] = atof(argv[++i]);
285 rval |= fabs(our_prims[0][j]-stdprims[0][j]) > .001;
286 }
287 if (rval) {
288 if (!colorprimsOK(our_prims))
289 error(USER, "illegal primary chromaticities");
290 out_prims = our_prims;
291 } else
292 out_prims = stdprims;
293 out_scalefactor = 1;
294 sens_curve = NULL;
295 } break;
296 case 'Y': /* photopic response */
297 sens_curve = scolor_photopic;
298 out_scalefactor = WHTEFFICACY;
299 break;
300 case 'S': /* scotopic response */
301 sens_curve = scolor_scotopic;
302 out_scalefactor = WHTSCOTOPIC;
303 break;
304 case 'M': /* melanopic response */
305 sens_curve = scolor_melanopic;
306 out_scalefactor = WHTMELANOPIC;
307 break;
308 default:
309 goto badopt;
310 }
311 break;
312 #if MAXCSAMP>3
313 case 'c': /* output spectral results */
314 if (argv[i][2] != 'o')
315 goto badopt;
316 rval = (out_prims == NULL);
317 check_bool(3,rval);
318 if (rval) out_prims = NULL;
319 else if (out_prims == NULL) out_prims = stdprims;
320 break;
321 #endif
322 #ifdef PERSIST
323 case 'P': /* persist file */
324 if (argv[i][2] == 'P') {
325 check(3,"s");
326 persist = PARALLEL;
327 } else {
328 check(2,"s");
329 persist = PERSIST;
330 }
331 persistfile(argv[++i]);
332 break;
333 #endif
334 default:
335 goto badopt;
336 }
337 }
338 /* set/check spectral sampling */
339 rval = setspectrsamp(CNDX, WLPART);
340 if (rval < 0)
341 error(USER, "unsupported spectral sampling");
342 if (out_prims != NULL) {
343 if (!rval)
344 error(WARNING, "spectral range incompatible with color output");
345 } else if (NCSAMP == 3)
346 out_prims = stdprims; /* 3 samples do not a spectrum make */
347 if (nproc > 1 && persist)
348 error(USER, "multiprocessing incompatible with persist file");
349 /* initialize object types */
350 initotypes();
351 /* initialize urand */
352 if (rand_samp) {
353 srandom((long)time(0));
354 initurand(0);
355 } else {
356 srandom(0L);
357 initurand(2048);
358 }
359 /* set up signal handling */
360 sigdie(SIGINT, "Interrupt");
361 #ifdef SIGHUP
362 sigdie(SIGHUP, "Hangup");
363 #endif
364 sigdie(SIGTERM, "Terminate");
365 #ifdef SIGPIPE
366 sigdie(SIGPIPE, "Broken pipe");
367 #endif
368 #ifdef SIGALRM
369 sigdie(SIGALRM, "Alarm clock");
370 #endif
371 #ifdef SIGXCPU
372 sigdie(SIGXCPU, "CPU limit exceeded");
373 sigdie(SIGXFSZ, "File size exceeded");
374 #endif
375 /* open error file */
376 if (errfile != NULL) {
377 if (freopen(errfile, "a", stderr) == NULL)
378 quit(2);
379 fprintf(stderr, "**************\n*** PID %5d: ",
380 getpid());
381 printargs(argc, argv, stderr);
382 putc('\n', stderr);
383 fflush(stderr);
384 }
385 #ifdef NICE
386 nice(NICE); /* lower priority */
387 #endif
388 /* get octree */
389 if (i == argc)
390 octnm = NULL;
391 else if (i == argc-1)
392 octnm = argv[i];
393 else
394 goto badopt;
395 if (octnm == NULL)
396 error(USER, "missing octree argument");
397 /* set up output */
398 #ifdef PERSIST
399 if (persist) {
400 duped1 = dup(fileno(stdout)); /* don't lose our output */
401 openheader();
402 }
403 #endif
404 if (outform != 'a')
405 SET_FILE_BINARY(stdout);
406 rval = setrtoutput();
407 octname = savqstr(octnm);
408 readoct(octname, loadflags, &thescene, NULL);
409 nsceneobjs = nobjects;
410
411 if (loadflags & IO_INFO) { /* print header */
412 printargs(i, argv, stdout);
413 printf("SOFTWARE= %s\n", VersionID);
414 fputnow(stdout);
415 if (rval > 0) /* saved from setrtoutput() call */
416 fputncomp(rval, stdout);
417 if (NCSAMP > 3)
418 fputwlsplit(WLPART, stdout);
419 if ((out_prims != stdprims) & (out_prims != NULL))
420 fputprims(out_prims, stdout);
421 if ((outform == 'f') | (outform == 'd'))
422 fputendian(stdout);
423 fputformat(formstr(outform), stdout);
424 fputc('\n', stdout); /* end of header */
425 }
426
427 if (!castonly) { /* any actual ray traversal to do? */
428
429 ray_init_pmap(); /* PMAP: set up & load photon maps */
430
431 marksources(); /* find and mark sources */
432
433 setambient(); /* initialize ambient calculation */
434 } else
435 distantsources(); /* else mark only distant sources */
436
437 fflush(stdout); /* in case we're duplicating header */
438
439 #ifdef PERSIST
440 if (persist) {
441 /* reconnect stdout */
442 dup2(duped1, fileno(stdout));
443 close(duped1);
444 if (persist == PARALLEL) { /* multiprocessing */
445 preload_objs(); /* preload scene */
446 shm_boundary = (char *)malloc(16);
447 strcpy(shm_boundary, "SHM_BOUNDARY");
448 while ((rval=fork()) == 0) { /* keep on forkin' */
449 pflock(1);
450 pfhold();
451 ambsync(); /* load new values */
452 }
453 if (rval < 0)
454 error(SYSTEM, "cannot fork child for persist function");
455 pfdetach(); /* parent will run then exit */
456 }
457 }
458 runagain:
459 if (persist)
460 dupheader(); /* send header to stdout */
461 #endif
462 /* trace rays */
463 rtrace(NULL, nproc);
464 /* flush ambient file */
465 ambsync();
466 #ifdef PERSIST
467 if (persist == PERSIST) { /* first run-through */
468 if ((rval=fork()) == 0) { /* child loops until killed */
469 pflock(1);
470 persist = PCHILD;
471 } else { /* original process exits */
472 if (rval < 0)
473 error(SYSTEM, "cannot fork child for persist function");
474 pfdetach(); /* parent exits */
475 }
476 }
477 if (persist == PCHILD) { /* wait for a signal then go again */
478 pfhold();
479 raynum = nrays = 0; /* reinitialize */
480 goto runagain;
481 }
482 #endif
483
484 ray_done_pmap(); /* PMAP: free photon maps */
485
486 quit(0);
487
488 badopt:
489 sprintf(errmsg, "command line error at '%s'", argv[i]);
490 error(USER, errmsg);
491 return 1; /* pro forma return */
492
493 #undef check
494 #undef check_bool
495 }
496
497
498 void
499 wputs( /* warning output function */
500 const char *s
501 )
502 {
503 int lasterrno = errno;
504 eputs(s);
505 errno = lasterrno;
506 }
507
508
509 void
510 eputs( /* put string to stderr */
511 const char *s
512 )
513 {
514 static int midline = 0;
515
516 if (!*s)
517 return;
518 if (!midline++) {
519 fputs(progname, stderr);
520 fputs(": ", stderr);
521 }
522 fputs(s, stderr);
523 if (s[strlen(s)-1] == '\n') {
524 fflush(stderr);
525 midline = 0;
526 }
527 }
528
529
530 static void
531 onsig( /* fatal signal */
532 int signo
533 )
534 {
535 static int gotsig = 0;
536
537 if (gotsig++) /* two signals and we're gone! */
538 _exit(signo);
539
540 #ifdef SIGALRM
541 alarm(15); /* allow 15 seconds to clean up */
542 signal(SIGALRM, SIG_DFL); /* make certain we do die */
543 #endif
544 eputs("signal - ");
545 eputs(sigerr[signo]);
546 eputs("\n");
547 quit(3);
548 }
549
550
551 static void
552 sigdie( /* set fatal signal */
553 int signo,
554 char *msg
555 )
556 {
557 if (signal(signo, onsig) == SIG_IGN)
558 signal(signo, SIG_IGN);
559 sigerr[signo] = msg;
560 }
561
562
563 static void
564 printdefaults(void) /* print default values to stdout */
565 {
566 char *cp;
567
568 if (imm_irrad)
569 printf("-I+\t\t\t\t# immediate irradiance on\n");
570 printf("-n %-2d\t\t\t\t# number of rendering processes\n", nproc);
571 printf("-x %-9d\t\t\t# %s\n", hresolu,
572 vresolu && hresolu ? "x resolution" : "flush interval");
573 printf("-y %-9d\t\t\t# y resolution\n", vresolu);
574 printf(lim_dist ? "-ld+\t\t\t\t# limit distance on\n" :
575 "-ld-\t\t\t\t# limit distance off\n");
576 printf(loadflags & IO_INFO ? "-h+\t\t\t\t# output header\n" :
577 "-h-\t\t\t\t# no header\n");
578 printf("-f%c%c\t\t\t\t# format input/output = %s/%s\n",
579 inform, outform, formstr(inform), formstr(outform));
580 printf("-o%-9s\t\t\t# output", outvals);
581 for (cp = outvals; *cp; cp++)
582 switch (*cp) {
583 case 't': case 'T': printf(" trace"); break;
584 case 'o': printf(" origin"); break;
585 case 'd': printf(" direction"); break;
586 case 'r': printf(" reflect_contrib"); break;
587 case 'R': printf(" reflect_length"); break;
588 case 'x': printf(" unreflect_contrib"); break;
589 case 'X': printf(" unreflect_length"); break;
590 case 'v': printf(" value"); break;
591 case 'V': printf(" contribution"); break;
592 case 'l': printf(" length"); break;
593 case 'L': printf(" first_length"); break;
594 case 'p': printf(" point"); break;
595 case 'n': printf(" normal"); break;
596 case 'N': printf(" unperturbed_normal"); break;
597 case 's': printf(" surface"); break;
598 case 'w': printf(" weight"); break;
599 case 'W': printf(" coefficient"); break;
600 case 'm': printf(" modifier"); break;
601 case 'M': printf(" material"); break;
602 case '~': printf(" tilde"); break;
603 }
604 fputc('\n', stdout);
605 if (NCSAMP > 3)
606 printf(out_prims != NULL ? "-co-\t\t\t\t# output tristimulus colors\n" :
607 "-co+\t\t\t\t# output spectral values\n");
608 if (sens_curve == scolor_photopic)
609 printf("-pY\t\t\t\t# photopic output\n");
610 else if (sens_curve == scolor_scotopic)
611 printf("-pS\t\t\t\t# scotopic output\n");
612 else if (sens_curve == scolor_melanopic)
613 printf("-pM\t\t\t\t# melanopic output\n");
614 else if (out_prims == stdprims)
615 printf("-pRGB\t\t\t\t# standard RGB color output\n");
616 else if (out_prims == xyzprims)
617 printf("-pXYZ\t\t\t\t# CIE XYZ color output\n");
618 else if (out_prims != NULL)
619 printf("-pc %.4f %.4f %.4f %.4f %.4f %.4f %.4f %.4f\t# output color primaries and white point\n",
620 out_prims[RED][0], out_prims[RED][1],
621 out_prims[GRN][0], out_prims[GRN][1],
622 out_prims[BLU][0], out_prims[BLU][1],
623 out_prims[WHT][0], out_prims[WHT][1]);
624 printf(erract[WARNING].pf != NULL ?
625 "-w+\t\t\t\t# warning messages on\n" :
626 "-w-\t\t\t\t# warning messages off\n");
627 print_rdefaults();
628 }