src/hd/rhd_sample.h

/* RCSid: $Id$ */
/*
 * Sample data structures for holodeck display drivers.
 */
#include "color.h"
#include "tonemap.h"
#include "rhdriver.h"
#include "object.h"

#ifndef int2
#define int2    short
#endif
#ifndef int4
#define int4    int
#endif

#ifndef INVALID
#define INVALID  -1
#endif

#define SFLOAT float

typedef OBJECT S_ID;

#define S_ID_MAX  ((1 << ((sizeof(S_ID)<<3)-1))-1)

typedef struct samp {
        SFLOAT          (*wp)[3];       /* world intersection point array */
        int4            *wd;            /* world direction array */
        TMbright        *brt;           /* encoded brightness array */
        BYTE            (*chr)[3];      /* encoded chrominance array */
        BYTE            (*rgb)[3];      /* tone-mapped color array */
        int             *info;          /* Extra sample info */
        int             *info1;         /* Extra sample info */
        int             max_samp;       /* maximum number of samples */
        int             max_base_pt;    /* maximum number of aux points */
        S_ID            next_base_pt;   /* next auxilliary point to add */
        S_ID            replace_samp;   /* next sample to free  */
        int             num_samp;       /* current number of samples */
        S_ID             tone_map;      /* pointer to next value(s)t tonemap*/
        S_ID             free_samp;     /* next free sample */
        char            *base;          /* base of allocated memory */
} SAMP;

/* Sample field access macros */
#define S_W_PT(s)               ((s)->wp)
#define S_W_DIR(s)              ((s)->wd)
#define S_BRT(s)                ((s)->brt)
#define S_CHR(s)                ((s)->chr)
#define S_RGB(s)                ((s)->rgb)
#define S_INFO(s)               ((s)->info)
#define S_INFO1(s)              ((s)->info1)
#define S_MAX_SAMP(s)           ((s)->max_samp)
#define S_MAX_BASE_PT(s)        ((s)->max_base_pt)
#define S_NEXT_BASE_PT(s)       ((s)->next_base_pt)
#define S_REPLACE_SAMP(s)       ((s)->replace_samp)
#define S_NUM_SAMP(s)           ((s)->num_samp)
#define S_TONE_MAP(s)           ((s)->tone_map)
#define S_FREE_SAMP(s)          ((s)->free_samp)
#define S_BASE(s)               ((s)->base)

#define S_MAX_POINTS(s)         ((s)->max_base_pt)
#define S_NTH_W_PT(s,n)         (S_W_PT(s)[(n)])
#define S_NTH_W_DIR(s,n)        (S_W_DIR(s)[(n)])
#define S_NTH_RGB(s,n)          (S_RGB(s)[(n)])
#define S_NTH_CHR(s,n)          (S_CHR(s)[(n)])
#define S_NTH_INFO(s,n)         (S_INFO(s)[(n)])
#define S_NTH_INFO1(s,n)        (S_INFO1(s)[(n)])
#define S_NTH_BRT(s,n)          (S_BRT(s)[(n)])

/* Sample Flag macros */
#define S_IS_FLAG(s)            IS_FLAG(samp_flag,s)
#define S_SET_FLAG(s)           SET_FLAG(samp_flag,s)
#define S_CLR_FLAG(s)           CLR_FLAG(samp_flag,s)

#define S_NTH_NEXT(s,n)         S_NTH_W_DIR(s,n)
#define sUnalloc_samp(s,n) (S_NTH_NEXT(s,n)=S_FREE_SAMP(s),S_FREE_SAMP(s)=n)
#define sClear_base_points(s)  (S_NEXT_BASE_PT(s) = S_MAX_SAMP(s))
#define sClear(s)      sInit(s)
/* MAXDIFF2 Max allowed cos angle squared of sample dir from current view */
/* In terms of cos: if angle is 30: MAXDIFF2 = cos(30)^2, if difference
  is greater than this point not accepted on rebuild
  */
#define MAXDIFF2        0.75
/* Max difference in direction for points at infinity: if over 45degrees
  not accepted on rebuild cos(45)
  */
#define MAXDIR           0.70710678        
#define MAXQUALITY      10000   /* Maximum quality for rendering rep */

extern  SAMP rsL;                       
extern double   sDepthEps;      /* epsilon to compare depths (z fraction) */
extern int4     encodedir();    /* Encodes FVECT direction */
extern void     decodedir();    /* Decodes dir-> FVECT */
extern double   fdir2diff(), dir2diff(); /* Compare dir and FVECT */
extern int4    *samp_flag;     /* Per/sample flags s */

/* These values are set by the driver, and used in the OGL call for glFrustum*/
extern double dev_zmin,dev_zmax;
extern S_ID sAdd_base_point();
extern SAMP *sAlloc();
extern S_ID sAlloc_samp();
/*
 * int
 * smInit(n)            : Initialize/clear data structures for n entries
 * int  n;
 *
 * Initialize sampL and other data structures for at least n samples.
 * If n is 0, then free data structures.  Return number actually allocated.
 *
 *
 * int
 * smNewSamp(c, p, v)   : register new sample point and return index
 * COLR c;              : pixel color (RGBE)
 * FVECT        p;      : world intersection point
 * FVECT        v;      : ray direction vector
 *
 * Add new sample point to data structures, removing old values as necessary.
 * New sample representation will be output in next call to smUpdate().
 *
 *
 * int
 * smFindSamp(orig, dir): intersect ray with 3D rep. and find closest sample
 * FVECT        orig, dir;
 *
 * Find the closest sample to the given ray.  Return -1 on failure.
 *
 *
 * smClean()            : display has been wiped clean
 *
 * Called after display has been effectively cleared, meaning that all
 * geometry must be resent down the pipeline in the next call to smUpdate().
 *
 *
 * smUpdate(vp, qua)    : update OpenGL output geometry for view vp
 * VIEW *vp;            : desired view
 * int  qua;            : quality level (percentage on linear time scale)
 *
 * Draw new geometric representation using OpenGL calls.  Assume that the
 * view has already been set up and the correct frame buffer has been
 * selected for drawing.  The quality level is on a linear scale, where 100%
 * is full (final) quality.  It is not necessary to redraw geometry that has
 * been output since the last call to smClean().  (The last view drawn will
 * be vp==&odev.v each time.)
 */


Revision:	3.8
Committed:	Sat Feb 22 02:07:24 2003 UTC (22 years, 8 months ago) by greg
Content type:	text/plain
Branch:	MAIN
CVS Tags:	rad3R5
Changes since 3.7:	+59 -18 lines
Log Message:	Changes and check-in for 3.5 release Includes new source files and modifications not recorded for many years See ray/doc/notes/ReleaseNotes for notes between 3.1 and 3.5 release
#	User	Rev	Content
1	greg	3.8	/* RCSid: $Id$ */
2	gwlarson	3.1	/*
3			* Sample data structures for holodeck display drivers.
4			*/
5			#include "color.h"
6			#include "tonemap.h"
7			#include "rhdriver.h"
8	greg	3.8	#include "object.h"
9	gwlarson	3.1
10			#ifndef int2
11			#define int2 short
12			#endif
13			#ifndef int4
14			#define int4 int
15			#endif
16	gwlarson	3.3
17			#ifndef INVALID
18			#define INVALID -1
19			#endif
20
21	simmons	3.7	#define SFLOAT float
22	greg	3.8
23			typedef OBJECT S_ID;
24
25			#define S_ID_MAX ((1 << ((sizeof(S_ID)<<3)-1))-1)
26	gwlarson	3.6
27	gwlarson	3.3	typedef struct samp {
28	simmons	3.7	SFLOAT (wp)[3]; / world intersection point array */
29	gwlarson	3.1	int4 wd; / world direction array */
30			TMbright brt; / encoded brightness array */
31			BYTE (chr)[3]; / encoded chrominance array */
32			BYTE (rgb)[3]; / tone-mapped color array */
33	gwlarson	3.6	int info; / Extra sample info */
34	greg	3.8	int info1; / Extra sample info */
35	gwlarson	3.1	int max_samp; /* maximum number of samples */
36	greg	3.8	int max_base_pt; /* maximum number of aux points */
37			S_ID next_base_pt; /* next auxilliary point to add */
38			S_ID replace_samp; /* next sample to free */
39	gwlarson	3.3	int num_samp; /* current number of samples */
40	greg	3.8	S_ID tone_map; /* pointer to next value(s)t tonemap*/
41			S_ID free_samp; /* next free sample */
42	gwlarson	3.1	char base; / base of allocated memory */
43	gwlarson	3.3	} SAMP;
44	gwlarson	3.1
45	gwlarson	3.3	/* Sample field access macros */
46			#define S_W_PT(s) ((s)->wp)
47			#define S_W_DIR(s) ((s)->wd)
48			#define S_BRT(s) ((s)->brt)
49			#define S_CHR(s) ((s)->chr)
50			#define S_RGB(s) ((s)->rgb)
51	gwlarson	3.6	#define S_INFO(s) ((s)->info)
52	greg	3.8	#define S_INFO1(s) ((s)->info1)
53	gwlarson	3.3	#define S_MAX_SAMP(s) ((s)->max_samp)
54			#define S_MAX_BASE_PT(s) ((s)->max_base_pt)
55			#define S_NEXT_BASE_PT(s) ((s)->next_base_pt)
56			#define S_REPLACE_SAMP(s) ((s)->replace_samp)
57			#define S_NUM_SAMP(s) ((s)->num_samp)
58			#define S_TONE_MAP(s) ((s)->tone_map)
59	gwlarson	3.6	#define S_FREE_SAMP(s) ((s)->free_samp)
60	gwlarson	3.3	#define S_BASE(s) ((s)->base)
61	gwlarson	3.1
62	gwlarson	3.3	#define S_MAX_POINTS(s) ((s)->max_base_pt)
63			#define S_NTH_W_PT(s,n) (S_W_PT(s)[(n)])
64			#define S_NTH_W_DIR(s,n) (S_W_DIR(s)[(n)])
65			#define S_NTH_RGB(s,n) (S_RGB(s)[(n)])
66			#define S_NTH_CHR(s,n) (S_CHR(s)[(n)])
67	gwlarson	3.6	#define S_NTH_INFO(s,n) (S_INFO(s)[(n)])
68	greg	3.8	#define S_NTH_INFO1(s,n) (S_INFO1(s)[(n)])
69	gwlarson	3.3	#define S_NTH_BRT(s,n) (S_BRT(s)[(n)])
70	gwlarson	3.6
71	gwlarson	3.3	/* Sample Flag macros */
72			#define S_IS_FLAG(s) IS_FLAG(samp_flag,s)
73			#define S_SET_FLAG(s) SET_FLAG(samp_flag,s)
74			#define S_CLR_FLAG(s) CLR_FLAG(samp_flag,s)
75	gwlarson	3.1
76	gwlarson	3.4	#define S_NTH_NEXT(s,n) S_NTH_W_DIR(s,n)
77	gwlarson	3.6	#define sUnalloc_samp(s,n) (S_NTH_NEXT(s,n)=S_FREE_SAMP(s),S_FREE_SAMP(s)=n)
78	gwlarson	3.3	#define sClear_base_points(s) (S_NEXT_BASE_PT(s) = S_MAX_SAMP(s))
79			#define sClear(s) sInit(s)
80	gwlarson	3.6	/* MAXDIFF2 Max allowed cos angle squared of sample dir from current view */
81			/* In terms of cos: if angle is 30: MAXDIFF2 = cos(30)^2, if difference
82			is greater than this point not accepted on rebuild
83			*/
84			#define MAXDIFF2 0.75
85			/* Max difference in direction for points at infinity: if over 45degrees
86			not accepted on rebuild cos(45)
87			*/
88			#define MAXDIR 0.70710678
89	gwlarson	3.5	#define MAXQUALITY 10000 /* Maximum quality for rendering rep */
90	gwlarson	3.1
91	gwlarson	3.3	extern SAMP rsL;
92			extern double sDepthEps; /* epsilon to compare depths (z fraction) */
93			extern int4 encodedir(); /* Encodes FVECT direction */
94			extern void decodedir(); /* Decodes dir-> FVECT */
95			extern double fdir2diff(), dir2diff(); /* Compare dir and FVECT */
96			extern int4 samp_flag; / Per/sample flags s */
97
98	gwlarson	3.1	/* These values are set by the driver, and used in the OGL call for glFrustum*/
99			extern double dev_zmin,dev_zmax;
100	greg	3.8	extern S_ID sAdd_base_point();
101	gwlarson	3.3	extern SAMP *sAlloc();
102	greg	3.8	extern S_ID sAlloc_samp();
103			/*
104			* int
105			* smInit(n) : Initialize/clear data structures for n entries
106			* int n;
107			*
108			* Initialize sampL and other data structures for at least n samples.
109			* If n is 0, then free data structures. Return number actually allocated.
110			*
111			*
112			* int
113			* smNewSamp(c, p, v) : register new sample point and return index
114			* COLR c; : pixel color (RGBE)
115			* FVECT p; : world intersection point
116			* FVECT v; : ray direction vector
117			*
118			* Add new sample point to data structures, removing old values as necessary.
119			* New sample representation will be output in next call to smUpdate().
120			*
121			*
122			* int
123			* smFindSamp(orig, dir): intersect ray with 3D rep. and find closest sample
124			* FVECT orig, dir;
125			*
126			* Find the closest sample to the given ray. Return -1 on failure.
127			*
128			*
129			* smClean() : display has been wiped clean
130			*
131			* Called after display has been effectively cleared, meaning that all
132			* geometry must be resent down the pipeline in the next call to smUpdate().
133			*
134			*
135			* smUpdate(vp, qua) : update OpenGL output geometry for view vp
136			* VIEW *vp; : desired view
137			* int qua; : quality level (percentage on linear time scale)
138			*
139			* Draw new geometric representation using OpenGL calls. Assume that the
140			* view has already been set up and the correct frame buffer has been
141			* selected for drawing. The quality level is on a linear scale, where 100%
142			* is full (final) quality. It is not necessary to redraw geometry that has
143			* been output since the last call to smClean(). (The last view drawn will
144			* be vp==&odev.v each time.)
145			*/
146	gwlarson	3.1
147
148
149
150
151