4 |
|
|
5 |
|
/* |
6 |
|
* Header for holodeck display drivers. |
7 |
– |
* Include after "rholo.h". |
7 |
|
*/ |
8 |
|
|
9 |
|
/* display requests */ |
10 |
< |
#define DR_NEWSET 1 /* new bundle set */ |
11 |
< |
#define DR_BUNDLE 2 /* bundle request */ |
12 |
< |
#define DR_ATTEN 3 /* request for attention */ |
13 |
< |
#define DR_SHUTDOWN 4 /* shutdown request */ |
10 |
> |
#define DR_NOOP 0 /* to release from vain DR_ATTEN */ |
11 |
> |
#define DR_BUNDLE 1 /* lone bundle request */ |
12 |
> |
#define DR_ATTEN 2 /* request for attention */ |
13 |
> |
#define DR_SHUTDOWN 3 /* shutdown request */ |
14 |
> |
#define DR_NEWSET 4 /* new bundle set */ |
15 |
|
#define DR_ADDSET 5 /* add to current set */ |
16 |
< |
#define DR_DELSET 6 /* delete from current set */ |
16 |
> |
#define DR_ADJSET 6 /* adjust set quantities */ |
17 |
> |
#define DR_DELSET 7 /* delete from current set */ |
18 |
|
|
19 |
|
/* server responses */ |
20 |
< |
#define DS_IMMSET 1 /* immediate bundle set */ |
21 |
< |
#define DS_BUNDLE 2 /* computed bundle */ |
22 |
< |
#define DS_ACKNOW 3 /* acknowledge request for attention */ |
23 |
< |
#define DS_SHUTDOWN 4 /* end process and close connection */ |
24 |
< |
#define DS_ADDHOLO 5 /* register new holodeck */ |
20 |
> |
#define DS_BUNDLE 8 /* computed bundle */ |
21 |
> |
#define DS_ACKNOW 9 /* acknowledge request for attention */ |
22 |
> |
#define DS_SHUTDOWN 10 /* end process and close connection */ |
23 |
> |
#define DS_ADDHOLO 11 /* register new holodeck */ |
24 |
> |
#define DS_STARTIMM 12 /* begin immediate bundle set */ |
25 |
> |
#define DS_ENDIMM 13 /* end immediate bundle set */ |
26 |
|
|
27 |
|
/* |
28 |
|
* Normally, the server channel has priority, with the display process |
34 |
|
* Priority returns to normal after the following request. |
35 |
|
*/ |
36 |
|
|
37 |
+ |
#ifndef BIGREQSIZ |
38 |
+ |
#define BIGREQSIZ 512 /* big request size (bytes) */ |
39 |
+ |
#endif |
40 |
+ |
|
41 |
|
typedef struct { |
42 |
|
int2 type; /* message type */ |
43 |
|
int4 nbytes; /* number of additional bytes */ |
44 |
|
} MSGHEAD; /* message head */ |
45 |
|
|
46 |
< |
/* display request message bodies */ |
47 |
< |
|
48 |
< |
/* DR_NEWSET */ |
49 |
< |
/* no body */ |
50 |
< |
/* DR_BUNDLE */ |
51 |
< |
#define BUNDLE_REQ PACKHEAD |
52 |
< |
/* DR_ENDSET */ |
53 |
< |
/* no body */ |
54 |
< |
/* DR_SHUTDOWN */ |
55 |
< |
/* no body */ |
56 |
< |
/* DR_ADDSET */ |
57 |
< |
/* no body */ |
58 |
< |
|
53 |
< |
/* server response message bodies */ |
54 |
< |
|
55 |
< |
/* DS_STARTIMM */ |
56 |
< |
/* no body */ |
57 |
< |
/* DS_BUNDLE */ |
58 |
< |
#define BUNDLE_RES PACKHEAD /* extendable */ |
59 |
< |
/* DS_ENDIMM */ |
60 |
< |
/* no body */ |
61 |
< |
/* DS_SHUTDOWN */ |
62 |
< |
/* no body */ |
63 |
< |
/* DS_ADDHOLO */ |
64 |
< |
#define HOLO_RES HDGRID |
65 |
< |
/* DS_ACKNOW */ |
66 |
< |
/* no body */ |
46 |
> |
/* |
47 |
> |
* The display process is started with three arguments. The first argument |
48 |
> |
* is the short name of the holodeck file, appropriate for window naming, etc. |
49 |
> |
* The second and third arguments are the file descriptor numbers assigned to |
50 |
> |
* the server's standard output and input, respectively. The stdin and stdout |
51 |
> |
* of the display process are used for normal communication with the server, |
52 |
> |
* and are connected to pipes going each way. It is entirely appropriate |
53 |
> |
* for the display process to borrow the server's stdin and stdout for reading |
54 |
> |
* and writing user commands from the list in rhdriver.h. If standard input |
55 |
> |
* is not available for reading, then a descriptor of -1 will be passed. |
56 |
> |
* The standard output will always be available for writing, though it |
57 |
> |
* may go to /dev/null. |
58 |
> |
*/ |