src/rt/ambient.h

/* RCSid: $Id$ */
/*
 * Common definitions for interreflection routines.
 *
 * Include after ray.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/>.
 */

/*
 * Since we've defined our vectors as float below to save space,
 * watch out for changes in the definitions of VCOPY() and DOT()
 * and don't pass these vectors to fvect routines.
 */
typedef struct ambrec {
        unsigned long  latick;  /* last accessed tick */
        float  pos[3];          /* position in space */
        float  dir[3];          /* normal direction */
        int  lvl;               /* recursion level of parent ray */
        float  weight;          /* weight of parent ray */
        float  rad;             /* validity radius */
        COLOR  val;             /* computed ambient value */
        float  gpos[3];         /* gradient wrt. position */
        float  gdir[3];         /* gradient wrt. direction */
        struct ambrec  *next;   /* next in list */
}  AMBVAL;                      /* ambient value */

typedef struct ambtree {
        AMBVAL  *alist;         /* ambient value list */
        struct ambtree  *kid;   /* 8 child nodes */
}  AMBTREE;                     /* ambient octree */

typedef struct {
        short  t, p;            /* theta, phi indices */
        COLOR  v;               /* value sum */
        float  r;               /* 1/distance sum */
        float  k;               /* variance for this division */
        int  n;                 /* number of subsamples */
}  AMBSAMP;             /* ambient sample division */

typedef struct {
        FVECT  ux, uy, uz;      /* x, y and z axis directions */
        short  nt, np;          /* number of theta and phi directions */
}  AMBHEMI;             /* ambient sample hemisphere */

extern double  maxarad;         /* maximum ambient radius */
extern double  minarad;         /* minimum ambient radius */

#define  AVGREFL        0.5     /* assumed average reflectance */

#define  AMBVALSIZ      75      /* number of bytes in portable AMBVAL struct */
#define  AMBMAGIC       557     /* magic number for ambient value files */
#define  AMBFMT         "Radiance_ambval"       /* format id string */

#ifdef NOPROTO

extern int      divsample();
extern double   doambient();
extern void     inithemi();
extern void     comperrs();
extern void     posgradient();
extern void     dirgradient();
extern void     setambres();
extern void     setambacc();
extern void     setambient();
extern void     ambdone();
extern void     ambnotify();
extern void     ambient();
extern double   sumambient();
extern double   makeambient();
extern void     extambient();
extern int      ambsync();
extern void     putambmagic();
extern int      hasambmagic();
extern int      writambval();
extern int      ambvalOK();
extern int      readambval();
extern void     lookamb();
extern void     writamb();

#else
                                        /* defined in ambcomp.c */
extern int      divsample(AMBSAMP *dp, AMBHEMI *h, RAY *r);
extern double   doambient(COLOR acol, RAY *r, double wt, FVECT pg, FVECT dg);
extern void     inithemi(AMBHEMI *hp, RAY *r, double wt);
extern void     comperrs(AMBSAMP *da, AMBHEMI *hp);
extern void     posgradient(FVECT gv, AMBSAMP *da, AMBHEMI *hp);
extern void     dirgradient(FVECT gv, AMBSAMP *da, AMBHEMI *hp);
                                        /* defined in ambient.c */
extern void     setambres(int ar);
extern void     setambacc(double newa);
extern void     setambient(void);
extern void     ambdone(void);
extern void     ambnotify(OBJECT obj);
extern void     ambient(COLOR acol, RAY *r, FVECT nrm);
extern double   sumambient(COLOR acol, RAY *r, FVECT rn, int al,
                                AMBTREE *at, FVECT c0, double s);
extern double   makeambient(COLOR acol, RAY *r, FVECT rn, int al);
extern void     extambient(COLOR cr, AMBVAL *ap, FVECT pv, FVECT nv);
extern int      ambsync(void);
                                        /* defined in ambio.c */
extern void     putambmagic(FILE *fp);
extern int      hasambmagic(FILE *fp);
extern int      writambval(AMBVAL *av, FILE *fp);
extern int      ambvalOK(AMBVAL *av);
extern int      readambval(AMBVAL *av, FILE *fp);
                                        /* defined in lookamb.c */
extern void     lookamb(FILE *fp);
extern void     writamb(FILE *fp);

#endif
Revision:	2.7
Committed:	Sat Feb 22 02:07:28 2003 UTC (22 years, 8 months ago) by greg
Content type:	text/plain
Branch:	MAIN
Changes since 2.6:	+136 -15 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			* Common definitions for interreflection routines.
4	greg	2.7	*
5			* Include after ray.h
6			*/
7
8			/* ====================================================================
9			* The Radiance Software License, Version 1.0
10			*
11			* Copyright (c) 1990 - 2002 The Regents of the University of California,
12			* through Lawrence Berkeley National Laboratory. All rights reserved.
13			*
14			* Redistribution and use in source and binary forms, with or without
15			* modification, are permitted provided that the following conditions
16			* are met:
17			*
18			* 1. Redistributions of source code must retain the above copyright
19			* notice, this list of conditions and the following disclaimer.
20			*
21			* 2. Redistributions in binary form must reproduce the above copyright
22			* notice, this list of conditions and the following disclaimer in
23			* the documentation and/or other materials provided with the
24			* distribution.
25			*
26			* 3. The end-user documentation included with the redistribution,
27			* if any, must include the following acknowledgment:
28			* "This product includes Radiance software
29			* (http://radsite.lbl.gov/)
30			* developed by the Lawrence Berkeley National Laboratory
31			* (http://www.lbl.gov/)."
32			* Alternately, this acknowledgment may appear in the software itself,
33			* if and wherever such third-party acknowledgments normally appear.
34			*
35			* 4. The names "Radiance," "Lawrence Berkeley National Laboratory"
36			* and "The Regents of the University of California" must
37			* not be used to endorse or promote products derived from this
38			* software without prior written permission. For written
39			* permission, please contact [email protected].
40			*
41			* 5. Products derived from this software may not be called "Radiance",
42			* nor may "Radiance" appear in their name, without prior written
43			* permission of Lawrence Berkeley National Laboratory.
44			*
45			* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
46			* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
47			* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
48			* DISCLAIMED. IN NO EVENT SHALL Lawrence Berkeley National Laboratory OR
49			* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
50			* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
51			* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
52			* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
53			* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
54			* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
55			* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
56			* SUCH DAMAGE.
57			* ====================================================================
58			*
59			* This software consists of voluntary contributions made by many
60			* individuals on behalf of Lawrence Berkeley National Laboratory. For more
61			* information on Lawrence Berkeley National Laboratory, please see
62			* <http://www.lbl.gov/>.
63	greg	1.1	*/
64
65			/*
66			* Since we've defined our vectors as float below to save space,
67			* watch out for changes in the definitions of VCOPY() and DOT()
68			* and don't pass these vectors to fvect routines.
69			*/
70			typedef struct ambrec {
71	greg	2.5	unsigned long latick; /* last accessed tick */
72	greg	1.1	float pos[3]; /* position in space */
73			float dir[3]; /* normal direction */
74			int lvl; /* recursion level of parent ray */
75			float weight; /* weight of parent ray */
76			float rad; /* validity radius */
77			COLOR val; /* computed ambient value */
78			float gpos[3]; /* gradient wrt. position */
79			float gdir[3]; /* gradient wrt. direction */
80			struct ambrec next; / next in list */
81			} AMBVAL; /* ambient value */
82
83	greg	2.7	typedef struct ambtree {
84			AMBVAL alist; / ambient value list */
85			struct ambtree kid; / 8 child nodes */
86			} AMBTREE; /* ambient octree */
87
88			typedef struct {
89			short t, p; /* theta, phi indices */
90			COLOR v; /* value sum */
91			float r; /* 1/distance sum */
92			float k; /* variance for this division */
93			int n; /* number of subsamples */
94			} AMBSAMP; /* ambient sample division */
95
96			typedef struct {
97			FVECT ux, uy, uz; /* x, y and z axis directions */
98			short nt, np; /* number of theta and phi directions */
99			} AMBHEMI; /* ambient sample hemisphere */
100
101	greg	1.1	extern double maxarad; /* maximum ambient radius */
102			extern double minarad; /* minimum ambient radius */
103
104	greg	1.2	#define AVGREFL 0.5 /* assumed average reflectance */
105	greg	2.2
106			#define AMBVALSIZ 75 /* number of bytes in portable AMBVAL struct */
107	greg	2.4	#define AMBMAGIC 557 /* magic number for ambient value files */
108	greg	2.3	#define AMBFMT "Radiance_ambval" /* format id string */
109	greg	2.7
110			#ifdef NOPROTO
111
112			extern int divsample();
113			extern double doambient();
114			extern void inithemi();
115			extern void comperrs();
116			extern void posgradient();
117			extern void dirgradient();
118			extern void setambres();
119			extern void setambacc();
120			extern void setambient();
121			extern void ambdone();
122			extern void ambnotify();
123			extern void ambient();
124			extern double sumambient();
125			extern double makeambient();
126			extern void extambient();
127			extern int ambsync();
128			extern void putambmagic();
129			extern int hasambmagic();
130			extern int writambval();
131			extern int ambvalOK();
132			extern int readambval();
133			extern void lookamb();
134			extern void writamb();
135
136			#else
137			/* defined in ambcomp.c */
138			extern int divsample(AMBSAMP dp, AMBHEMI h, RAY *r);
139			extern double doambient(COLOR acol, RAY *r, double wt, FVECT pg, FVECT dg);
140			extern void inithemi(AMBHEMI hp, RAY r, double wt);
141			extern void comperrs(AMBSAMP da, AMBHEMI hp);
142			extern void posgradient(FVECT gv, AMBSAMP da, AMBHEMI hp);
143			extern void dirgradient(FVECT gv, AMBSAMP da, AMBHEMI hp);
144			/* defined in ambient.c */
145			extern void setambres(int ar);
146			extern void setambacc(double newa);
147			extern void setambient(void);
148			extern void ambdone(void);
149			extern void ambnotify(OBJECT obj);
150			extern void ambient(COLOR acol, RAY *r, FVECT nrm);
151			extern double sumambient(COLOR acol, RAY *r, FVECT rn, int al,
152			AMBTREE *at, FVECT c0, double s);
153			extern double makeambient(COLOR acol, RAY *r, FVECT rn, int al);
154			extern void extambient(COLOR cr, AMBVAL *ap, FVECT pv, FVECT nv);
155			extern int ambsync(void);
156			/* defined in ambio.c */
157			extern void putambmagic(FILE *fp);
158			extern int hasambmagic(FILE *fp);
159			extern int writambval(AMBVAL av, FILE fp);
160			extern int ambvalOK(AMBVAL *av);
161			extern int readambval(AMBVAL av, FILE fp);
162			/* defined in lookamb.c */
163			extern void lookamb(FILE *fp);
164			extern void writamb(FILE *fp);
165
166			#endif