1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
|
/*
* dpsNXargs.h -- constant values for XDPSNXSetClientArg()
*
* (c) Copyright 1993-1994 Adobe Systems Incorporated.
* All rights reserved.
*
* Permission to use, copy, modify, distribute, and sublicense this software
* and its documentation for any purpose and without fee is hereby granted,
* provided that the above copyright notices appear in all copies and that
* both those copyright notices and this permission notice appear in
* supporting documentation and that the name of Adobe Systems Incorporated
* not be used in advertising or publicity pertaining to distribution of the
* software without specific, written prior permission. No trademark license
* to use the Adobe trademarks is hereby granted. If the Adobe trademark
* "Display PostScript"(tm) is used to describe this software, its
* functionality or for any other purpose, such use shall be limited to a
* statement that this software works in conjunction with the Display
* PostScript system. Proper trademark attribution to reflect Adobe's
* ownership of the trademark shall be given whenever any such reference to
* the Display PostScript system is made.
*
* ADOBE MAKES NO REPRESENTATIONS ABOUT THE SUITABILITY OF THE SOFTWARE FOR
* ANY PURPOSE. IT IS PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY.
* ADOBE DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
* IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
* NON- INFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL ADOBE BE LIABLE
* TO YOU OR ANY OTHER PARTY FOR ANY SPECIAL, INDIRECT, OR CONSEQUENTIAL
* DAMAGES OR ANY DAMAGES WHATSOEVER WHETHER IN AN ACTION OF CONTRACT,
* NEGLIGENCE, STRICT LIABILITY OR ANY OTHER ACTION ARISING OUT OF OR IN
* CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. ADOBE WILL NOT
* PROVIDE ANY TRAINING OR OTHER SUPPORT FOR THE SOFTWARE.
*
* Adobe, PostScript, and Display PostScript are trademarks of Adobe Systems
* Incorporated which may be registered in certain jurisdictions
*
* Author: Adobe Systems Incorporated
*/
#ifndef DPSNXARGS_H
#define DPSNXARGS_H
/* XDPSNXSetClientArg arg values */
#define XDPSNX_AGENT 0 /* val := (char *), default := NULL
* val is a string in the form:
* transport/host:[:]port
* specifying the agent to establish a
* connection with.
*/
#define XDPSNX_EXEC_FILE 1 /* val := (char *), default := (see docs)
* val is a string giving the name of the
* agent executable to launch if
* XDPSNX_AUTO_LAUNCH is set to true. The
* caller may explicity give the full path to
* the agent in val or just the name - which
* will cause the user's search path to
* searched for the named program file.
*/
#define XDPSNX_EXEC_ARGS 2 /* val := (char **), default := NULL
* val is expected to be a pointer to an array
* of pointers to the arguments to be given to
* the program specified by
* XDPSNX_EXEC_FILE.
* Last array member must be (char *) NULL.
*/
#define XDPSNX_AUTO_LAUNCH 3 /* val := Bool, default := False
* val specifies if library cannot find a
* suitable agent to connect to then it should
* try to start the one defined by
* XDPSNX_EXEC_FILE with XDPSNX_EXEC_ARGS as
* arguments.
*/
#define XDPSNX_LAUNCHED_AGENT_TRANS 4
/* val := int, default := XDPSNX_USE_BEST
* val specifies the transport a new, auto-
* launched agent is to use. See values
* below.
*/
#define XDPSNX_LAUNCHED_AGENT_PORT 5
/* val := int, default := XDPSNX_USE_BEST
* val specifies the port that a new, auto-
* launched agent is to use for advertising in
* the transport protocol specified by
* XDPSNX_LAUNCHED_AGENT_TRANS. The default
* port of XDPXNX_USE_BEST specifies that
* the agent is to use its default
* "well-known" port.
*/
#define XDPSNX_REQUEST_XSYNC 6
/* val := (Display *), default := NULL
* val specifies a Display handle whose DPS
* request handling mode should be changed.
* When ANY DPS request is called,
* an unconditional XSync is done on the
* Display before sending the DPS request.
* This guarantees that any buffered X requests
* are processed by the server before the
* DPS request is sent to the agent.
* The DPS request itself is flushed to the
* agent. This mode is primarily useful
* for debugging.
*/
#define XDPSNX_REQUEST_RECONCILE 7
/* val := (Display *), default := NULL
* val specifies a Display handle whose DPS
* request handling mode should be changed.
* When ANY DPS request is called,
* the logical equivalent of the routine
* XDPSReconcileRequests is done on the
* Display before sending the DPS request.
* This guarantees that any buffered X requests
* will be processed by the server before the
* DPS request is processed by the agent.
* Connections to the server and agent are
* flushed. This is the default mode.
*/
#define XDPSNX_REQUEST_BUFFER 8
/* val := (Display *), default := NULL
* val specifies a display handle whose DPS
* request handling mode should be changed.
* When ANY DPS request is called,
* the DPS request is simply buffered as
* usual. This is equivalent to what happens
* when the Client Library drives a DPS/X
* server extension. This mode should
* only be used when the app has adequate
* synchronization through explicit calls
* to XDPSReconcileRequests.
*/
/* DPS NX 2.0 */
#define XDPSNX_GC_UPDATES_SLOW 9
/* val := (Display *), default := NULL
* val specifies a Display handle whose GC
* update handling mode should be changed.
* The library automatically tracks changes
* to the GCs used by the application.
* When ANY GC is changed by any component
* of the application (widget, toolkit, etc.),
* a notification of the change is sent
* to the agent. This guarantees that
* the agent tracks all GC changes that
* it cares about correctly, at the cost
* of sending unnecessary updates for GC's
* that the agent doesn't care about.
* Connections to the server and agent are
* are both syncronized.
* This is the default mode.
*/
#define XDPSNX_GC_UPDATES_FAST 10
/* val := (Display *), default := NULL
* val specifies a Display handle whose GC
* update handling mode should be changed.
* No automatic tracking of GC changes is
* done. The library depends upon the
* application to do explicit notification
* of relevant GC changes by using the
* XDPSFlushGC() function. Setting this
* mode means that the application commits
* to all updates, including components
* linked in (widgets, toolkits), with the
* benefit of substantial performance
* enhancement in certain situations. Do
* not use this mode unless you are sure
* that all components of your application
* use XDPSFlushGC() properly, or else
* inaccurate display renderings will occur.
* No additional synchronization occurs.
*/
#define XDPSNX_SEND_BUF_SIZE 11
/* val := int, default := XDPSNX_USE_BEST
* val specifies the size in bytes that
* the library should use for low-level
* output buffering on the agent connection.
* Sizes less than 4096 or greater than
* 65536 are ignored.
*/
#define XDPSNXLASTARG XDPSNX_SEND_BUF_SIZE
/* ---Special Values--- */
#define XDPSNX_USE_BEST -1
/* ---Transport Values--- */
#define XDPSNX_TRANS_UNIX 0
#define XDPSNX_TRANS_TCP 1
#define XDPSNX_TRANS_DECNET 2
/* XDPSNXSetAgentArg arg values */
#define AGENT_ARG_SMALLFONTS -1
/* val := (AGENT_SMALLFONTS_*, see below),
* default := AGENT_SMALLFONTS_ACCURATE.
* The value of this argument tells the
* agent whether fonts with small sizes
* (6-24 points) should be shown with
* accurate spacing but slowly, or as
* fast as possible with potentially
* inaccurate spacing. This argument
* is a hint: the agent may not be able
* to satisfy the request for fast showing
* if matching screen fonts cannot be found.
*/
#define AGENT_ARG_PIXMEM -2
/* val := (AGENT_PIXMEM_*, see below),
* default := AGENT_PIXMEM_LIMITED.
* The value of this argument is a hint
* to the agent about the availability
* of pixmap storage on the X server.
* If there is ample pixmap memory, the
* agent can use various caching techniques
* to improve performance. If memory
* is limited, the agent will minimize its
* use of pixmaps. This argument is
* a hint: the agent may not be able to
* do anything about the specified value.
*/
#define AGENTLASTARG AGENT_ARG_PIXMEM
/* ---AGENT_ARG_SMALLFONTS Values--- */
#define AGENT_SMALLFONTS_ACCURATE 0
#define AGENT_SMALLFONTS_FAST 1
/* ---AGENT_ARG_PIXMEM--- */
#define AGENT_PIXMEM_LIMITED 0
#define AGENT_PIXMEM_MODERATE 1
#define AGENT_PIXMEM_UNLIMITED 2
#endif /* DPSNXARGS_H */
|
