src/hd/holo.h

/* Copyright (c) 1997 Silicon Graphics, Inc. */

/* SCCSid "$SunId$ SGI" */

/*
 * Header file for holodeck programs
 *
 *      9/29/97 GWLarson
 */

#include "standard.h"
#include "color.h"

#ifndef HDMAX
#define HDMAX           128     /* maximum active holodeck sections */
#endif
#ifndef int2
#define int2    short
#endif
#ifndef int4
#define int4    int
#endif

#define DCINF   (unsigned)((1L<<16)-1)  /* special value for infinity */
#define DCLIN   (unsigned)(1L<<11)      /* linear depth limit */

typedef struct {
        BYTE    r[2][2];        /* ray direction index */
        COLR    v;              /* value */
        unsigned int2   d;      /* depth code */
} RAYVAL;               /* ray value (from second wall) */

/*
 * Walls are ordered:           X0      X1      X2      WN
 *                              0       ?       ?       0
 *                              1       ?       ?       1
 *                              ?       0       ?       2
 *                              ?       1       ?       3
 *                              ?       ?       0       4
 *                              ?       ?       1       5
 *
 * Grid on wall WN corresponds to X(WN/2+1)%3 and X(WN/2+2)%3, resp.
 */

typedef struct {
        short   w;              /* wall number */
        short   i[2];           /* index on wall grid */
} GCOORD;               /* grid coordinates (two for beam) */

typedef struct {
        unsigned int4   nrd;    /* number of beam rays bundled on disk */
        long    fo;             /* position in file */
} BEAMI;                /* beam index */

typedef struct {
        unsigned int4   nrm;    /* number of beam rays bundled in memory */
        unsigned long   tick;   /* clock tick for LRU replacement */
} BEAM;                 /* followed by nrm RAYVAL's */

#define hdbray(bp)      ((RAYVAL *)((bp)+1))
#define hdbsiz(nr)      (sizeof(BEAM)+(nr)*sizeof(RAYVAL))

typedef struct {
        FVECT   orig;           /* prism origin (first) */
        FVECT   xv[3];          /* side vectors (second) */
        int2    grid[3];        /* grid resolution (third) */
} HDGRID;               /* holodeck section grid (must match HOLO struct) */

typedef struct holo {
        FVECT   orig;           /* prism origin (first) */
        FVECT   xv[3];          /* side vectors (second) */
        int2    grid[3];        /* grid resolution (third) */
        int     fd;             /* file descriptor */
        short   dirty;          /* beam index needs update to file */
        double  tlin;           /* linear range for depth encoding */
        FVECT   wg[3];          /* wall grid vectors (derived) */
        double  wo[6];          /* wall grid offsets (derived) */
        int     wi[6];          /* wall super-indices (derived) */
        char    *priv;          /* pointer to private client data */
        BEAM    **bl;           /* beam pointers (memory cache) */
        BEAMI   bi[1];          /* beam index (extends struct) */
} HOLO;                 /* holodeck section */

typedef struct {
        HOLO    *h;             /* pointer to holodeck */
        int     b;              /* beam index */
} HDBEAMI;              /* holodeck beam index */

#define nbeams(hp)      (((hp)->wi[5]-1)<<1)
#define biglob(hp)      ((hp)->bi)
#define blglob(hp)      (*(hp)->bl)

#define bnrays(hp,i)    ((hp)->bl[i]!=NULL ? (hp)->bl[i]->nrm : (hp)->bi[i].nrd)

#define hdflush(hp)     (hdfreebeam(hp,0) && hdsync(hp,0))
#define hdclobber(hp)   (hdkillbeam(hp,0) && hdsync(hp,0))

extern HOLO     *hdinit(), *hdalloc();
extern BEAM     *hdgetbeam();
extern RAYVAL   *hdnewrays();
extern unsigned hdmemuse();
extern long     hdfiluse(), hdfilen(), hdallocfrag();
extern double   hdray(), hdinter();
extern unsigned hdcode();
extern int      hdfilord();

extern unsigned hdcachesize;            /* target cache size (bytes) */
extern unsigned long    hdclock;        /* holodeck system clock */
extern HOLO     *hdlist[HDMAX+1];       /* holodeck pointers (NULL term.) */

extern float    hd_depthmap[];          /* depth conversion map */

extern int      hdwg0[6];               /* wall grid 0 index */
extern int      hdwg1[6];               /* wall grid 1 index */

#define hddepth(hp,dc)  ( (dc) >= DCINF ? FHUGE : \
                                (hp)->tlin * ( (dc) >= DCLIN ? \
                                        hd_depthmap[(dc)-DCLIN] : \
                                        ((dc)+.5)/DCLIN ) )

#define HOLOFMT         "Holodeck"      /* file format identifier */
#define HOLOVERS        0               /* file format version number */
#define HOLOMAGIC       (323+sizeof(long)+8*HOLOVERS)   /* file magic number */

/*
 * A holodeck file consists of an information header terminated by a
 * blank line, with "FORMAT=Holodeck" somewhere in it.
 * The first integer after the information header is the
 * above magic number, which includes the file format version number.
 * The first longword after the magic number is a pointer to the pointer
 * just before the SECOND holodeck section, or 0 if there is only one.
 * This longword is immediately followed by the first holodeck
 * section header and directory.
 * Similarly, every holodeck section in the file is preceeded by
 * a pointer to the following section, or 0 for the final section.
 * Since holodeck files consist of directly written C data structures, 
 * they are not generally portable between different machine architectures.
 * In particular, different floating point formats or bit/byte ordering
 * will make the data unusable.  This is unfortunate, and may be changed
 * in future versions, but we thought this would be best for paging speed
 * in our initial implementation.
 */
Revision:	3.14
Committed:	Wed Jan 7 21:27:29 1998 UTC (27 years, 10 months ago) by gregl
Content type:	text/plain
Branch:	MAIN
Changes since 3.13:	+2 -1 lines
Log Message:	added declaration of hdfilord()
#	User	Rev	Content
1	gregl	3.1	/* Copyright (c) 1997 Silicon Graphics, Inc. */
2
3			/* SCCSid "$SunId$ SGI" */
4
5			/*
6			* Header file for holodeck programs
7			*
8			* 9/29/97 GWLarson
9			*/
10
11			#include "standard.h"
12			#include "color.h"
13
14			#ifndef HDMAX
15			#define HDMAX 128 /* maximum active holodeck sections */
16			#endif
17			#ifndef int2
18			#define int2 short
19			#endif
20			#ifndef int4
21	gregl	3.10	#define int4 int
22	gregl	3.1	#endif
23
24			#define DCINF (unsigned)((1L<<16)-1) /* special value for infinity */
25			#define DCLIN (unsigned)(1L<<11) /* linear depth limit */
26
27			typedef struct {
28			BYTE r[2][2]; /* ray direction index */
29			COLR v; /* value */
30			unsigned int2 d; /* depth code */
31			} RAYVAL; /* ray value (from second wall) */
32
33			/*
34			* Walls are ordered: X0 X1 X2 WN
35			* 0 ? ? 0
36			* 1 ? ? 1
37			* ? 0 ? 2
38			* ? 1 ? 3
39			* ? ? 0 4
40			* ? ? 1 5
41			*
42			* Grid on wall WN corresponds to X(WN/2+1)%3 and X(WN/2+2)%3, resp.
43			*/
44
45			typedef struct {
46			short w; /* wall number */
47			short i[2]; /* index on wall grid */
48	gregl	3.2	} GCOORD; /* grid coordinates (two for beam) */
49	gregl	3.1
50			typedef struct {
51			unsigned int4 nrd; /* number of beam rays bundled on disk */
52			long fo; /* position in file */
53			} BEAMI; /* beam index */
54
55			typedef struct {
56			unsigned int4 nrm; /* number of beam rays bundled in memory */
57			unsigned long tick; /* clock tick for LRU replacement */
58			} BEAM; /* followed by nrm RAYVAL's */
59
60	gregl	3.3	#define hdbray(bp) ((RAYVAL *)((bp)+1))
61	gregl	3.1	#define hdbsiz(nr) (sizeof(BEAM)+(nr)*sizeof(RAYVAL))
62
63			typedef struct {
64			FVECT orig; /* prism origin (first) */
65			FVECT xv[3]; /* side vectors (second) */
66			int2 grid[3]; /* grid resolution (third) */
67			} HDGRID; /* holodeck section grid (must match HOLO struct) */
68
69			typedef struct holo {
70			FVECT orig; /* prism origin (first) */
71			FVECT xv[3]; /* side vectors (second) */
72			int2 grid[3]; /* grid resolution (third) */
73			int fd; /* file descriptor */
74			short dirty; /* beam index needs update to file */
75			double tlin; /* linear range for depth encoding */
76	gregl	3.13	FVECT wg[3]; /* wall grid vectors (derived) */
77			double wo[6]; /* wall grid offsets (derived) */
78	gregl	3.1	int wi[6]; /* wall super-indices (derived) */
79			char priv; / pointer to private client data */
80			BEAM *bl; / beam pointers (memory cache) */
81			BEAMI bi[1]; /* beam index (extends struct) */
82			} HOLO; /* holodeck section */
83
84	gregl	3.9	typedef struct {
85			HOLO h; / pointer to holodeck */
86			int b; /* beam index */
87			} HDBEAMI; /* holodeck beam index */
88
89	gregl	3.14	#define nbeams(hp) (((hp)->wi[5]-1)<<1)
90	gregl	3.1	#define biglob(hp) ((hp)->bi)
91			#define blglob(hp) (*(hp)->bl)
92
93			#define bnrays(hp,i) ((hp)->bl[i]!=NULL ? (hp)->bl[i]->nrm : (hp)->bi[i].nrd)
94
95	gregl	3.7	#define hdflush(hp) (hdfreebeam(hp,0) && hdsync(hp,0))
96			#define hdclobber(hp) (hdkillbeam(hp,0) && hdsync(hp,0))
97	gregl	3.1
98	gregl	3.4	extern HOLO hdinit(), hdalloc();
99	gregl	3.1	extern BEAM *hdgetbeam();
100			extern RAYVAL *hdnewrays();
101	gregl	3.9	extern unsigned hdmemuse();
102	gregl	3.12	extern long hdfiluse(), hdfilen(), hdallocfrag();
103	gregl	3.1	extern double hdray(), hdinter();
104			extern unsigned hdcode();
105	gregl	3.14	extern int hdfilord();
106	gregl	3.1
107	gregl	3.9	extern unsigned hdcachesize; /* target cache size (bytes) */
108	gregl	3.1	extern unsigned long hdclock; /* holodeck system clock */
109			extern HOLO hdlist[HDMAX+1]; / holodeck pointers (NULL term.) */
110
111			extern float hd_depthmap[]; /* depth conversion map */
112	gregl	3.13
113			extern int hdwg0[6]; /* wall grid 0 index */
114			extern int hdwg1[6]; /* wall grid 1 index */
115	gregl	3.1
116			#define hddepth(hp,dc) ( (dc) >= DCINF ? FHUGE : \
117			(hp)->tlin * ( (dc) >= DCLIN ? \
118			hd_depthmap[(dc)-DCLIN] : \
119			((dc)+.5)/DCLIN ) )
120
121			#define HOLOFMT "Holodeck" /* file format identifier */
122			#define HOLOVERS 0 /* file format version number */
123	gregl	3.11	#define HOLOMAGIC (323+sizeof(long)+8HOLOVERS) / file magic number */
124	gregl	3.1
125			/*
126			* A holodeck file consists of an information header terminated by a
127			* blank line, with "FORMAT=Holodeck" somewhere in it.
128			* The first integer after the information header is the
129			* above magic number, which includes the file format version number.
130	gregl	3.6	* The first longword after the magic number is a pointer to the pointer
131			* just before the SECOND holodeck section, or 0 if there is only one.
132	gregl	3.1	* This longword is immediately followed by the first holodeck
133			* section header and directory.
134			* Similarly, every holodeck section in the file is preceeded by
135			* a pointer to the following section, or 0 for the final section.
136			* Since holodeck files consist of directly written C data structures,
137			* they are not generally portable between different machine architectures.
138			* In particular, different floating point formats or bit/byte ordering
139			* will make the data unusable. This is unfortunate, and may be changed
140			* in future versions, but we thought this would be best for paging speed
141			* in our initial implementation.
142			*/