| 1 |
< |
/* Copyright (c) 1986 Regents of the University of California */ |
| 2 |
< |
|
| 3 |
< |
/* SCCSid "$SunId$ LBL" */ |
| 4 |
< |
|
| 1 |
> |
/* RCSid $Id$ */ |
| 2 |
|
/* |
| 3 |
|
* ray.h - header file for routines using rays. |
| 7 |
– |
* |
| 8 |
– |
* 8/7/85 |
| 4 |
|
*/ |
| 5 |
+ |
#ifndef _RAD_RAY_H_ |
| 6 |
+ |
#define _RAD_RAY_H_ |
| 7 |
|
|
| 8 |
|
#include "standard.h" |
| 9 |
< |
|
| 9 |
> |
#include "octree.h" |
| 10 |
|
#include "object.h" |
| 14 |
– |
|
| 11 |
|
#include "color.h" |
| 12 |
+ |
#include "pmapparm.h" |
| 13 |
|
|
| 14 |
+ |
#ifdef __cplusplus |
| 15 |
+ |
extern "C" { |
| 16 |
+ |
#endif |
| 17 |
+ |
|
| 18 |
+ |
#ifndef RNUMBER |
| 19 |
+ |
#define RNUMBER size_t /* ray counter (>= sizeof pointer) */ |
| 20 |
+ |
#endif |
| 21 |
+ |
|
| 22 |
+ |
#define MAXDIM 32 /* maximum number of dimensions */ |
| 23 |
+ |
|
| 24 |
|
/* ray type flags */ |
| 25 |
|
#define PRIMARY 01 /* original ray */ |
| 26 |
|
#define SHADOW 02 /* ray to light source */ |
| 28 |
|
#define REFRACTED 010 /* refracted (bent) ray */ |
| 29 |
|
#define TRANS 020 /* transmitted/transferred ray */ |
| 30 |
|
#define AMBIENT 040 /* ray scattered for interreflection */ |
| 31 |
+ |
#define SPECULAR 0100 /* ray scattered for specular */ |
| 32 |
|
|
| 33 |
|
/* reflected ray types */ |
| 34 |
< |
#define RAYREFL (SHADOW|REFLECTED|AMBIENT) |
| 34 |
> |
#define RAYREFL (SHADOW|REFLECTED|AMBIENT|SPECULAR) |
| 35 |
|
|
| 36 |
+ |
/* Arrange so double's come first for optimal alignment */ |
| 37 |
+ |
/* Pointers and long's come second for 64-bit mode */ |
| 38 |
+ |
/* Int's next (unknown length), then floats, followed by short's & char's */ |
| 39 |
|
typedef struct ray { |
| 40 |
< |
long rno; /* unique ray number */ |
| 41 |
< |
int rlvl; /* number of reflections for this ray */ |
| 42 |
< |
float rweight; /* cumulative weight of this ray */ |
| 43 |
< |
short rtype; /* ray type */ |
| 44 |
< |
short crtype; /* cumulative ray type */ |
| 45 |
< |
struct ray *parent; /* ray this originated from */ |
| 46 |
< |
FVECT rorg; /* origin of ray */ |
| 47 |
< |
FVECT rdir; /* normalized direction of ray */ |
| 48 |
< |
int rsrc; /* source we're aiming for */ |
| 49 |
< |
OBJECT *clipset; /* set of objects currently clipped */ |
| 50 |
< |
OBJECT *newcset; /* next clipset, used for transmission */ |
| 51 |
< |
OBJREC *ro; /* intersected object */ |
| 52 |
< |
double rot; /* distance to object */ |
| 53 |
< |
FVECT rop; /* intersection point */ |
| 54 |
< |
FVECT ron; /* intersection surface normal */ |
| 55 |
< |
double rod; /* -DOT(rdir, ron) */ |
| 56 |
< |
double rofx[4][4]; /* transform from object space */ |
| 57 |
< |
double rofs; /* scaling factor from object */ |
| 58 |
< |
double robx[4][4]; /* transform back to object space */ |
| 59 |
< |
double robs; /* back scaling factor */ |
| 60 |
< |
FVECT pert; /* surface normal perturbation */ |
| 61 |
< |
COLOR pcol; /* pattern color */ |
| 62 |
< |
COLOR rcol; /* returned ray value */ |
| 63 |
< |
double rt; /* returned effective ray length */ |
| 40 |
> |
FVECT rorg; /* origin of ray */ |
| 41 |
> |
FVECT rdir; /* normalized direction of ray */ |
| 42 |
> |
RREAL rmax; /* maximum distance (aft clipping plane) */ |
| 43 |
> |
RREAL rot; /* distance to object */ |
| 44 |
> |
FVECT rop; /* intersection point */ |
| 45 |
> |
FVECT ron; /* intersection surface normal */ |
| 46 |
> |
RREAL rod; /* -DOT(rdir, ron) */ |
| 47 |
> |
RREAL uv[2]; /* local coordinates */ |
| 48 |
> |
FVECT pert; /* surface normal perturbation */ |
| 49 |
> |
RREAL rmt; /* returned mirrored ray length */ |
| 50 |
> |
RREAL rxt; /* returned unmirrored ray length */ |
| 51 |
> |
const struct ray *parent; /* ray this originated from */ |
| 52 |
> |
OBJECT *clipset; /* set of objects currently clipped */ |
| 53 |
> |
OBJECT *newcset; /* next clipset, used for transmission */ |
| 54 |
> |
void (*revf)(struct ray *); /* ray evaluation function */ |
| 55 |
> |
void (*hitf)(OBJECT *, struct ray *); /* custom hit test */ |
| 56 |
> |
OBJREC *ro; /* intersected object (one with material) */ |
| 57 |
> |
FULLXF *rox; /* object transformation */ |
| 58 |
> |
int *slights; /* list of lights to test for scattering */ |
| 59 |
> |
RNUMBER rno; /* unique ray number */ |
| 60 |
> |
OBJECT robj; /* intersected object number */ |
| 61 |
> |
int rsrc; /* source we're aiming for */ |
| 62 |
> |
float rweight; /* cumulative weight (for termination) */ |
| 63 |
> |
float gecc; /* scattering eccentricity coefficient */ |
| 64 |
> |
COLOR rcoef; /* contribution coefficient w.r.t. parent */ |
| 65 |
> |
COLOR pcol; /* pattern color */ |
| 66 |
> |
COLOR mcol; /* mirrored color contribution */ |
| 67 |
> |
COLOR rcol; /* returned radiance value */ |
| 68 |
> |
COLOR cext; /* medium extinction coefficient */ |
| 69 |
> |
COLOR albedo; /* medium scattering albedo */ |
| 70 |
> |
short rflips; /* surface orientation has been reversed */ |
| 71 |
> |
short rlvl; /* number of reflections for this ray */ |
| 72 |
> |
short rtype; /* ray type */ |
| 73 |
> |
short crtype; /* cumulative ray type */ |
| 74 |
|
} RAY; |
| 75 |
|
|
| 76 |
< |
extern double raynormal(); |
| 76 |
> |
#define rayvalue(r) (*(r)->revf)(r) |
| 77 |
> |
|
| 78 |
> |
#define raydistance(r) (bright((r)->mcol) > 0.5*bright((r)->rcol) ? \ |
| 79 |
> |
(r)->rmt : (r)->rxt) |
| 80 |
> |
|
| 81 |
> |
#define rayreorient(r) if ((r)->rflips & 1) flipsurface(r); else |
| 82 |
> |
|
| 83 |
> |
extern char VersionID[]; /* Radiance version ID string */ |
| 84 |
> |
extern char RFeatureList[]; /* newline-separated feature list */ |
| 85 |
> |
|
| 86 |
> |
extern CUBE thescene; /* our scene */ |
| 87 |
> |
extern OBJECT nsceneobjs; /* number of objects in our scene */ |
| 88 |
> |
|
| 89 |
> |
extern RNUMBER raynum; /* next ray ID */ |
| 90 |
> |
extern RNUMBER nrays; /* total rays traced so far */ |
| 91 |
> |
|
| 92 |
> |
extern OBJREC Lamb; /* a Lambertian surface */ |
| 93 |
> |
extern OBJREC Aftplane; /* aft clipping object */ |
| 94 |
> |
|
| 95 |
> |
extern void (*trace)(RAY*); /* global trace reporting callback */ |
| 96 |
> |
|
| 97 |
> |
extern int dimlist[]; /* dimension list for distribution */ |
| 98 |
> |
extern int ndims; /* number of dimensions so far */ |
| 99 |
> |
extern int samplendx; /* index for this sample */ |
| 100 |
> |
|
| 101 |
> |
extern int do_irrad; /* compute irradiance? */ |
| 102 |
> |
|
| 103 |
> |
extern int rand_samp; /* pure Monte Carlo sampling? */ |
| 104 |
> |
|
| 105 |
> |
extern double dstrsrc; /* square source distribution */ |
| 106 |
> |
extern double shadthresh; /* shadow threshold */ |
| 107 |
> |
extern double shadcert; /* shadow testing certainty */ |
| 108 |
> |
extern int directrelay; /* number of source relays */ |
| 109 |
> |
extern int vspretest; /* virtual source pretest density */ |
| 110 |
> |
extern int directvis; /* light sources visible to eye? */ |
| 111 |
> |
extern double srcsizerat; /* maximum source size/dist. ratio */ |
| 112 |
> |
|
| 113 |
> |
extern double specthresh; /* specular sampling threshold */ |
| 114 |
> |
extern double specjitter; /* specular sampling jitter */ |
| 115 |
> |
|
| 116 |
> |
extern COLOR cextinction; /* global extinction coefficient */ |
| 117 |
> |
extern COLOR salbedo; /* global scattering albedo */ |
| 118 |
> |
extern double seccg; /* global scattering eccentricity */ |
| 119 |
> |
extern double ssampdist; /* scatter sampling distance */ |
| 120 |
> |
|
| 121 |
> |
extern int backvis; /* back face visibility */ |
| 122 |
> |
|
| 123 |
> |
extern int maxdepth; /* maximum recursion depth */ |
| 124 |
> |
extern double minweight; /* minimum ray weight */ |
| 125 |
> |
|
| 126 |
> |
extern char *ambfile; /* ambient file name */ |
| 127 |
> |
extern COLOR ambval; /* ambient value */ |
| 128 |
> |
extern int ambvwt; /* initial weight for ambient value */ |
| 129 |
> |
extern double ambacc; /* ambient accuracy */ |
| 130 |
> |
extern int ambres; /* ambient resolution */ |
| 131 |
> |
extern int ambdiv; /* ambient divisions */ |
| 132 |
> |
extern int ambssamp; /* ambient super-samples */ |
| 133 |
> |
extern int ambounce; /* ambient bounces */ |
| 134 |
> |
extern char *amblist[]; /* ambient include/exclude list */ |
| 135 |
> |
extern int ambincl; /* include == 1, exclude == 0 */ |
| 136 |
> |
|
| 137 |
> |
extern int ray_pnprocs; /* number of child processes */ |
| 138 |
> |
extern int ray_pnidle; /* number of idle processes */ |
| 139 |
> |
|
| 140 |
> |
#ifndef AMBLLEN |
| 141 |
> |
#define AMBLLEN 512 /* max. ambient list length */ |
| 142 |
> |
#endif |
| 143 |
> |
#define AMBWORD 12 /* average word length */ |
| 144 |
> |
|
| 145 |
> |
typedef struct { /* rendering parameter holder */ |
| 146 |
> |
int do_irrad; |
| 147 |
> |
int rand_samp; |
| 148 |
> |
double dstrsrc; |
| 149 |
> |
double shadthresh; |
| 150 |
> |
double shadcert; |
| 151 |
> |
int directrelay; |
| 152 |
> |
int vspretest; |
| 153 |
> |
int directvis; |
| 154 |
> |
double srcsizerat; |
| 155 |
> |
COLOR cextinction; |
| 156 |
> |
COLOR salbedo; |
| 157 |
> |
double seccg; |
| 158 |
> |
double ssampdist; |
| 159 |
> |
double specthresh; |
| 160 |
> |
double specjitter; |
| 161 |
> |
int backvis; |
| 162 |
> |
int maxdepth; |
| 163 |
> |
double minweight; |
| 164 |
> |
char ambfile[512]; |
| 165 |
> |
COLOR ambval; |
| 166 |
> |
int ambvwt; |
| 167 |
> |
double ambacc; |
| 168 |
> |
int ambres; |
| 169 |
> |
int ambdiv; |
| 170 |
> |
int ambssamp; |
| 171 |
> |
int ambounce; |
| 172 |
> |
int ambincl; |
| 173 |
> |
short amblndx[AMBLLEN+1]; |
| 174 |
> |
char amblval[AMBLLEN*AMBWORD]; |
| 175 |
> |
|
| 176 |
> |
/* PMAP: photon mapping parameters */ |
| 177 |
> |
PhotonMapParams pmapParams [NUM_PMAP_TYPES]; |
| 178 |
> |
} RAYPARAMS; |
| 179 |
> |
|
| 180 |
> |
#define rpambmod(p,i) ( (i)>=AMBLLEN||(p)->amblndx[i]<0 ? \ |
| 181 |
> |
(char *)NULL : (p)->amblval+(p)->amblndx[i] ) |
| 182 |
> |
|
| 183 |
> |
/* defined in duphead.c */ |
| 184 |
> |
extern void headclean(void); |
| 185 |
> |
extern void openheader(void); |
| 186 |
> |
extern void dupheader(void); |
| 187 |
> |
/* defined in persist.c */ |
| 188 |
> |
extern void persistfile(char *pfn); |
| 189 |
> |
extern void pfdetach(void); |
| 190 |
> |
extern void pfclean(void); |
| 191 |
> |
extern void pflock(int lf); |
| 192 |
> |
extern void pfhold(void); |
| 193 |
> |
extern void io_process(void); |
| 194 |
> |
/* defined in freeobjmem.c */ |
| 195 |
> |
extern int free_objs(OBJECT on, OBJECT no); |
| 196 |
> |
extern void free_objmem(void); |
| 197 |
> |
/* defined in preload.c */ |
| 198 |
> |
extern int load_os(OBJREC *op); |
| 199 |
> |
extern void preload_objs(void); |
| 200 |
> |
/* defined in raycalls.c */ |
| 201 |
> |
extern void ray_init(char *otnm); |
| 202 |
> |
extern void ray_trace(RAY *r); |
| 203 |
> |
extern void ray_done(int freall); |
| 204 |
> |
extern void ray_save(RAYPARAMS *rp); |
| 205 |
> |
extern void ray_restore(RAYPARAMS *rp); |
| 206 |
> |
extern void ray_defaults(RAYPARAMS *rp); |
| 207 |
> |
/* defined in raypcalls.c */ |
| 208 |
> |
extern void ray_pinit(char *otnm, int nproc); |
| 209 |
> |
extern int ray_psend(RAY *r); |
| 210 |
> |
extern int ray_pqueue(RAY *r); |
| 211 |
> |
extern int ray_presult(RAY *r, int poll); |
| 212 |
> |
extern void ray_pdone(int freall); |
| 213 |
> |
extern void ray_popen(int nadd); |
| 214 |
> |
extern void ray_pclose(int nsub); |
| 215 |
> |
/* defined in ray_fifo.c */ |
| 216 |
> |
extern int (*ray_fifo_out)(RAY *r); |
| 217 |
> |
extern int ray_fifo_in(RAY *r); |
| 218 |
> |
extern int ray_fifo_flush(void); |
| 219 |
> |
/* defined in raytrace.c */ |
| 220 |
> |
extern int rayorigin(RAY *r, int rt, const RAY *ro, const COLOR rc); |
| 221 |
> |
extern void rayclear(RAY *r); |
| 222 |
> |
extern void raytrace(RAY *r); |
| 223 |
> |
extern int rayreject(OBJREC *o, RAY *r, double t); |
| 224 |
> |
extern void rayhit(OBJECT *oset, RAY *r); |
| 225 |
> |
extern void raycont(RAY *r); |
| 226 |
> |
extern void raytrans(RAY *r); |
| 227 |
> |
extern int raytirrad(OBJREC *m, RAY *r); |
| 228 |
> |
extern int rayshade(RAY *r, int mod); |
| 229 |
> |
extern void rayparticipate(RAY *r); |
| 230 |
> |
extern void raytexture(RAY *r, OBJECT mod); |
| 231 |
> |
extern int raymixture(RAY *r, OBJECT fore, OBJECT back, double coef); |
| 232 |
> |
extern void raycontrib(RREAL rc[3], const RAY *r, int flags); |
| 233 |
> |
extern double raydist(const RAY *r, int flags); |
| 234 |
> |
extern double raynormal(FVECT norm, RAY *r); |
| 235 |
> |
extern void newrayxf(RAY *r); |
| 236 |
> |
extern void flipsurface(RAY *r); |
| 237 |
> |
extern int localhit(RAY *r, CUBE *scene); |
| 238 |
> |
/* defined in renderopts.c */ |
| 239 |
> |
extern int feature_status(int ac, char *av[]); |
| 240 |
> |
extern int getrenderopt(int ac, char *av[]); |
| 241 |
> |
extern void print_rdefaults(void); |
| 242 |
> |
/* defined in srcdraw.c */ |
| 243 |
> |
extern void drawsources(COLOR *pic[], float *zbf[], |
| 244 |
> |
int x0, int xsiz, int y0, int ysiz); |
| 245 |
> |
extern void init_drawsources(int rad); |
| 246 |
> |
/* defined in rt/initotypes.c */ |
| 247 |
> |
extern void initotypes(void); |
| 248 |
> |
/* module main procedures */ |
| 249 |
> |
extern void rtrace(char *fname, int nproc); |
| 250 |
> |
extern const char *formstr(int f); |
| 251 |
> |
extern void rview(void); |
| 252 |
> |
extern void rpict(int seq, char *pout, char *zout, char *prvr); |
| 253 |
> |
|
| 254 |
> |
#ifdef __FAST_MATH__ |
| 255 |
> |
#define checknorm(vn) (void)normalize(vn) |
| 256 |
> |
#else |
| 257 |
> |
#define checknorm(vn) |
| 258 |
> |
#endif |
| 259 |
> |
|
| 260 |
> |
#ifdef __cplusplus |
| 261 |
> |
} |
| 262 |
> |
#endif |
| 263 |
> |
#endif /* _RAD_RAY_H_ */ |
| 264 |
> |
|
