ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/common/image.c
Revision: 2.44
Committed: Wed Jan 24 17:22:24 2018 UTC (6 years, 3 months ago) by greg
Content type: text/plain
Branch: MAIN
Changes since 2.43: +5 -8 lines
Log Message:
Final tweak returns out-of-frame if on frame edge

File Contents

# Content
1 #ifndef lint
2 static const char RCSid[] = "$Id: image.c,v 2.43 2018/01/24 04:39:52 greg Exp $";
3 #endif
4 /*
5 * image.c - routines for image generation.
6 *
7 * External symbols declared in view.h
8 */
9
10 #include "copyright.h"
11
12 #include <ctype.h>
13 #include "rtio.h"
14 #include "rtmath.h"
15 #include "paths.h"
16 #include "view.h"
17
18
19 #define FEQ(x,y) (fabs((x)-(y)) <= FTINY)
20 #define VEQ(v,w) (FEQ((v)[0],(w)[0]) && FEQ((v)[1],(w)[1]) \
21 && FEQ((v)[2],(w)[2]))
22
23 VIEW stdview = STDVIEW; /* default view parameters */
24
25 static gethfunc gethview;
26
27
28 char *
29 setview( /* set hvec and vvec, return message on error */
30 VIEW *v
31 )
32 {
33 static char ill_horiz[] = "illegal horizontal view size";
34 static char ill_vert[] = "illegal vertical view size";
35
36 if ((v->vfore < -FTINY) | (v->vaft < -FTINY) ||
37 (v->vaft > FTINY) & (v->vaft <= v->vfore))
38 return("illegal fore/aft clipping plane");
39
40 if (v->vdist <= FTINY)
41 return("illegal view distance");
42 v->vdist *= normalize(v->vdir); /* normalize direction */
43 if (v->vdist == 0.0)
44 return("zero view direction");
45
46 if (normalize(v->vup) == 0.0) /* normalize view up */
47 return("zero view up vector");
48
49 fcross(v->hvec, v->vdir, v->vup); /* compute horiz dir */
50
51 if (normalize(v->hvec) == 0.0)
52 return("view up parallel to view direction");
53
54 fcross(v->vvec, v->hvec, v->vdir); /* compute vert dir */
55
56 if (v->horiz <= FTINY)
57 return(ill_horiz);
58 if (v->vert <= FTINY)
59 return(ill_vert);
60
61 switch (v->type) {
62 case VT_PAR: /* parallel view */
63 v->hn2 = v->horiz;
64 v->vn2 = v->vert;
65 break;
66 case VT_PER: /* perspective view */
67 if (v->horiz >= 180.0-FTINY)
68 return(ill_horiz);
69 if (v->vert >= 180.0-FTINY)
70 return(ill_vert);
71 v->hn2 = 2.0 * tan(v->horiz*(PI/180.0/2.0));
72 v->vn2 = 2.0 * tan(v->vert*(PI/180.0/2.0));
73 break;
74 case VT_CYL: /* cylindrical panorama */
75 if (v->horiz > 360.0+FTINY)
76 return(ill_horiz);
77 if (v->vert >= 180.0-FTINY)
78 return(ill_vert);
79 v->hn2 = v->horiz * (PI/180.0);
80 v->vn2 = 2.0 * tan(v->vert*(PI/180.0/2.0));
81 break;
82 case VT_ANG: /* angular fisheye */
83 if (v->horiz > 360.0+FTINY)
84 return(ill_horiz);
85 if (v->vert > 360.0+FTINY)
86 return(ill_vert);
87 v->hn2 = v->horiz * (PI/180.0);
88 v->vn2 = v->vert * (PI/180.0);
89 break;
90 case VT_HEM: /* hemispherical fisheye */
91 if (v->horiz > 180.0+FTINY)
92 return(ill_horiz);
93 if (v->vert > 180.0+FTINY)
94 return(ill_vert);
95 v->hn2 = 2.0 * sin(v->horiz*(PI/180.0/2.0));
96 v->vn2 = 2.0 * sin(v->vert*(PI/180.0/2.0));
97 break;
98 case VT_PLS: /* planispheric fisheye */
99 if (v->horiz >= 360.0-FTINY)
100 return(ill_horiz);
101 if (v->vert >= 360.0-FTINY)
102 return(ill_vert);
103 v->hn2 = 2.*sin(v->horiz*(PI/180.0/2.0)) /
104 (1.0 + cos(v->horiz*(PI/180.0/2.0)));
105 v->vn2 = 2.*sin(v->vert*(PI/180.0/2.0)) /
106 (1.0 + cos(v->vert*(PI/180.0/2.0)));
107 break;
108 default:
109 return("unknown view type");
110 }
111 if (v->type != VT_ANG && v->type != VT_PLS) {
112 if (v->type != VT_CYL) {
113 v->hvec[0] *= v->hn2;
114 v->hvec[1] *= v->hn2;
115 v->hvec[2] *= v->hn2;
116 }
117 v->vvec[0] *= v->vn2;
118 v->vvec[1] *= v->vn2;
119 v->vvec[2] *= v->vn2;
120 }
121 v->hn2 *= v->hn2;
122 v->vn2 *= v->vn2;
123
124 return(NULL);
125 }
126
127
128 void
129 normaspect( /* fix pixel aspect or resolution */
130 double va, /* view aspect ratio */
131 double *ap, /* pixel aspect in (or out if 0) */
132 int *xp,
133 int *yp /* x and y resolution in (or out if *ap!=0) */
134 )
135 {
136 if (*ap <= FTINY)
137 *ap = va * *xp / *yp; /* compute pixel aspect */
138 else if (va * *xp > *ap * *yp)
139 *xp = *yp / va * *ap + .5; /* reduce x resolution */
140 else
141 *yp = *xp * va / *ap + .5; /* reduce y resolution */
142 }
143
144
145 double
146 viewray( /* compute ray origin and direction */
147 FVECT orig,
148 FVECT direc,
149 VIEW *v,
150 double x,
151 double y
152 )
153 {
154 double d, z;
155
156 x += v->hoff - 0.5;
157 y += v->voff - 0.5;
158
159 switch(v->type) {
160 case VT_PAR: /* parallel view */
161 orig[0] = v->vp[0] + v->vfore*v->vdir[0]
162 + x*v->hvec[0] + y*v->vvec[0];
163 orig[1] = v->vp[1] + v->vfore*v->vdir[1]
164 + x*v->hvec[1] + y*v->vvec[1];
165 orig[2] = v->vp[2] + v->vfore*v->vdir[2]
166 + x*v->hvec[2] + y*v->vvec[2];
167 VCOPY(direc, v->vdir);
168 return(v->vaft > FTINY ? v->vaft - v->vfore : 0.0);
169 case VT_PER: /* perspective view */
170 direc[0] = v->vdir[0] + x*v->hvec[0] + y*v->vvec[0];
171 direc[1] = v->vdir[1] + x*v->hvec[1] + y*v->vvec[1];
172 direc[2] = v->vdir[2] + x*v->hvec[2] + y*v->vvec[2];
173 VSUM(orig, v->vp, direc, v->vfore);
174 d = normalize(direc);
175 return(v->vaft > FTINY ? (v->vaft - v->vfore)*d : 0.0);
176 case VT_HEM: /* hemispherical fisheye */
177 z = 1.0 - x*x*v->hn2 - y*y*v->vn2;
178 if (z < 0.0)
179 return(-1.0);
180 z = sqrt(z);
181 direc[0] = z*v->vdir[0] + x*v->hvec[0] + y*v->vvec[0];
182 direc[1] = z*v->vdir[1] + x*v->hvec[1] + y*v->vvec[1];
183 direc[2] = z*v->vdir[2] + x*v->hvec[2] + y*v->vvec[2];
184 VSUM(orig, v->vp, direc, v->vfore);
185 return(v->vaft > FTINY ? v->vaft - v->vfore : 0.0);
186 case VT_CYL: /* cylindrical panorama */
187 d = x * v->horiz * (PI/180.0);
188 z = cos(d);
189 x = sin(d);
190 direc[0] = z*v->vdir[0] + x*v->hvec[0] + y*v->vvec[0];
191 direc[1] = z*v->vdir[1] + x*v->hvec[1] + y*v->vvec[1];
192 direc[2] = z*v->vdir[2] + x*v->hvec[2] + y*v->vvec[2];
193 VSUM(orig, v->vp, direc, v->vfore);
194 d = normalize(direc);
195 return(v->vaft > FTINY ? (v->vaft - v->vfore)*d : 0.0);
196 case VT_ANG: /* angular fisheye */
197 x *= (1.0/180.0)*v->horiz;
198 y *= (1.0/180.0)*v->vert;
199 d = x*x + y*y;
200 if (d > 1.0)
201 return(-1.0);
202 d = sqrt(d);
203 z = cos(PI*d);
204 d = d <= FTINY ? PI : sqrt(1.0 - z*z)/d;
205 x *= d;
206 y *= d;
207 direc[0] = z*v->vdir[0] + x*v->hvec[0] + y*v->vvec[0];
208 direc[1] = z*v->vdir[1] + x*v->hvec[1] + y*v->vvec[1];
209 direc[2] = z*v->vdir[2] + x*v->hvec[2] + y*v->vvec[2];
210 VSUM(orig, v->vp, direc, v->vfore);
211 return(v->vaft > FTINY ? v->vaft - v->vfore : 0.0);
212 case VT_PLS: /* planispheric fisheye */
213 x *= sqrt(v->hn2);
214 y *= sqrt(v->vn2);
215 d = x*x + y*y;
216 z = (1. - d)/(1. + d);
217 x *= (1. + z);
218 y *= (1. + z);
219 direc[0] = z*v->vdir[0] + x*v->hvec[0] + y*v->vvec[0];
220 direc[1] = z*v->vdir[1] + x*v->hvec[1] + y*v->vvec[1];
221 direc[2] = z*v->vdir[2] + x*v->hvec[2] + y*v->vvec[2];
222 VSUM(orig, v->vp, direc, v->vfore);
223 return(v->vaft > FTINY ? v->vaft - v->vfore : 0.0);
224 }
225 return(-1.0);
226 }
227
228
229 int
230 viewloc( /* find image location for point */
231 FVECT ip,
232 VIEW *v,
233 FVECT p
234 ) /* returns: Good=1, Bad=0, Behind=-1, OutOfFrame=2, Behind+OOF=-2 */
235 {
236 double d, d2;
237 FVECT disp;
238
239 VSUB(disp, p, v->vp);
240
241 switch (v->type) {
242 case VT_PAR: /* parallel view */
243 ip[2] = DOT(disp,v->vdir) - v->vfore;
244 break;
245 case VT_PER: /* perspective view */
246 d = DOT(disp,v->vdir);
247 ip[2] = VLEN(disp);
248 if (d < -FTINY) { /* fold pyramid */
249 ip[2] = -ip[2];
250 d = -d;
251 } else if (d <= FTINY)
252 return(0); /* at infinite edge */
253 d = 1.0/d;
254 disp[0] *= d;
255 disp[1] *= d;
256 disp[2] *= d;
257 if (ip[2] < 0.0) d = -d;
258 ip[2] *= (1.0 - v->vfore*d);
259 break;
260 case VT_HEM: /* hemispherical fisheye */
261 d = normalize(disp);
262 if (DOT(disp,v->vdir) < 0.0)
263 ip[2] = -d;
264 else
265 ip[2] = d;
266 ip[2] -= v->vfore;
267 break;
268 case VT_CYL: /* cylindrical panorama */
269 d = DOT(disp,v->hvec);
270 d2 = DOT(disp,v->vdir);
271 ip[0] = 180.0/PI * atan2(d,d2) / v->horiz + 0.5 - v->hoff;
272 d = d*d + d2*d2;
273 if (d <= FTINY*FTINY)
274 return(0); /* at pole */
275 d = 1.0/sqrt(d);
276 ip[1] = DOT(disp,v->vvec)*d/v->vn2 + 0.5 - v->voff;
277 ip[2] = VLEN(disp);
278 ip[2] *= (1.0 - v->vfore*d);
279 goto gotall;
280 case VT_ANG: /* angular fisheye */
281 ip[0] = 0.5 - v->hoff;
282 ip[1] = 0.5 - v->voff;
283 ip[2] = normalize(disp) - v->vfore;
284 d = DOT(disp,v->vdir);
285 if (d >= 1.0-FTINY)
286 goto gotall;
287 if (d <= -(1.0-FTINY)) {
288 ip[0] += 180.0/v->horiz;
289 goto gotall;
290 }
291 d = (180.0/PI)*acos(d) / sqrt(1.0 - d*d);
292 ip[0] += DOT(disp,v->hvec)*d/v->horiz;
293 ip[1] += DOT(disp,v->vvec)*d/v->vert;
294 goto gotall;
295 case VT_PLS: /* planispheric fisheye */
296 ip[0] = 0.5 - v->hoff;
297 ip[1] = 0.5 - v->voff;
298 ip[2] = normalize(disp) - v->vfore;
299 d = DOT(disp,v->vdir);
300 if (d >= 1.0-FTINY)
301 goto gotall;
302 if (d <= -(1.0-FTINY))
303 return(0);
304 ip[0] += DOT(disp,v->hvec)/((1. + d)*sqrt(v->hn2));
305 ip[1] += DOT(disp,v->vvec)/((1. + d)*sqrt(v->vn2));
306 goto gotall;
307 }
308 ip[0] = DOT(disp,v->hvec)/v->hn2 + 0.5 - v->hoff;
309 ip[1] = DOT(disp,v->vvec)/v->vn2 + 0.5 - v->voff;
310 gotall: /* compute return value */
311 return( (1 - 2*(ip[2] <= 0.0)) * (1 +
312 ((0.0 >= ip[0]) | (ip[0] >= 1.0) | (0.0 >= ip[1]) | (ip[1] >= 1.0))) );
313 }
314
315
316 void
317 pix2loc( /* compute image location from pixel pos. */
318 RREAL loc[2],
319 RESOLU *rp,
320 int px,
321 int py
322 )
323 {
324 int x, y;
325
326 if (rp->rt & YMAJOR) {
327 x = px;
328 y = py;
329 } else {
330 x = py;
331 y = px;
332 }
333 if (rp->rt & XDECR)
334 x = rp->xr-1 - x;
335 if (rp->rt & YDECR)
336 y = rp->yr-1 - y;
337 loc[0] = (x+.5)/rp->xr;
338 loc[1] = (y+.5)/rp->yr;
339 }
340
341
342 void
343 loc2pix( /* compute pixel pos. from image location */
344 int pp[2],
345 RESOLU *rp,
346 double lx,
347 double ly
348 )
349 {
350 int x, y;
351
352 x = (int)(lx*rp->xr + .5 - (lx < 0.0));
353 y = (int)(ly*rp->yr + .5 - (ly < 0.0));
354
355 if (rp->rt & XDECR)
356 x = rp->xr-1 - x;
357 if (rp->rt & YDECR)
358 y = rp->yr-1 - y;
359 if (rp->rt & YMAJOR) {
360 pp[0] = x;
361 pp[1] = y;
362 } else {
363 pp[0] = y;
364 pp[1] = x;
365 }
366 }
367
368
369 int
370 getviewopt( /* process view argument */
371 VIEW *v,
372 int ac,
373 char *av[]
374 )
375 {
376 #define check(c,l) if ((av[0][c]&&av[0][c]!=' ') || \
377 badarg(ac-1,av+1,l)) return(-1)
378
379 if (ac <= 0 || av[0][0] != '-' || av[0][1] != 'v')
380 return(-1);
381 switch (av[0][2]) {
382 case 't': /* type */
383 if (!av[0][3] || av[0][3]==' ')
384 return(-1);
385 check(4,"");
386 v->type = av[0][3];
387 return(0);
388 case 'p': /* point */
389 check(3,"fff");
390 v->vp[0] = atof(av[1]);
391 v->vp[1] = atof(av[2]);
392 v->vp[2] = atof(av[3]);
393 return(3);
394 case 'd': /* direction */
395 check(3,"fff");
396 v->vdir[0] = atof(av[1]);
397 v->vdir[1] = atof(av[2]);
398 v->vdir[2] = atof(av[3]);
399 v->vdist = 1.;
400 return(3);
401 case 'u': /* up */
402 check(3,"fff");
403 v->vup[0] = atof(av[1]);
404 v->vup[1] = atof(av[2]);
405 v->vup[2] = atof(av[3]);
406 return(3);
407 case 'h': /* horizontal size */
408 check(3,"f");
409 v->horiz = atof(av[1]);
410 return(1);
411 case 'v': /* vertical size */
412 check(3,"f");
413 v->vert = atof(av[1]);
414 return(1);
415 case 'o': /* fore clipping plane */
416 check(3,"f");
417 v->vfore = atof(av[1]);
418 return(1);
419 case 'a': /* aft clipping plane */
420 check(3,"f");
421 v->vaft = atof(av[1]);
422 return(1);
423 case 's': /* shift */
424 check(3,"f");
425 v->hoff = atof(av[1]);
426 return(1);
427 case 'l': /* lift */
428 check(3,"f");
429 v->voff = atof(av[1]);
430 return(1);
431 default:
432 return(-1);
433 }
434 #undef check
435 }
436
437
438 int
439 sscanview( /* get view parameters from string */
440 VIEW *vp,
441 char *s
442 )
443 {
444 int ac;
445 char *av[4];
446 int na;
447 int nvopts = 0;
448
449 while (isspace(*s))
450 if (!*s++)
451 return(0);
452 while (*s) {
453 ac = 0;
454 do {
455 if (ac || *s == '-')
456 av[ac++] = s;
457 while (*s && !isspace(*s))
458 s++;
459 while (isspace(*s))
460 s++;
461 } while (*s && ac < 4);
462 if ((na = getviewopt(vp, ac, av)) >= 0) {
463 if (na+1 < ac)
464 s = av[na+1];
465 nvopts++;
466 } else if (ac > 1)
467 s = av[1];
468 }
469 return(nvopts);
470 }
471
472
473 void
474 fprintview( /* write out view parameters */
475 VIEW *vp,
476 FILE *fp
477 )
478 {
479 fprintf(fp, " -vt%c", vp->type);
480 fprintf(fp, " -vp %.6g %.6g %.6g", vp->vp[0], vp->vp[1], vp->vp[2]);
481 fprintf(fp, " -vd %.6g %.6g %.6g", vp->vdir[0]*vp->vdist,
482 vp->vdir[1]*vp->vdist,
483 vp->vdir[2]*vp->vdist);
484 fprintf(fp, " -vu %.6g %.6g %.6g", vp->vup[0], vp->vup[1], vp->vup[2]);
485 fprintf(fp, " -vh %.6g -vv %.6g", vp->horiz, vp->vert);
486 fprintf(fp, " -vo %.6g -va %.6g", vp->vfore, vp->vaft);
487 fprintf(fp, " -vs %.6g -vl %.6g", vp->hoff, vp->voff);
488 }
489
490
491 char *
492 viewopt( /* translate to minimal view string */
493 VIEW *vp
494 )
495 {
496 static char vwstr[128];
497 char *cp = vwstr;
498
499 *cp = '\0';
500 if (vp->type != stdview.type) {
501 sprintf(cp, " -vt%c", vp->type);
502 cp += strlen(cp);
503 }
504 if (!VEQ(vp->vp,stdview.vp)) {
505 sprintf(cp, " -vp %.6g %.6g %.6g",
506 vp->vp[0], vp->vp[1], vp->vp[2]);
507 cp += strlen(cp);
508 }
509 if (!FEQ(vp->vdist,stdview.vdist) || !VEQ(vp->vdir,stdview.vdir)) {
510 sprintf(cp, " -vd %.6g %.6g %.6g",
511 vp->vdir[0]*vp->vdist,
512 vp->vdir[1]*vp->vdist,
513 vp->vdir[2]*vp->vdist);
514 cp += strlen(cp);
515 }
516 if (!VEQ(vp->vup,stdview.vup)) {
517 sprintf(cp, " -vu %.6g %.6g %.6g",
518 vp->vup[0], vp->vup[1], vp->vup[2]);
519 cp += strlen(cp);
520 }
521 if (!FEQ(vp->horiz,stdview.horiz)) {
522 sprintf(cp, " -vh %.6g", vp->horiz);
523 cp += strlen(cp);
524 }
525 if (!FEQ(vp->vert,stdview.vert)) {
526 sprintf(cp, " -vv %.6g", vp->vert);
527 cp += strlen(cp);
528 }
529 if (!FEQ(vp->vfore,stdview.vfore)) {
530 sprintf(cp, " -vo %.6g", vp->vfore);
531 cp += strlen(cp);
532 }
533 if (!FEQ(vp->vaft,stdview.vaft)) {
534 sprintf(cp, " -va %.6g", vp->vaft);
535 cp += strlen(cp);
536 }
537 if (!FEQ(vp->hoff,stdview.hoff)) {
538 sprintf(cp, " -vs %.6g", vp->hoff);
539 cp += strlen(cp);
540 }
541 if (!FEQ(vp->voff,stdview.voff)) {
542 sprintf(cp, " -vl %.6g", vp->voff);
543 cp += strlen(cp);
544 }
545 return(vwstr);
546 }
547
548
549 int
550 isview( /* is this a view string? */
551 char *s
552 )
553 {
554 static char *altname[]={NULL,VIEWSTR,"rpict","rview","rvu","rpiece","pinterp",NULL};
555 extern char *progname;
556 char *cp;
557 char **an;
558 /* add program name to list */
559 if (altname[0] == NULL) {
560 for (cp = progname; *cp; cp++)
561 ;
562 while (cp > progname && !ISDIRSEP(cp[-1]))
563 cp--;
564 altname[0] = cp;
565 }
566 /* skip leading path */
567 cp = s;
568 while (*cp && *cp != ' ')
569 cp++;
570 while (cp > s && !ISDIRSEP(cp[-1]))
571 cp--;
572 for (an = altname; *an != NULL; an++)
573 if (!strncmp(*an, cp, strlen(*an)))
574 return(1);
575 return(0);
576 }
577
578
579 struct myview {
580 VIEW *hv;
581 int ok;
582 };
583
584
585 static int
586 gethview( /* get view from header */
587 char *s,
588 void *v
589 )
590 {
591 if (isview(s) && sscanview(((struct myview*)v)->hv, s) > 0)
592 ((struct myview*)v)->ok++;
593 return(0);
594 }
595
596
597 int
598 viewfile( /* get view from file */
599 char *fname,
600 VIEW *vp,
601 RESOLU *rp
602 )
603 {
604 struct myview mvs;
605 FILE *fp;
606
607 if (fname == NULL || !strcmp(fname, "-"))
608 fp = stdin;
609 else if ((fp = fopen(fname, "r")) == NULL)
610 return(-1);
611
612 mvs.hv = vp;
613 mvs.ok = 0;
614
615 getheader(fp, gethview, &mvs);
616
617 if (rp != NULL && !fgetsresolu(rp, fp))
618 mvs.ok = 0;
619
620 fclose(fp);
621
622 return(mvs.ok);
623 }