src/common/view.h

/* RCSid: $Id$ */
/*
 *  view.h - header file for image generation.
 *
 *  Include after fvect.h
 *  Includes resolu.h
 */

/* ====================================================================
 * The Radiance Software License, Version 1.0
 *
 * Copyright (c) 1990 - 2002 The Regents of the University of California,
 * through Lawrence Berkeley National Laboratory.   All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *         notice, this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright
 *       notice, this list of conditions and the following disclaimer in
 *       the documentation and/or other materials provided with the
 *       distribution.
 *
 * 3. The end-user documentation included with the redistribution,
 *           if any, must include the following acknowledgment:
 *             "This product includes Radiance software
 *                 (http://radsite.lbl.gov/)
 *                 developed by the Lawrence Berkeley National Laboratory
 *               (http://www.lbl.gov/)."
 *       Alternately, this acknowledgment may appear in the software itself,
 *       if and wherever such third-party acknowledgments normally appear.
 *
 * 4. The names "Radiance," "Lawrence Berkeley National Laboratory"
 *       and "The Regents of the University of California" must
 *       not be used to endorse or promote products derived from this
 *       software without prior written permission. For written
 *       permission, please contact [email protected].
 *
 * 5. Products derived from this software may not be called "Radiance",
 *       nor may "Radiance" appear in their name, without prior written
 *       permission of Lawrence Berkeley National Laboratory.
 *
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED.   IN NO EVENT SHALL Lawrence Berkeley National Laboratory OR
 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 * ====================================================================
 *
 * This software consists of voluntary contributions made by many
 * individuals on behalf of Lawrence Berkeley National Laboratory.   For more
 * information on Lawrence Berkeley National Laboratory, please see
 * <http://www.lbl.gov/>.
 */

#include  "resolu.h"

                                /* view types */
#define  VT_PER         'v'             /* perspective */
#define  VT_PAR         'l'             /* parallel */
#define  VT_ANG         'a'             /* angular fisheye */
#define  VT_HEM         'h'             /* hemispherical fisheye */
#define  VT_CYL         'c'             /* cylindrical panorama */

typedef struct {
        int  type;              /* view type */
        FVECT  vp;              /* view origin */
        FVECT  vdir;            /* view direction */
        FVECT  vup;             /* view up */
        double  horiz;          /* horizontal view size */
        double  vert;           /* vertical view size */
        double  hoff;           /* horizontal image offset */
        double  voff;           /* vertical image offset */
        double  vfore;          /* fore clipping plane */
        double  vaft;           /* aft clipping plane (<=0 for inf) */
        FVECT  hvec;            /* computed horizontal image vector */
        FVECT  vvec;            /* computed vertical image vector */
        double  hn2;            /* DOT(hvec,hvec) */
        double  vn2;            /* DOT(vvec,vvec) */
} VIEW;                 /* view parameters */

extern VIEW  stdview;

#define  viewaspect(v)  sqrt((v)->vn2/(v)->hn2)

#define  STDVIEW        {VT_PER,{0.,0.,0.},{0.,1.,0.},{0.,0.,1.}, \
                                45.,45.,0.,0.,0.,0., \
                                {0.,0.,0.},{0.,0.,0.},0.,0.}

#define  VIEWSTR        "VIEW="
#define  VIEWSTRL       5

#ifdef NOPROTO

extern char     *setview();
extern void     normaspect();
extern double   viewray();
extern void     viewloc();
extern void     pix2loc();
extern void     loc2pix();
extern int      getviewopt();
extern int      sscanview();
extern void     fprintview();
extern char     *viewopt();
extern int      isview();
extern int      viewfile();

#else

extern char     *setview(VIEW *v);
extern void     normaspect(double va, double *ap, int *xp, int *yp);
extern double   viewray(FVECT orig, FVECT direc, VIEW *v, double x, double y);
extern void     viewloc(FVECT ip, VIEW *v, FVECT p);
extern void     pix2loc(FLOAT loc[2], RESOLU *rp, int px, int py);
extern void     loc2pix(int pp[2], RESOLU *rp, double lx, double ly);
extern int      getviewopt(VIEW *v, int ac, char *av[]);
extern int      sscanview(VIEW *vp, char *s);
extern void     fprintview(VIEW *vp, FILE *fp);
extern char     *viewopt(VIEW *vp);
extern int      isview(char *s);
extern int      viewfile(char *fname, VIEW *vp, RESOLU *rp);

#endif
Revision:	2.7
Committed:	Sat Feb 22 02:07:23 2003 UTC (22 years, 8 months ago) by greg
Content type:	text/plain
Branch:	MAIN
Changes since 2.6:	+94 -11 lines
Log Message:	Changes and check-in for 3.5 release Includes new source files and modifications not recorded for many years See ray/doc/notes/ReleaseNotes for notes between 3.1 and 3.5 release
#	User	Rev	Content
1	greg	2.7	/* RCSid: $Id$ */
2	greg	1.1	/*
3			* view.h - header file for image generation.
4			*
5	greg	2.7	* Include after fvect.h
6			* Includes resolu.h
7			*/
8
9			/* ====================================================================
10			* The Radiance Software License, Version 1.0
11			*
12			* Copyright (c) 1990 - 2002 The Regents of the University of California,
13			* through Lawrence Berkeley National Laboratory. All rights reserved.
14			*
15			* Redistribution and use in source and binary forms, with or without
16			* modification, are permitted provided that the following conditions
17			* are met:
18			*
19			* 1. Redistributions of source code must retain the above copyright
20			* notice, this list of conditions and the following disclaimer.
21			*
22			* 2. Redistributions in binary form must reproduce the above copyright
23			* notice, this list of conditions and the following disclaimer in
24			* the documentation and/or other materials provided with the
25			* distribution.
26			*
27			* 3. The end-user documentation included with the redistribution,
28			* if any, must include the following acknowledgment:
29			* "This product includes Radiance software
30			* (http://radsite.lbl.gov/)
31			* developed by the Lawrence Berkeley National Laboratory
32			* (http://www.lbl.gov/)."
33			* Alternately, this acknowledgment may appear in the software itself,
34			* if and wherever such third-party acknowledgments normally appear.
35			*
36			* 4. The names "Radiance," "Lawrence Berkeley National Laboratory"
37			* and "The Regents of the University of California" must
38			* not be used to endorse or promote products derived from this
39			* software without prior written permission. For written
40			* permission, please contact [email protected].
41			*
42			* 5. Products derived from this software may not be called "Radiance",
43			* nor may "Radiance" appear in their name, without prior written
44			* permission of Lawrence Berkeley National Laboratory.
45			*
46			* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
47			* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
48			* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
49			* DISCLAIMED. IN NO EVENT SHALL Lawrence Berkeley National Laboratory OR
50			* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
51			* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
52			* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
53			* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
54			* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
55			* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
56			* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
57			* SUCH DAMAGE.
58			* ====================================================================
59			*
60			* This software consists of voluntary contributions made by many
61			* individuals on behalf of Lawrence Berkeley National Laboratory. For more
62			* information on Lawrence Berkeley National Laboratory, please see
63			* <http://www.lbl.gov/>.
64	greg	1.1	*/
65
66	greg	2.7	#include "resolu.h"
67
68	greg	1.1	/* view types */
69			#define VT_PER 'v' /* perspective */
70			#define VT_PAR 'l' /* parallel */
71	greg	1.6	#define VT_ANG 'a' /* angular fisheye */
72			#define VT_HEM 'h' /* hemispherical fisheye */
73	greg	2.5	#define VT_CYL 'c' /* cylindrical panorama */
74	greg	1.1
75			typedef struct {
76			int type; /* view type */
77			FVECT vp; /* view origin */
78			FVECT vdir; /* view direction */
79			FVECT vup; /* view up */
80			double horiz; /* horizontal view size */
81			double vert; /* vertical view size */
82	greg	1.4	double hoff; /* horizontal image offset */
83			double voff; /* vertical image offset */
84	greg	2.4	double vfore; /* fore clipping plane */
85			double vaft; /* aft clipping plane (<=0 for inf) */
86	greg	1.4	FVECT hvec; /* computed horizontal image vector */
87			FVECT vvec; /* computed vertical image vector */
88			double hn2; /* DOT(hvec,hvec) */
89			double vn2; /* DOT(vvec,vvec) */
90	greg	1.1	} VIEW; /* view parameters */
91
92			extern VIEW stdview;
93
94	greg	1.4	#define viewaspect(v) sqrt((v)->vn2/(v)->hn2)
95
96	greg	2.3	#define STDVIEW {VT_PER,{0.,0.,0.},{0.,1.,0.},{0.,0.,1.}, \
97	greg	2.4	45.,45.,0.,0.,0.,0., \
98			{0.,0.,0.},{0.,0.,0.},0.,0.}
99	greg	1.1
100			#define VIEWSTR "VIEW="
101	greg	1.7	#define VIEWSTRL 5
102	greg	2.7
103			#ifdef NOPROTO
104
105			extern char *setview();
106			extern void normaspect();
107			extern double viewray();
108			extern void viewloc();
109			extern void pix2loc();
110			extern void loc2pix();
111			extern int getviewopt();
112			extern int sscanview();
113			extern void fprintview();
114			extern char *viewopt();
115			extern int isview();
116			extern int viewfile();
117
118			#else
119
120			extern char setview(VIEW v);
121			extern void normaspect(double va, double ap, int xp, int *yp);
122			extern double viewray(FVECT orig, FVECT direc, VIEW *v, double x, double y);
123			extern void viewloc(FVECT ip, VIEW *v, FVECT p);
124			extern void pix2loc(FLOAT loc[2], RESOLU *rp, int px, int py);
125			extern void loc2pix(int pp[2], RESOLU *rp, double lx, double ly);
126			extern int getviewopt(VIEW v, int ac, char av[]);
127			extern int sscanview(VIEW vp, char s);
128			extern void fprintview(VIEW vp, FILE fp);
129			extern char viewopt(VIEW vp);
130			extern int isview(char *s);
131			extern int viewfile(char fname, VIEW vp, RESOLU *rp);
132
133			#endif