ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/rt/source.h
Revision: 2.19
Committed: Mon Sep 15 00:54:39 2014 UTC (9 years, 6 months ago) by greg
Content type: text/plain
Branch: MAIN
CVS Tags: rad5R2, rad4R2P2, rad5R0, rad5R1, rad4R2P1
Changes since 2.18: +4 -1 lines
Log Message:
Set minimum number of shadow checks to perform (4)

File Contents

# Content
1 /* RCSid $Id: source.h,v 2.18 2008/12/06 01:08:53 greg Exp $ */
2 /*
3 * source.h - header file for ray tracing sources.
4 *
5 * Include after ray.h
6 */
7 #ifndef _RAD_SOURCE_H_
8 #define _RAD_SOURCE_H_
9
10 #include <string.h>
11
12 #ifdef __cplusplus
13 extern "C" {
14 #endif
15
16 #ifndef AIMREQT
17 #define AIMREQT 100 /* required aim success/failure */
18 #endif
19 #ifndef SHADCACHE
20 #define SHADCACHE 20 /* shadow cache resolution */
21 #endif
22 #ifndef MINSHADCNT
23 #define MINSHADCNT 4 /* test all sources if this few */
24 #endif
25
26 #define SDISTANT 01 /* source distant flag */
27 #define SSKIP 02 /* source skip flag */
28 #define SPROX 04 /* source proximity flag */
29 #define SSPOT 010 /* source spotlight flag */
30 #define SVIRTUAL 020 /* source virtual flag */
31 #define SFLAT 040 /* source flat flag */
32 #define SCIR 0100 /* source circular flag */
33 #define SCYL 0200 /* source cylindrical flag */
34 #define SFOLLOW 0400 /* source follow path flag */
35
36 typedef struct {
37 FVECT aim; /* aim direction or center */
38 float siz; /* output solid angle or area */
39 float flen; /* focal length (negative if distant source) */
40 } SPOT; /* spotlight */
41
42 typedef struct {
43 union {
44 struct {
45 FVECT u, v; /* unit vectors */
46 } f; /* flat source indexing */
47 struct {
48 FVECT o; /* origin position */
49 RREAL e1, e2; /* 1/extent */
50 int ax; /* major direction */
51 } d; /* distant source indexing */
52 } p; /* indexing parameters */
53 OBJECT obs[1]; /* cache obstructors (extends struct) */
54 } OBSCACHE; /* obstructor cache */
55
56 typedef struct {
57 FVECT sloc; /* direction or position of source */
58 FVECT ss[3]; /* source dimension vectors, U, V, and W */
59 float srad; /* maximum source radius */
60 float ss2; /* solid angle or projected area */
61 OBJREC *so; /* source destination object */
62 struct {
63 float prox; /* proximity */
64 SPOT *s; /* spot */
65 } sl; /* localized source information */
66 union {
67 long success; /* successes - AIMREQT*failures */
68 struct {
69 short pn; /* projection number */
70 int sn; /* next source to aim for */
71 } sv; /* virtual source */
72 } sa; /* source aiming information */
73 unsigned long
74 ntests, nhits; /* shadow tests and hits */
75 #ifdef SHADCACHE
76 OBSCACHE *obscache; /* obstructor cache */
77 #endif
78 int sflags; /* source flags */
79 } SRCREC; /* light source */
80
81 #define MAXSPART 64 /* maximum partitions per source */
82
83 #define SU 0 /* U vector or partition */
84 #define SV 1 /* V vector or partition */
85 #define SW 2 /* W vector or partition */
86 #define S0 3 /* leaf partition */
87
88 #define snorm ss[SW] /* normal vector for flat source */
89
90 typedef struct {
91 double dom; /* solid angle of partition */
92 int sn; /* source number */
93 short np; /* number of partitions */
94 short sp; /* this partition number */
95 unsigned char spt[MAXSPART/2]; /* source partitioning */
96 } SRCINDEX; /* source index structure */
97
98 #define initsrcindex(s) ((s)->sn = (s)->sp = -1, (s)->np = 0)
99
100 #define clrpart(pt) memset((char *)(pt), '\0', MAXSPART/2)
101 #define setpart(pt,i,v) ((pt)[(i)>>2] |= (v)<<(((i)&3)<<1))
102 #define spart(pt,pi) ((pt)[(pi)>>2] >> (((pi)&3)<<1) & 3)
103
104 /*
105 * Special support functions for sources
106 */
107
108 /*
109 * Virtual source materials must define the following.
110 *
111 * vproj(pm, op, sp, i) Compute i'th virtual projection
112 * of source sp in object op and assign
113 * the 4x4 transformation matrix pm.
114 * Return 1 on success, 0 if no i'th projection.
115 *
116 * nproj The number of projections. The value of
117 * i passed to vproj runs from 0 to nproj-1.
118 */
119
120 typedef struct {
121 int (*vproj)(); /* project virtual sources */
122 int nproj; /* number of possible projections */
123 } VSMATERIAL; /* virtual source material functions */
124
125 typedef struct {
126 void (*setsrc)(); /* set light source for object */
127 void (*partit)(); /* partition light source object */
128 double (*getpleq)(); /* plane equation for surface */
129 double (*getdisk)(); /* maximum disk for surface */
130 } SOBJECT; /* source object functions */
131
132 typedef union {
133 VSMATERIAL *mf; /* material functions */
134 SOBJECT *of; /* object functions */
135 } SRCFUNC; /* source functions */
136
137 extern SRCFUNC sfun[]; /* source dispatch table */
138
139 extern SRCREC *source; /* our source list */
140 extern int nsources; /* the number of sources */
141
142 #define sflatform(sn,dir) -DOT(source[sn].snorm, dir)
143
144 #define getplaneq(c,o) (*sfun[(o)->otype].of->getpleq)(c,o)
145 #define getmaxdisk(c,o) (*sfun[(o)->otype].of->getdisk)(c,o)
146 #define setsource(s,o) (*sfun[(o)->otype].of->setsrc)(s,o)
147
148 /* defined in source.c */
149 extern OBJREC *findmaterial(OBJREC *o);
150 extern void marksources(void);
151 extern void freesources(void);
152 extern int srcray(RAY *sr, RAY *r, SRCINDEX *si);
153 extern void srcvalue(RAY *r);
154 extern int sourcehit(RAY *r);
155 typedef void srcdirf_t(COLOR cv, void *np, FVECT ldir, double omega);
156 extern void direct(RAY *r, srcdirf_t *f, void *p);
157 extern void srcscatter(RAY *r);
158 extern int m_light(OBJREC *m, RAY *r);
159 /* defined in srcobstr.c */
160 extern void initobscache(int sn);
161 extern int srcblocker(RAY *r);
162 extern int srcblocked(RAY *r);
163 extern void freeobscache(SRCREC *s);
164 extern void markclip(OBJREC *m);
165 /* defined in srcsamp.c */
166 extern double nextssamp(RAY *r, SRCINDEX *si);
167 extern int skipparts(int ct[3], int sz[3], int pp[2], unsigned char *pt);
168 extern void nopart(SRCINDEX *si, RAY *r);
169 extern void cylpart(SRCINDEX *si, RAY *r);
170 extern void flatpart(SRCINDEX *si, RAY *r);
171 extern double scylform(int sn, FVECT dir);
172 /* defined in srcsupp.c */
173 extern void initstypes(void);
174 extern int newsource(void);
175 extern void setflatss(SRCREC *src);
176 extern void fsetsrc(SRCREC *src, OBJREC *so);
177 extern void ssetsrc(SRCREC *src, OBJREC *so);
178 extern void sphsetsrc(SRCREC *src, OBJREC *so);
179 extern void rsetsrc(SRCREC *src, OBJREC *so);
180 extern void cylsetsrc(SRCREC *src, OBJREC *so);
181 extern SPOT *makespot(OBJREC *m);
182 extern int spotout(RAY *r, SPOT *s);
183 extern double fgetmaxdisk(FVECT ocent, OBJREC *op);
184 extern double rgetmaxdisk(FVECT ocent, OBJREC *op);
185 extern double fgetplaneq(FVECT nvec, OBJREC *op);
186 extern double rgetplaneq(FVECT nvec, OBJREC *op);
187 extern int commonspot(SPOT *sp1, SPOT *sp2, FVECT org);
188 extern int commonbeam(SPOT *sp1, SPOT *sp2, FVECT org);
189 extern int checkspot(SPOT *sp, FVECT nrm);
190 extern double spotdisk(FVECT oc, OBJREC *op, SPOT *sp, FVECT pos);
191 extern double beamdisk(FVECT oc, OBJREC *op, SPOT *sp, FVECT dir);
192 extern double intercircle(FVECT cc, FVECT c1, FVECT c2,
193 double r1s, double r2s);
194 /* defined in virtuals.c */
195 extern void markvirtuals(void);
196 extern void addvirtuals(int sn, int nr);
197 extern void vproject(OBJREC *o, int sn, int n);
198 extern OBJREC *vsmaterial(OBJREC *o);
199 extern int makevsrc(OBJREC *op, int sn, MAT4 pm);
200 extern double getdisk(FVECT oc, OBJREC *op, int sn);
201 extern int vstestvis(int f, OBJREC *o, FVECT oc, double or2, int sn);
202 extern void virtverb(int sn, FILE *fp);
203
204
205 #ifdef __cplusplus
206 }
207 #endif
208 #endif /* _RAD_SOURCE_H_ */
209