ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/common/image.c
Revision: 2.47
Committed: Fri Apr 27 17:36:01 2018 UTC (6 years ago) by greg
Content type: text/plain
Branch: MAIN
Changes since 2.46: +7 -6 lines
Log Message:
Slight tweak on last change, should not affect outcome

File Contents

# Content
1 #ifndef lint
2 static const char RCSid[] = "$Id: image.c,v 2.46 2018/04/27 05:00:29 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 ) /* Use VL_* flags to interpret return value */
235 {
236 int rflags = VL_GOOD;
237 double d, d2;
238 FVECT disp;
239
240 VSUB(disp, p, v->vp);
241
242 switch (v->type) {
243 case VT_PAR: /* parallel view */
244 ip[2] = DOT(disp,v->vdir) - v->vfore;
245 break;
246 case VT_PER: /* perspective view */
247 d = DOT(disp,v->vdir);
248 if ((v->vaft > FTINY) & (d >= v->vaft))
249 rflags |= VL_BEYOND;
250 ip[2] = VLEN(disp);
251 if (d < -FTINY) { /* fold pyramid */
252 ip[2] = -ip[2];
253 d = -d;
254 } else if (d <= FTINY)
255 return(VL_BAD); /* at infinite edge */
256 d = 1.0/d;
257 disp[0] *= d;
258 disp[1] *= d;
259 disp[2] *= d;
260 if (ip[2] < 0.0) d = -d;
261 ip[2] *= (1.0 - v->vfore*d);
262 break;
263 case VT_HEM: /* hemispherical fisheye */
264 d = normalize(disp);
265 if (DOT(disp,v->vdir) < 0.0)
266 ip[2] = -d;
267 else
268 ip[2] = d;
269 ip[2] -= v->vfore;
270 break;
271 case VT_CYL: /* cylindrical panorama */
272 d = DOT(disp,v->hvec);
273 d2 = DOT(disp,v->vdir);
274 ip[0] = 180.0/PI * atan2(d,d2) / v->horiz + 0.5 - v->hoff;
275 d = d*d + d2*d2;
276 if (d <= FTINY*FTINY)
277 return(VL_BAD); /* at pole */
278 if ((v->vaft > FTINY) & (d >= v->vaft*v->vaft))
279 rflags |= VL_BEYOND;
280 d = 1.0/sqrt(d);
281 ip[1] = DOT(disp,v->vvec)*d/v->vn2 + 0.5 - v->voff;
282 ip[2] = VLEN(disp);
283 ip[2] *= (1.0 - v->vfore*d);
284 goto gotall;
285 case VT_ANG: /* angular fisheye */
286 ip[0] = 0.5 - v->hoff;
287 ip[1] = 0.5 - v->voff;
288 ip[2] = normalize(disp) - v->vfore;
289 d = DOT(disp,v->vdir);
290 if (d >= 1.0-FTINY)
291 goto gotall;
292 if (d <= -(1.0-FTINY)) {
293 ip[0] += 180.0/v->horiz;
294 goto gotall;
295 }
296 d = (180.0/PI)*acos(d) / sqrt(1.0 - d*d);
297 ip[0] += DOT(disp,v->hvec)*d/v->horiz;
298 ip[1] += DOT(disp,v->vvec)*d/v->vert;
299 goto gotall;
300 case VT_PLS: /* planispheric fisheye */
301 ip[0] = 0.5 - v->hoff;
302 ip[1] = 0.5 - v->voff;
303 ip[2] = normalize(disp) - v->vfore;
304 d = DOT(disp,v->vdir);
305 if (d >= 1.0-FTINY)
306 goto gotall;
307 if (d <= -(1.0-FTINY))
308 return(VL_BAD);
309 ip[0] += DOT(disp,v->hvec)/((1. + d)*sqrt(v->hn2));
310 ip[1] += DOT(disp,v->vvec)/((1. + d)*sqrt(v->vn2));
311 goto gotall;
312 default:
313 return(VL_BAD);
314 }
315 ip[0] = DOT(disp,v->hvec)/v->hn2 + 0.5 - v->hoff;
316 ip[1] = DOT(disp,v->vvec)/v->vn2 + 0.5 - v->voff;
317 gotall: /* add appropriate return flags */
318 if (!(rflags & (VL_BEHIND|VL_BEYOND)))
319 rflags |= (ip[2] <= 0.0) ? VL_BEHIND :
320 VL_BEYOND * ((v->vaft > FTINY) &
321 (ip[2] >= v->vaft - v->vfore));
322 rflags |= VL_OUTSIDE*((0.0 >= ip[0]) | (ip[0] >= 1.0) |
323 (0.0 >= ip[1]) | (ip[1] >= 1.0));
324 return(rflags);
325 }
326
327
328 void
329 pix2loc( /* compute image location from pixel pos. */
330 RREAL loc[2],
331 RESOLU *rp,
332 int px,
333 int py
334 )
335 {
336 int x, y;
337
338 if (rp->rt & YMAJOR) {
339 x = px;
340 y = py;
341 } else {
342 x = py;
343 y = px;
344 }
345 if (rp->rt & XDECR)
346 x = rp->xr-1 - x;
347 if (rp->rt & YDECR)
348 y = rp->yr-1 - y;
349 loc[0] = (x+.5)/rp->xr;
350 loc[1] = (y+.5)/rp->yr;
351 }
352
353
354 void
355 loc2pix( /* compute pixel pos. from image location */
356 int pp[2],
357 RESOLU *rp,
358 double lx,
359 double ly
360 )
361 {
362 int x, y;
363
364 x = (int)(lx*rp->xr + .5 - (lx < 0.0));
365 y = (int)(ly*rp->yr + .5 - (ly < 0.0));
366
367 if (rp->rt & XDECR)
368 x = rp->xr-1 - x;
369 if (rp->rt & YDECR)
370 y = rp->yr-1 - y;
371 if (rp->rt & YMAJOR) {
372 pp[0] = x;
373 pp[1] = y;
374 } else {
375 pp[0] = y;
376 pp[1] = x;
377 }
378 }
379
380
381 int
382 getviewopt( /* process view argument */
383 VIEW *v,
384 int ac,
385 char *av[]
386 )
387 {
388 #define check(c,l) if ((av[0][c]&&av[0][c]!=' ') || \
389 badarg(ac-1,av+1,l)) return(-1)
390
391 if (ac <= 0 || av[0][0] != '-' || av[0][1] != 'v')
392 return(-1);
393 switch (av[0][2]) {
394 case 't': /* type */
395 if (!av[0][3] || av[0][3]==' ')
396 return(-1);
397 check(4,"");
398 v->type = av[0][3];
399 return(0);
400 case 'p': /* point */
401 check(3,"fff");
402 v->vp[0] = atof(av[1]);
403 v->vp[1] = atof(av[2]);
404 v->vp[2] = atof(av[3]);
405 return(3);
406 case 'd': /* direction */
407 check(3,"fff");
408 v->vdir[0] = atof(av[1]);
409 v->vdir[1] = atof(av[2]);
410 v->vdir[2] = atof(av[3]);
411 v->vdist = 1.;
412 return(3);
413 case 'u': /* up */
414 check(3,"fff");
415 v->vup[0] = atof(av[1]);
416 v->vup[1] = atof(av[2]);
417 v->vup[2] = atof(av[3]);
418 return(3);
419 case 'h': /* horizontal size */
420 check(3,"f");
421 v->horiz = atof(av[1]);
422 return(1);
423 case 'v': /* vertical size */
424 check(3,"f");
425 v->vert = atof(av[1]);
426 return(1);
427 case 'o': /* fore clipping plane */
428 check(3,"f");
429 v->vfore = atof(av[1]);
430 return(1);
431 case 'a': /* aft clipping plane */
432 check(3,"f");
433 v->vaft = atof(av[1]);
434 return(1);
435 case 's': /* shift */
436 check(3,"f");
437 v->hoff = atof(av[1]);
438 return(1);
439 case 'l': /* lift */
440 check(3,"f");
441 v->voff = atof(av[1]);
442 return(1);
443 default:
444 return(-1);
445 }
446 #undef check
447 }
448
449
450 int
451 sscanview( /* get view parameters from string */
452 VIEW *vp,
453 char *s
454 )
455 {
456 int ac;
457 char *av[4];
458 int na;
459 int nvopts = 0;
460
461 while (isspace(*s))
462 if (!*s++)
463 return(0);
464 while (*s) {
465 ac = 0;
466 do {
467 if (ac || *s == '-')
468 av[ac++] = s;
469 while (*s && !isspace(*s))
470 s++;
471 while (isspace(*s))
472 s++;
473 } while (*s && ac < 4);
474 if ((na = getviewopt(vp, ac, av)) >= 0) {
475 if (na+1 < ac)
476 s = av[na+1];
477 nvopts++;
478 } else if (ac > 1)
479 s = av[1];
480 }
481 return(nvopts);
482 }
483
484
485 void
486 fprintview( /* write out view parameters */
487 VIEW *vp,
488 FILE *fp
489 )
490 {
491 fprintf(fp, " -vt%c", vp->type);
492 fprintf(fp, " -vp %.6g %.6g %.6g", vp->vp[0], vp->vp[1], vp->vp[2]);
493 fprintf(fp, " -vd %.6g %.6g %.6g", vp->vdir[0]*vp->vdist,
494 vp->vdir[1]*vp->vdist,
495 vp->vdir[2]*vp->vdist);
496 fprintf(fp, " -vu %.6g %.6g %.6g", vp->vup[0], vp->vup[1], vp->vup[2]);
497 fprintf(fp, " -vh %.6g -vv %.6g", vp->horiz, vp->vert);
498 fprintf(fp, " -vo %.6g -va %.6g", vp->vfore, vp->vaft);
499 fprintf(fp, " -vs %.6g -vl %.6g", vp->hoff, vp->voff);
500 }
501
502
503 char *
504 viewopt( /* translate to minimal view string */
505 VIEW *vp
506 )
507 {
508 static char vwstr[128];
509 char *cp = vwstr;
510
511 *cp = '\0';
512 if (vp->type != stdview.type) {
513 sprintf(cp, " -vt%c", vp->type);
514 cp += strlen(cp);
515 }
516 if (!VEQ(vp->vp,stdview.vp)) {
517 sprintf(cp, " -vp %.6g %.6g %.6g",
518 vp->vp[0], vp->vp[1], vp->vp[2]);
519 cp += strlen(cp);
520 }
521 if (!FEQ(vp->vdist,stdview.vdist) || !VEQ(vp->vdir,stdview.vdir)) {
522 sprintf(cp, " -vd %.6g %.6g %.6g",
523 vp->vdir[0]*vp->vdist,
524 vp->vdir[1]*vp->vdist,
525 vp->vdir[2]*vp->vdist);
526 cp += strlen(cp);
527 }
528 if (!VEQ(vp->vup,stdview.vup)) {
529 sprintf(cp, " -vu %.6g %.6g %.6g",
530 vp->vup[0], vp->vup[1], vp->vup[2]);
531 cp += strlen(cp);
532 }
533 if (!FEQ(vp->horiz,stdview.horiz)) {
534 sprintf(cp, " -vh %.6g", vp->horiz);
535 cp += strlen(cp);
536 }
537 if (!FEQ(vp->vert,stdview.vert)) {
538 sprintf(cp, " -vv %.6g", vp->vert);
539 cp += strlen(cp);
540 }
541 if (!FEQ(vp->vfore,stdview.vfore)) {
542 sprintf(cp, " -vo %.6g", vp->vfore);
543 cp += strlen(cp);
544 }
545 if (!FEQ(vp->vaft,stdview.vaft)) {
546 sprintf(cp, " -va %.6g", vp->vaft);
547 cp += strlen(cp);
548 }
549 if (!FEQ(vp->hoff,stdview.hoff)) {
550 sprintf(cp, " -vs %.6g", vp->hoff);
551 cp += strlen(cp);
552 }
553 if (!FEQ(vp->voff,stdview.voff)) {
554 sprintf(cp, " -vl %.6g", vp->voff);
555 cp += strlen(cp);
556 }
557 return(vwstr);
558 }
559
560
561 int
562 isview( /* is this a view string? */
563 char *s
564 )
565 {
566 static char *altname[]={NULL,VIEWSTR,"rpict","rview","rvu","rpiece","pinterp",NULL};
567 extern char *progname;
568 char *cp;
569 char **an;
570 /* add program name to list */
571 if (altname[0] == NULL) {
572 for (cp = progname; *cp; cp++)
573 ;
574 while (cp > progname && !ISDIRSEP(cp[-1]))
575 cp--;
576 altname[0] = cp;
577 }
578 /* skip leading path */
579 cp = s;
580 while (*cp && *cp != ' ')
581 cp++;
582 while (cp > s && !ISDIRSEP(cp[-1]))
583 cp--;
584 for (an = altname; *an != NULL; an++)
585 if (!strncmp(*an, cp, strlen(*an)))
586 return(1);
587 return(0);
588 }
589
590
591 struct myview {
592 VIEW *hv;
593 int ok;
594 };
595
596
597 static int
598 gethview( /* get view from header */
599 char *s,
600 void *v
601 )
602 {
603 if (isview(s) && sscanview(((struct myview*)v)->hv, s) > 0)
604 ((struct myview*)v)->ok++;
605 return(0);
606 }
607
608
609 int
610 viewfile( /* get view from file */
611 char *fname,
612 VIEW *vp,
613 RESOLU *rp
614 )
615 {
616 struct myview mvs;
617 FILE *fp;
618
619 if (fname == NULL || !strcmp(fname, "-"))
620 fp = stdin;
621 else if ((fp = fopen(fname, "r")) == NULL)
622 return(-1);
623
624 mvs.hv = vp;
625 mvs.ok = 0;
626
627 getheader(fp, gethview, &mvs);
628
629 if (rp != NULL && !fgetsresolu(rp, fp))
630 mvs.ok = 0;
631
632 fclose(fp);
633
634 return(mvs.ok);
635 }