src/hd/rhdisp.h

/* RCSid: $Id: rhdisp.h,v 3.16 2004/01/01 11:21:55 schorsch Exp $ */
/*
 * Header for holodeck display drivers.
 */
#ifndef _RAD_RHDISP_H_
#define _RAD_RHDISP_H_

#include "color.h"

#ifdef __cplusplus
extern "C" {
#endif

                                /* display requests */
#define DR_NOOP         0               /* to release from vain DR_ATTEN */
#define DR_BUNDLE       1               /* lone bundle request */
#define DR_ATTEN        2               /* request for attention */
#define DR_SHUTDOWN     3               /* shutdown request */
#define DR_NEWSET       4               /* new bundle set */
#define DR_ADDSET       5               /* add to current set */
#define DR_ADJSET       6               /* adjust set quantities */
#define DR_DELSET       7               /* delete from current set */
#define DR_KILL         8               /* kill rtrace process(es) */
#define DR_RESTART      9               /* restart rtrace */
#define DR_CLOBBER      10              /* clobber holodeck */
#define DR_VIEWPOINT    11              /* set desired eye position */

                                /* server responses */
#define DS_BUNDLE       32              /* computed bundle */
#define DS_ACKNOW       33              /* acknowledge request for attention */
#define DS_SHUTDOWN     34              /* end process and close connection */
#define DS_ADDHOLO      35              /* register new holodeck */
#define DS_STARTIMM     36              /* begin immediate bundle set */
#define DS_ENDIMM       37              /* end immediate bundle set */
#define DS_OUTSECT      38              /* render from outside sections */
#define DS_EYESEP       39              /* eye separation distance */

/*
 * Normally, the server channel has priority, with the display process
 * checking it frequently for new data.  However, when the display process
 * makes a request for attention (DR_ATTEN), the server will finish its
 * current operations and flush its buffers, sending an acknowledge
 * message (DS_ACKNOW) when it's done.  This then allows the
 * display process to send a long request to the holodeck server.
 * Priority returns to normal after the following request.
 */

#ifndef BIGREQSIZ
#define BIGREQSIZ       512             /* big request size (bytes) */
#endif

typedef struct {
        int16   type;           /* message type */
        int32   nbytes;         /* number of additional bytes */
} MSGHEAD;              /* message head */

/*
 * The display process is started with three arguments.  The first argument
 * is the short name of the holodeck file, appropriate for window naming, etc.
 * The second and third arguments are the file descriptor numbers assigned to
 * the server's standard output and input, respectively.  The stdin and stdout
 * of the display process are used for normal communication with the server,
 * and are connected to pipes going each way.  It is entirely appropriate
 * for the display process to borrow the server's stdin and stdout for reading
 * and writing user commands from the list in rhdriver.h.  If standard input
 * is not available for reading, then a descriptor of -1 will be passed.
 * The standard output will always be available for writing, though it
 * may go to /dev/null.
 */


        /* rhdisp.c */
extern void serv_request(int type, int nbytes, char *p);
extern int serv_result(void);
        /* rhdisp2.c */
extern int beam_sync(int all);
extern void beam_init(int fresh);
//extern int16 * beam_view(VIEW *vn, int hr, int vr);
        /* rhdisp2.c, rhdisp3.c */
extern void gridlines(void (*f)(FVECT wp[2]));
        /* rhd_ctab.c */
extern int new_ctab(int ncolors);
extern int get_pixel(uby8 rgb[3], void (*set_pixel)(int h, int r, int g, int b));


#ifdef __cplusplus
}
#endif
#endif /* _RAD_RHDISP_H_ */

Revision:	3.17
Committed:	Fri May 20 02:06:39 2011 UTC (12 years, 11 months ago) by greg
Content type:	text/plain
Branch:	MAIN
CVS Tags:	rad5R4, rad5R2, rad4R2P2, rad5R0, rad5R1, rad4R2, rad4R1, rad4R2P1, rad5R3, HEAD
Changes since 3.16:	+2 -2 lines
Log Message:	Changed every instance of BYTE to uby8 to avoid conflicts
#	User	Rev	Content
1	greg	3.17	/* RCSid: $Id: rhdisp.h,v 3.16 2004/01/01 11:21:55 schorsch Exp $ */
2	gregl	3.1	/*
3			* Header for holodeck display drivers.
4			*/
5	schorsch	3.15	#ifndef _RAD_RHDISP_H_
6			#define _RAD_RHDISP_H_
7
8	schorsch	3.16	#include "color.h"
9
10	schorsch	3.15	#ifdef __cplusplus
11			extern "C" {
12			#endif
13	gregl	3.1
14			/* display requests */
15	gregl	3.4	#define DR_NOOP 0 /* to release from vain DR_ATTEN */
16	gregl	3.5	#define DR_BUNDLE 1 /* lone bundle request */
17	gregl	3.2	#define DR_ATTEN 2 /* request for attention */
18			#define DR_SHUTDOWN 3 /* shutdown request */
19			#define DR_NEWSET 4 /* new bundle set */
20	gregl	3.1	#define DR_ADDSET 5 /* add to current set */
21	gregl	3.9	#define DR_ADJSET 6 /* adjust set quantities */
22	gregl	3.5	#define DR_DELSET 7 /* delete from current set */
23	gregl	3.9	#define DR_KILL 8 /* kill rtrace process(es) */
24			#define DR_RESTART 9 /* restart rtrace */
25			#define DR_CLOBBER 10 /* clobber holodeck */
26	gwlarson	3.12	#define DR_VIEWPOINT 11 /* set desired eye position */
27	gregl	3.1
28			/* server responses */
29	gregl	3.9	#define DS_BUNDLE 32 /* computed bundle */
30			#define DS_ACKNOW 33 /* acknowledge request for attention */
31			#define DS_SHUTDOWN 34 /* end process and close connection */
32			#define DS_ADDHOLO 35 /* register new holodeck */
33			#define DS_STARTIMM 36 /* begin immediate bundle set */
34			#define DS_ENDIMM 37 /* end immediate bundle set */
35	gregl	3.10	#define DS_OUTSECT 38 /* render from outside sections */
36	gwlarson	3.11	#define DS_EYESEP 39 /* eye separation distance */
37	gregl	3.1
38			/*
39			* Normally, the server channel has priority, with the display process
40			* checking it frequently for new data. However, when the display process
41			* makes a request for attention (DR_ATTEN), the server will finish its
42			* current operations and flush its buffers, sending an acknowledge
43			* message (DS_ACKNOW) when it's done. This then allows the
44			* display process to send a long request to the holodeck server.
45			* Priority returns to normal after the following request.
46			*/
47
48	gregl	3.3	#ifndef BIGREQSIZ
49			#define BIGREQSIZ 512 /* big request size (bytes) */
50			#endif
51
52	gregl	3.1	typedef struct {
53	greg	3.14	int16 type; /* message type */
54			int32 nbytes; /* number of additional bytes */
55	gregl	3.1	} MSGHEAD; /* message head */
56	gregl	3.6
57			/*
58			* The display process is started with three arguments. The first argument
59			* is the short name of the holodeck file, appropriate for window naming, etc.
60			* The second and third arguments are the file descriptor numbers assigned to
61			* the server's standard output and input, respectively. The stdin and stdout
62			* of the display process are used for normal communication with the server,
63			* and are connected to pipes going each way. It is entirely appropriate
64			* for the display process to borrow the server's stdin and stdout for reading
65	gregl	3.8	* and writing user commands from the list in rhdriver.h. If standard input
66	gregl	3.6	* is not available for reading, then a descriptor of -1 will be passed.
67			* The standard output will always be available for writing, though it
68			* may go to /dev/null.
69			*/
70	schorsch	3.16
71
72			/* rhdisp.c */
73			extern void serv_request(int type, int nbytes, char *p);
74			extern int serv_result(void);
75			/* rhdisp2.c */
76			extern int beam_sync(int all);
77			extern void beam_init(int fresh);
78			//extern int16 * beam_view(VIEW *vn, int hr, int vr);
79			/* rhdisp2.c, rhdisp3.c */
80			extern void gridlines(void (*f)(FVECT wp[2]));
81			/* rhd_ctab.c */
82			extern int new_ctab(int ncolors);
83	greg	3.17	extern int get_pixel(uby8 rgb[3], void (*set_pixel)(int h, int r, int g, int b));
84	schorsch	3.16
85	schorsch	3.15
86			#ifdef __cplusplus
87			}
88			#endif
89			#endif /* _RAD_RHDISP_H_ */
90