src/rt/source.h

/* Copyright (c) 1986 Regents of the University of California */

/* SCCSid "$SunId$ LBL" */

/*
 *  source.h - header file for ray tracing sources.
 *
 *     8/20/85
 */

#define  AIMREQT        100             /* required aim success/failure */

#define  SDISTANT       01              /* source distant flag */
#define  SSKIP          02              /* source skip flag */
#define  SPROX          04              /* source proximity flag */
#define  SSPOT          010             /* source spotlight flag */
#define  SVIRTUAL       020             /* source virtual flag */
#define  SFLAT          040             /* source flat flag */
#define  SFOLLOW        0100            /* source follow path flag */

typedef struct {
        FVECT  aim;             /* aim direction or center */
        float  siz;             /* output solid angle or area */
        float  flen;            /* focal length */
} SPOT;                 /* spotlight */

typedef struct {
        int  sflags;            /* source flags */
        FVECT  sloc;            /* direction or position of source */
        FVECT  snorm;           /* surface normal of flat source */
        float  ss;              /* tangent or disk radius */
        float  ss2;             /* domega or projected area */
        struct {
                float  prox;            /* proximity */
                SPOT  *s;               /* spot */
        } sl;                   /* localized source information */
        union {
                int  success;           /* successes - AIMREQT*failures */
                int  svnext;            /* next source to aim for */
        } sa;                   /* source aiming information */
        long  ntests, nhits;    /* shadow tests and hits */
        OBJREC  *so;            /* source destination object */
}  SRCREC;              /* light source */

/*
 * Special support functions for sources
 */

/*
 * Virtual source materials must define the following.
 *
 *      vproj(pm, op, sp, i)    Compute i'th virtual projection
 *                              of source sp in object op and assign
 *                              the 4x4 transformation matrix pm.
 *                              Return 1 on success, 0 if no i'th projection.
 *
 *      nproj                   The number of projections.  The value of
 *                              i passed to vproj runs from 0 to nproj-1.
 */

typedef struct {
        int  (*vproj)();        /* project virtual sources */
        int  nproj;             /* number of possible projections */
} VSMATERIAL;           /* virtual source material functions */

typedef struct {
        int     (*setsrc)();    /* set light source for object */
        double  (*getpleq)();   /* plane equation for surface */
        double  (*getdisk)();   /* maximum disk for surface */
} SOBJECT;              /* source object functions */

typedef union {
        VSMATERIAL  *mf;        /* material functions */
        SOBJECT  *of;           /* object functions */
} SRCFUNC;              /* source functions */

extern SRCFUNC  sfun[];                 /* source dispatch table */

extern SRCREC  *source;                 /* our source list */
extern int  nsources;                   /* the number of sources */

extern double  srcray();                /* ray to source */
extern int  srcvalue();                 /* compute source value w/o shadows */

extern double  intercircle();           /* intersect two circles */

extern SPOT  *makespot();               /* make spotlight */

extern double  dstrsrc;                 /* source distribution amount */
extern double  shadthresh;              /* relative shadow threshold */
extern double  shadcert;                /* shadow testing certainty */
extern int  directrelay;                /* maximum number of source relays */
extern int  vspretest;                  /* virtual source pretest density */
Revision:	1.10
Committed:	Mon Jun 24 16:10:57 1991 UTC (34 years, 4 months ago) by greg
Content type:	text/plain
Branch:	MAIN
Changes since 1.9:	+5 -1 lines
Log Message:	added virtual source visibility pretesting
#	User	Rev	Content
1	greg	1.1	/* Copyright (c) 1986 Regents of the University of California */
2
3			/* SCCSid "$SunId$ LBL" */
4
5			/*
6			* source.h - header file for ray tracing sources.
7			*
8			* 8/20/85
9			*/
10
11	greg	1.6	#define AIMREQT 100 /* required aim success/failure */
12
13	greg	1.1	#define SDISTANT 01 /* source distant flag */
14			#define SSKIP 02 /* source skip flag */
15	greg	1.3	#define SPROX 04 /* source proximity flag */
16			#define SSPOT 010 /* source spotlight flag */
17	greg	1.6	#define SVIRTUAL 020 /* source virtual flag */
18			#define SFLAT 040 /* source flat flag */
19			#define SFOLLOW 0100 /* source follow path flag */
20	greg	1.1
21			typedef struct {
22	greg	1.6	FVECT aim; /* aim direction or center */
23			float siz; /* output solid angle or area */
24	greg	1.3	float flen; /* focal length */
25			} SPOT; /* spotlight */
26
27			typedef struct {
28	greg	1.6	int sflags; /* source flags */
29	greg	1.1	FVECT sloc; /* direction or position of source */
30	greg	1.6	FVECT snorm; /* surface normal of flat source */
31	greg	1.1	float ss; /* tangent or disk radius */
32			float ss2; /* domega or projected area */
33	greg	1.6	struct {
34	greg	1.3	float prox; /* proximity */
35			SPOT s; / spot */
36			} sl; /* localized source information */
37	greg	1.6	union {
38			int success; /* successes - AIMREQTfailures /
39			int svnext; /* next source to aim for */
40			} sa; /* source aiming information */
41	greg	1.2	long ntests, nhits; /* shadow tests and hits */
42	greg	1.6	OBJREC so; / source destination object */
43	greg	1.2	} SRCREC; /* light source */
44	greg	1.1
45	greg	1.8	/*
46			* Special support functions for sources
47			*/
48
49			/*
50	greg	1.10	* Virtual source materials must define the following.
51	greg	1.8	*
52			* vproj(pm, op, sp, i) Compute i'th virtual projection
53			* of source sp in object op and assign
54			* the 4x4 transformation matrix pm.
55			* Return 1 on success, 0 if no i'th projection.
56			*
57			* nproj The number of projections. The value of
58			* i passed to vproj runs from 0 to nproj-1.
59			*/
60
61	greg	1.2	typedef struct {
62	greg	1.8	int (vproj)(); / project virtual sources */
63			int nproj; /* number of possible projections */
64			} VSMATERIAL; /* virtual source material functions */
65	greg	1.4
66			typedef struct {
67	greg	1.8	int (setsrc)(); / set light source for object */
68			double (getpleq)(); / plane equation for surface */
69			double (getdisk)(); / maximum disk for surface */
70			} SOBJECT; /* source object functions */
71	greg	1.1
72	greg	1.8	typedef union {
73			VSMATERIAL mf; / material functions */
74			SOBJECT of; / object functions */
75			} SRCFUNC; /* source functions */
76
77			extern SRCFUNC sfun[]; /* source dispatch table */
78
79	greg	1.2	extern SRCREC source; / our source list */
80	greg	1.1	extern int nsources; /* the number of sources */
81
82	greg	1.2	extern double srcray(); /* ray to source */
83	greg	1.10	extern int srcvalue(); /* compute source value w/o shadows */
84	greg	1.3
85	greg	1.10	extern double intercircle(); /* intersect two circles */
86
87	greg	1.3	extern SPOT makespot(); / make spotlight */
88	greg	1.6
89	greg	1.8	extern double dstrsrc; /* source distribution amount */
90			extern double shadthresh; /* relative shadow threshold */
91			extern double shadcert; /* shadow testing certainty */
92			extern int directrelay; /* maximum number of source relays */
93	greg	1.10	extern int vspretest; /* virtual source pretest density */