src/rt/ambient.h

/* RCSid $Id: ambient.h,v 2.22 2014/05/07 01:16:03 greg Exp $ */
/*
 * Common definitions for interreflection routines.
 *
 * Include after ray.h
 */

#ifndef _RAD_AMBIENT_H_
#define _RAD_AMBIENT_H_
#ifdef __cplusplus
extern "C" {
#endif

#ifndef OLDAMB

/*
 * Normal and u-vector directions encoded using dircode.c
 */
typedef struct ambrec {
        struct ambrec  *next;   /* next in list */
        unsigned long  latick;  /* last accessed tick */
        float  pos[3];          /* position in space */
        int32  ndir;            /* encoded surface normal */
        int32  udir;            /* u-vector direction */
        int  lvl;               /* recursion level of parent ray */
        float  weight;          /* weight of parent ray */
        float  rad[2];          /* anisotropic radii (rad[0] <= rad[1]) */
        COLOR  val;             /* computed ambient value */
        float  gpos[2];         /* (u,v) gradient wrt. position */
        float  gdir[2];         /* (u,v) gradient wrt. direction */
        uint32  corral;         /* potential light leak direction flags */
}  AMBVAL;                      /* ambient value */

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

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

#ifndef AVGREFL
#define  AVGREFL        0.5     /* assumed average reflectance */
#endif

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

                                        /* defined in ambient.c */
extern void     setambres(int ar);
extern void     setambacc(double newa);
extern void     setambient(void);
extern void     multambient(COLOR aval, RAY *r, FVECT nrm);
extern void     ambdone(void);
extern void     ambnotify(OBJECT obj);
extern int      ambsync(void);
                                        /* defined in ambcomp.c */
extern int      doambient(COLOR acol, RAY *r, double wt,
                                FVECT uv[2], float rad[2],
                                float gpos[2], float gdir[2], uint32 *crlp);
                                        /* defined in ambio.c */
extern void     putambmagic(FILE *fp);
extern int      hasambmagic(FILE *fp);
extern int      writambval(AMBVAL *av, FILE *fp);
extern int      readambval(AMBVAL *av, FILE *fp);
extern int      ambvalOK(AMBVAL *av);

#else /* ! NEWAMB */

/*
 * 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 {
        struct ambrec  *next;   /* next in list */
        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 */
}  AMBVAL;                      /* ambient value */

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

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

typedef struct {
        FVECT  ux, uy, uz;      /* x, y and z axis directions */
        COLOR  acoef;           /* division contribution coefficient */
        int    ns;              /* number of super-samples */
        int    nt, np;          /* number of theta and phi directions */
}  AMBHEMI;             /* ambient sample hemisphere */

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

#ifndef AVGREFL
#define  AVGREFL        0.5     /* assumed average reflectance */
#endif

#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 */

                                        /* defined in ambient.c */
extern void     setambres(int ar);
extern void     setambacc(double newa);
extern void     setambient(void);
extern void     multambient(COLOR aval, RAY *r, FVECT nrm);
extern void     ambdone(void);
extern void     ambnotify(OBJECT obj);
extern int      ambsync(void);
                                        /* defined in ambcomp.c */
extern double   doambient(COLOR acol, RAY *r, double wt,
                                        FVECT pg, FVECT dg);
extern void     inithemi(AMBHEMI *hp, COLOR ac, RAY *r, double wt);
extern int      divsample(AMBSAMP *dp, AMBHEMI *h, RAY *r);
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 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);

#endif  /* ! NEWAMB */

#ifdef __cplusplus
}
#endif
#endif /* _RAD_AMBIENT_H_ */

Revision:	2.23
Committed:	Thu Jun 19 16:26:55 2014 UTC (9 years, 10 months ago) by greg
Content type:	text/plain
Branch:	MAIN
CVS Tags:	rad4R2P2, rad4R2, rad4R2P1
Changes since 2.22:	+2 -2 lines
Log Message:	Officially replaced ambient calculation with new Hessian-based error control
#	User	Rev	Content
1	greg	2.23	/* RCSid $Id: ambient.h,v 2.22 2014/05/07 01:16:03 greg Exp $ */
2	greg	1.1	/*
3			* Common definitions for interreflection routines.
4	greg	2.7	*
5			* Include after ray.h
6			*/
7	greg	2.19
8	schorsch	2.9	#ifndef _RAD_AMBIENT_H_
9			#define _RAD_AMBIENT_H_
10			#ifdef __cplusplus
11			extern "C" {
12			#endif
13	greg	1.1
14	greg	2.23	#ifndef OLDAMB
15	greg	2.19
16			/*
17			* Normal and u-vector directions encoded using dircode.c
18			*/
19			typedef struct ambrec {
20			struct ambrec next; / next in list */
21			unsigned long latick; /* last accessed tick */
22			float pos[3]; /* position in space */
23			int32 ndir; /* encoded surface normal */
24			int32 udir; /* u-vector direction */
25	greg	2.22	int lvl; /* recursion level of parent ray */
26	greg	2.19	float weight; /* weight of parent ray */
27			float rad[2]; /* anisotropic radii (rad[0] <= rad[1]) */
28			COLOR val; /* computed ambient value */
29			float gpos[2]; /* (u,v) gradient wrt. position */
30			float gdir[2]; /* (u,v) gradient wrt. direction */
31	greg	2.22	uint32 corral; /* potential light leak direction flags */
32	greg	2.19	} AMBVAL; /* ambient value */
33
34			typedef struct ambtree {
35			AMBVAL alist; / ambient value list */
36			struct ambtree kid; / 8 child nodes */
37			} AMBTREE; /* ambient octree */
38
39			extern double maxarad; /* maximum ambient radius */
40			extern double minarad; /* minimum ambient radius */
41
42			#ifndef AVGREFL
43			#define AVGREFL 0.5 /* assumed average reflectance */
44			#endif
45
46	greg	2.22	#define AMBVALSIZ 67 /* number of bytes in portable AMBVAL struct */
47			#define AMBMAGIC 559 /* magic number for ambient value files */
48	greg	2.19	#define AMBFMT "Radiance_ambval" /* format id string */
49
50			/* defined in ambient.c */
51			extern void setambres(int ar);
52			extern void setambacc(double newa);
53			extern void setambient(void);
54			extern void multambient(COLOR aval, RAY *r, FVECT nrm);
55			extern void ambdone(void);
56			extern void ambnotify(OBJECT obj);
57			extern int ambsync(void);
58			/* defined in ambcomp.c */
59			extern int doambient(COLOR acol, RAY *r, double wt,
60			FVECT uv[2], float rad[2],
61	greg	2.22	float gpos[2], float gdir[2], uint32 *crlp);
62	greg	2.19	/* defined in ambio.c */
63			extern void putambmagic(FILE *fp);
64			extern int hasambmagic(FILE *fp);
65			extern int writambval(AMBVAL av, FILE fp);
66	greg	2.20	extern int readambval(AMBVAL av, FILE fp);
67	greg	2.19	extern int ambvalOK(AMBVAL *av);
68
69			#else /* ! NEWAMB */
70
71	greg	1.1	/*
72			* Since we've defined our vectors as float below to save space,
73			* watch out for changes in the definitions of VCOPY() and DOT()
74			* and don't pass these vectors to fvect routines.
75			*/
76			typedef struct ambrec {
77	greg	2.18	struct ambrec next; / next in list */
78	greg	2.5	unsigned long latick; /* last accessed tick */
79	greg	1.1	float pos[3]; /* position in space */
80			float dir[3]; /* normal direction */
81	greg	2.14	int lvl; /* recursion level of parent ray */
82	greg	1.1	float weight; /* weight of parent ray */
83			float rad; /* validity radius */
84			COLOR val; /* computed ambient value */
85			float gpos[3]; /* gradient wrt. position */
86			float gdir[3]; /* gradient wrt. direction */
87			} AMBVAL; /* ambient value */
88
89	greg	2.7	typedef struct ambtree {
90			AMBVAL alist; / ambient value list */
91			struct ambtree kid; / 8 child nodes */
92			} AMBTREE; /* ambient octree */
93
94			typedef struct {
95	greg	2.15	COLOR v; /* division sum (partial) */
96	greg	2.7	float r; /* 1/distance sum */
97			float k; /* variance for this division */
98	greg	2.17	int n; /* number of subsamples */
99			unsigned short t, p; /* theta, phi indices */
100	greg	2.7	} AMBSAMP; /* ambient sample division */
101
102			typedef struct {
103	greg	2.16	FVECT ux, uy, uz; /* x, y and z axis directions */
104	greg	2.15	COLOR acoef; /* division contribution coefficient */
105	greg	2.16	int ns; /* number of super-samples */
106	greg	2.17	int nt, np; /* number of theta and phi directions */
107	greg	2.7	} AMBHEMI; /* ambient sample hemisphere */
108
109	greg	1.1	extern double maxarad; /* maximum ambient radius */
110			extern double minarad; /* minimum ambient radius */
111
112	greg	2.11	#ifndef AVGREFL
113	greg	1.2	#define AVGREFL 0.5 /* assumed average reflectance */
114	greg	2.11	#endif
115	greg	2.2
116			#define AMBVALSIZ 75 /* number of bytes in portable AMBVAL struct */
117	greg	2.4	#define AMBMAGIC 557 /* magic number for ambient value files */
118	greg	2.3	#define AMBFMT "Radiance_ambval" /* format id string */
119	greg	2.7
120			/* defined in ambient.c */
121			extern void setambres(int ar);
122			extern void setambacc(double newa);
123			extern void setambient(void);
124	greg	2.12	extern void multambient(COLOR aval, RAY *r, FVECT nrm);
125	greg	2.7	extern void ambdone(void);
126			extern void ambnotify(OBJECT obj);
127			extern int ambsync(void);
128	greg	2.12	/* defined in ambcomp.c */
129	greg	2.15	extern double doambient(COLOR acol, RAY *r, double wt,
130	greg	2.12	FVECT pg, FVECT dg);
131	greg	2.15	extern void inithemi(AMBHEMI hp, COLOR ac, RAY r, double wt);
132	greg	2.12	extern int divsample(AMBSAMP dp, AMBHEMI h, RAY *r);
133			extern void comperrs(AMBSAMP da, AMBHEMI hp);
134			extern void posgradient(FVECT gv, AMBSAMP da, AMBHEMI hp);
135			extern void dirgradient(FVECT gv, AMBSAMP da, AMBHEMI hp);
136	greg	2.7	/* defined in ambio.c */
137			extern void putambmagic(FILE *fp);
138			extern int hasambmagic(FILE *fp);
139			extern int writambval(AMBVAL av, FILE fp);
140			extern int ambvalOK(AMBVAL *av);
141			extern int readambval(AMBVAL av, FILE fp);
142
143	greg	2.19	#endif /* ! NEWAMB */
144	schorsch	2.9
145			#ifdef __cplusplus
146			}
147	greg	2.7	#endif
148	schorsch	2.9	#endif /* _RAD_AMBIENT_H_ */
149