src/rt/ambient.h

/* RCSid $Id: ambient.h,v 2.20 2014/04/11 22:54:34 greg Exp $ */
/*
 * Common definitions for interreflection routines.
 *
 * Include after ray.h
 */

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

#ifdef NEWAMB

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