引言 1
关于这本手册的说明 1
内容概要 1
目录 1
如何使用这本手册 2
实例程序 3
一些要求 3
手册中用到的字体约定 3
有关文件 3
欢迎指教 4
关于发行执照 4
致谢 4
第一章引言 6
1.1 X的版本 6
1.2 X窗口系统概念 6
图目录 7
1-1． 由多个屏幕组成的显示系统 7
1.2.2服务器－客户模式 7
1.2.1显示器和屏幕 7
1-2． 应用程序可以在横跨网络的任何系统上运行 8
1.2.3窗口管理 9
1.2.5对X的扩展 10
1.2.4事件 10
1.3 X窗口系统软件结构 10
1.4 Xlib概貌 11
1-3． 客户程序通过Xlib调用与服务器进行通信 11
1-1．Xlib按功能分组的子程序 12
表目录 12
2.1 Xlib如何工作 14
第二章X概念 14
2.1.2缓冲 15
2-1． 客户程序与服务器 15
2.1.1 X协议 15
2.1.3资源 16
2-2． 服务器的事件队列和每个客户程序的事件队列 17
2.1.4特性和标识号 17
2.1.5窗口管理程序 18
2-3． 用于建立窗口的xmh应用程序的例子 19
2.2窗口是什么？ 19
2.2.1窗口特征 20
2.2.2树形层次 21
2-4． 窗口构造的组成成分 21
2-5． 屏幕上的一个窗口层次 22
2.2.3坐标系 23
2-6． 窗口层次结构的图示 23
2-7． 坐标系 24
2.2.5映射和可见性 24
2.2.4窗口叠次序（stacking order） 24
2.3.1象点和颜色 25
2.3 X图形入门 25
2-8． 用着色图把象点值映射成颜色 26
2.3.2象点和色板 26
2.3.4画图和图形信息 27
2.3.3三维象点图和可画物（drawable） 27
2.4窗口特性的进一步介绍 28
2-9． 如何用贴砖铺贴窗口的背景 28
2.3.5贴砖和贴片 28
2.4.2窗口结构 29
2.4.1窗口属性 29
2.4.4深度和着色类型 30
2.4.5缩微窗口图象 30
2.4.3类型、输入／输出和只输入窗口 30
2.4.6根窗口的特殊性质 31
2-10． 一个应用程序和它的缩微窗口图符 31
2.5事件入门 31
2.5.2事件的选择和传播 32
2.5.1事件指什么 32
2.5.3事件队列 33
2.5.4事件结构 33
2.6.1.1设计要求 34
2.6.1设计一个应用程序 34
2.6如何用Xlib进行程序设计 34
2.5.5事件循环 34
2.6.1.2用户接口 35
2.6.2.2编译和链接X程序 36
2.6.2.1用户缺省 36
2.6.2编写X应用程序 36
2.6.2.4使用结构、符号和表征码 37
2.6.2.3命名约定 37
2.6.3调试X应用程序 38
2.6.2.5运行性能的优化 38
2.6.3.2结构XErrorEvent 39
2.6.3.1错误 39
2.6.3.3同步的错误 40
第三章基本的窗口程序 41
3.1运行程序 41
3.2Basicwin的主程序 42
3-1． 程序basicwin的输出 42
3.2.1包含文件和变量说明 42
3.2.2与服务器连接 44
3.2.3显示宏命令 46
3.2.4获取窗口信息 46
3.2.5建立窗口 48
3.2.6颜色策略 49
3.2.7准备图符的三维象点图 50
3.2.8与窗口管理程序通信 51
3.2.10建立资源 54
3.2.9选择所希望的事件类型 54
3.2.13建立事件采集循环 55
3.2.12发送输出缓冲区 55
3.2.11窗口映射 55
3.2.13.1重画窗口 58
3-2． 由一个用户动作引起的多个显露事件 59
3.2.14什么时候可以画东西？ 63
3.2.16管理窗口尺寸的重设 63
3.2.15所画的内容什么时候显现？ 63
3.2.17退出程序 64
3.2.19小结 65
3.2.18错误管理 65
3.2.20 basicwin的全部源程序 66
4.2窗口属性结构 74
4.1建立窗口属性 74
第四章窗口属性 74
4-1． 窗口属性表征码符号 75
4.3可通过程序设置的属性 77
4-2． 可以单独设置的属性 77
4.3.1窗口背景 78
4.3.1.1 background_pixmap 78
4.3.1.2 background_pixel 79
4.3.2窗口边框 79
4.3.2.1 border_pixmap 79
4.3.2.2 border_pixel 80
4.3.3内容重定位 80
4-1． 画图程序的bit_gravity 81
4.3.4窗口重定位 82
4-2． 窗口重定位起作用的子窗口位置 82
4.3.5后备存储 83
4.3.6存储隐匿内容 84
4.3.7事件处理 85
4.3.8废除转送子结构重构请求特性 85
4.3.10光标 86
4.3.9着色图 86
4.3.11窗口属性的缺省值 87
4-3． 窗口属性的缺省值 87
4.4结构XWindowAttributes的信息 88
第五章图形信息 90
5.1建立和设置图形信息 91
5-1． 一个实心多边形的“源” 91
5-1． 设置XGCValues结构的符号 93
5.1.1建立和设置GC的例子 94
5.2图形信息之间的转换 95
5.3控制图形元语的影响 96
5-2． GC中的逻辑函数 97
5.3.1逻辑函数 97
5-2a． 逻辑函数GXcopy的作用 98
5-2b． 逻辑函数GXxor的作用 98
5-2c． 逻辑函数GXand的作用 99
5.3.2色板表征码 99
5.3.3剪辑表征码 99
5-3．plane_mask在12色板显示器上的作用 100
5.4前景和背景 100
5-5． 用XDrawlmageString画字符时，前景和背景的使用 101
5-4． 使用剪辑原点定位相对于可画物的位置 101
5.5线段特征 101
5.5.1线宽 102
5.5.4连接样式 103
5-6． 线段样式 103
5.5.2线段样式 103
5.5.3线段端点的样式 103
5-7． 线段端点的样式 104
5.5.5长划线表和间距 104
5-8． 线段连接样式 105
5-9． 8象点宽的线段JoinRound说明 105
5.5.6设置线段特征的例子 107
5-10． 用例5-6中设置的GC画出的线 108
5.6形成图案 108
5-11． 用贴砖铺贴一个区域 109
5.6.1贴砖 109
5.6.2贴片 110
5.6.3贴砖和贴片的尺寸 110
5.6.4填充方式 110
5.6.5填充规则 111
5-13． 填充封闭多边形的常量fill_rull 111
5-12． 在小三维象点图上示范fill_style 111
5.6.6用于填充的弧方式 112
5-14． 填充弧用的orc_mode常量 112
5.7图形的显露 113
5.8字体 113
5.9子窗口方式 114
5.10客户程序间共享GC 114
5-15． 拷贝部分不可用的区域 114
5-3． 图形信息缺省值 115
5.11图形信息的缺省值 115
第六章画图形和正文 116
6.1画图 116
6.1.1度量图形 117
6-1．XDrawArc或者XDrawArcs的角度度量 117
6.1.2画图实例 118
6.1.3库程序draw_box 119
6.1.5建立贴砖或贴片 120
6.1.4填充 120
6-2． 具有相同参数的XFillRectangle和XDrawRectangle画象点的效果对照 121
6.1.6拷贝和清除区域 123
6.2字体和正文 123
6.2.1字符格式 124
6.2.2装载字体 124
6-3． XClearArca—— 当width或者height参数为0时，清除的区域 124
6.2.3字符 125
6.2.3.1结构XCharStruct 126
6-4． 两个字符的尺度信息 126
6.2.4正文的定位 129
6.2.5画正文库程序 130
6-5． 字符串的垂直定位 130
6.2.6画正文的库程序 131
6-1． 字体特性 134
6.2.7字体特性 135
6.3区 136
6.2.8设置字体路径 136
6.4 映象 137
6.3.3返回有关区的信息 137
6.3.2区的计算 137
6.3.1区的移动和重新设置尺寸 137
6.4.1管理映象 139
6-6． bitmap_unit=16的映象的位和字节次序 140
6.4.2使用映象的例子 140
7-2． 象点值到RGB的映射：序 140
6.5二维象点图的管理 141
6.6光标 141
6.6.1标准的光标字体 143
6.6.2装载和改变光标 144
7.1基本彩色项和概念 145
第七章颜色 145
7.2.2单色和灰度等级（Grayscale） 146
7.2.1中等范围彩色显示器 146
7-1． 象点值到RGB映象：彩显上利用着色图 146
7-1． 象点值到RGB映象：彩显上利用着色图 146
7.2显示硬件上的差别 146
7.2.3高性能彩色显示器 147
7-2． 象点值到RGB的映射：灰度显示器和单色显示器 147
7.2.4 X如何管理不同的显示器类型 148
7-3． 象点值到RGB的映射：高性能彩色显示器 148
7.2.5可共享与可修改性 149
7-1． 着色类型比较 149
7-4． 着色类型等级 150
7.2.6缺省着色类型 150
7-2． 各种服务器上缺省着色图的着色类型 151
7.2.7缺省着色图 151
7.3分配共享颜色 152
7.3.1 XColor结构 153
7.3.2颜色名数据库 153
7-3．颜色数据库 154
7.3.3十六进制颜色说明 155
7.3.4分配标准颜色的程序 156
7.3.5指定明确的RGB值 157
7-4． 指定粉红色的四种方法 158
7.3.6选择缺省颜色 158
7.4存贮客户私有的颜色 159
7.4.1为图形的相互覆盖分配读／写色素 160
7.4.2使用XAllocColorPlanes 163
7.4.3单色显示器里的高亮度 165
7.5建立和安装着色图 165
7.5.1处理着色图的函数 166
7.5.2事件ColormapNotify 167
7.5.3需求着色图表（The required Colormap List） 168
7.6标准着色图 168
7.6.1标准着色图特性 169
7.6.2结构XStandardColormap 170
7-5． 将象点子字段移进象点值 171
7.6.3 3/3/2标准着色图 171
7.6.4安装标准着色图 171
7.6.5 RGB值转换为象点值的例子 172
7.7编写可移植的彩色程序 174
7.7.1单色与彩色 174
7.7.2检查着色类型 175
7.7.3获取有关着色类型的信息 176
7.7.3.1选择着色类型的实例 177
7.8杂类颜色管理库程序 179
第八章事件 180
8.1事件处理概论 180
8.2事件处理 181
8.2.1事件结构 181
8.2.2事件类型和XEvent联合 182
8.2.3事件队列 183
8.2.4处理事件 183
8-1． 服务器的事件队列和每个客户程序的事件队列 183
8.2.5输出事件类型 187
8.2.6获取事件的库程序 188
8-1． 读取事件库程序 190
8.2.7判断子程序 191
8.3选择事件 193
8-2． 事件mask定义 193
8.3.1事件表征码与事件间的对应关系 195
8-3． 事件表征码，事件类型以及事件结构 195
8.3.2设备事件的传播 197
8-2a． 一种可能的选择方案 198
8-2b． 另一种可能的选择方案 198
8-2c． 又一种可能的选择方案 199
8.3.2.1键盘聚焦窗口 199
8.3.2.2独享键盘和指示器 200
8.3.3.2 ButtonPressMask,ButtonReleaseMask和OwnerGrabButtonMask 201
8.3.3事件表征码 201
8.3.3.1 KeyPressMask和KeyReleaseMask 201
8.3.3.3定位器运动表征码 202
8.3.3.4 FocusChangeMask 202
8.3.3.5 EnterWindowMask和LeaveWindowMask 202
8-3． 降低窗口C产生成的Expose事件 203
8.3.3.6 KeyMapStateMask 203
8.3.3.7 ExposureMask 203
8.3.3.9 ColormapChangeMask 204
8-4． 引起VisibilityNotify事件的可见性转换 204
8.3.3.8 VisibilityChangeMask 204
8.3.3.10 PropertyChnageMask 204
8.3.3.12 SubstructRedirectMask 205
8.3.3.11 StructureNotifyMask和SubstructuredNotifyMask 205
8.3.3.13 ResizeRedirectMask 206
8.3.3.14自动选择事件 206
8.4发送事件 207
8-5． 介绍事件的其它章节 208
8.5在何处有关每一个事件的更多资料 208
9.1键盘 210
第九章键盘和定位器 210
9.1.1简单的键盘输入 212
9.1.1.1获取字符串——对话窗口 213
9.1.2键盘映射 217
9.1.2.1键盘符号到字符串的映射 218
9.1.2.2功能转换键 219
9.1.2.3键代码到键符号的映射 220
9-1． 逻辑功能转换键与一个典型的功能转换键的映射 220
9.1.3键符号的背景 221
9.1.3.1键符号的设计 221
9.1.3.2键符号意义的约定 222
9.1.4改变服务器范围的键盘映射 222
9.1.4.1改变键代码到键符号的映射 222
9.1.4.2改变功能转换 224
9.1.5其它键盘管理库程序 225
9.1.4.3改变X11.1的功能转换键映射 225
9.2.1.1 获取所有的移动事件 226
9.2定位器 226
9.2.1跟踪定位器移动 226
9.2.1.2使用定位器移动条件特性 229
9.2.1.3移动历史 232
9.2.2管理定位器按钮事件 234
9.3边界跨越和键盘聚焦改变事件 238
9.2.3改变定位器按钮映射 238
9.2.4移动定位器 238
9.3.1事件KeymapNotify 240
9.4独享键盘和定位器 240
9.5键盘缺省值 242
9.5.1设置键盘缺省 242
9-2． 键盘缺省值的设置——缺省值及范围 243
9.5.2获取键盘缺省值 244
9.6定位器缺省值 244
第十章客户程序通信 245
10.1特性和标识符 245
10.2与窗口管理程序通信 246
10.2.1客户程序的作用 246
10.2.1.1建立一个顶层窗口 246
10.2.2客户程序设置的特性 247
10-1． 窗口管理程序条件特性项 248
10.2.2.1XA_WM_NAME 248
10.2.2.4应用程序命令及参数 249
10.2.2.3 XA_WM_ICON_NAME 249
10.2.2.2 XA_WM_CLASS 249
10.2.2.5窗口尺寸条件特性——正常的和放大的窗口 250
10-2．XSizeHints标志 251
10-3． 设置和获取尺寸条件特性的库程序 252
10.2.3其它的窗口管理程序条件特性 252
10.2.3.1标志字段 253
10.2.3.2输入字段和输入聚焦 253
10-4． 窗口管理程序条件特性的标志 253
10-5． 初始状态条件特性标志 254
10.2.3.4图符条件特性 254
10.2.3.3初始状态字段 254
10.2.3.6临时窗口 256
10.2.3.5窗口组 256
10.2.5客户程序对窗口管理程序活动的响应 257
10.2.4.1 XA_WM_ICON_SIZE 257
10.2.4由窗口管理程序设置的特性 257
10.3选择区 258
10.3.1选择机构 258
10.3.2选择区的例子 259
10.3.3取得选择区所有权 260
10.3.4选择区拥有者的责任 261
10.3.5放弃选择区所有权 262
10.3.8再谈选择特性和类型 263
10.3.7大量数据的传送 263
10.3.6请求选择区 263
10.4剪裁缓冲区 264
10.3.8.1目标标识号 264
10-6． 内部特性类型 265
第十一章管理用户缺省值 266
11-1． 用XGetDefault处理用户缺省值的过程 267
11.1使用XGetDefault 267
11.2在应用程序里使用X11.2的资源管理程序 273
11-2． 用资源管理程序处理缺省值的过程 274
11.4管理用户缺省值数据库 274
11.3标准几何参数 274
11-3． 假设xmail显示 276
11.4.1紧密粘结和松散粘结 277
11.4.3存贮／访问规则 278
11.4.2-name选择项 278
11-1． 类设置 279
11.5.1将资源放进数据库 280
11.4.4资源管理程序值及表示类型 280
11.5其它资源管理库程序 280
11.5.2资源管理程序标识码 281
第十二章一个完整的应用程序 282
12.1 basecalc介绍 282
12-1． 屏幕上的应用basecalc 283
12.2包含文件 284
12.3 basecalc的主程序 284
12.4获取用户缺省值 285
12.4.1 Basecalc的用户缺省值 286
12.4.2命令行语法分析 286
12.4.3获取数据库 290
12.4.4从数据库中获取选择项 292
12.6初始化计算器 296
12.5打印有关用法的信息 296
12.7形成窗口 301
12.8选择事件 301
12.9处理事件 302
12.10画‘按键’ 305
12.11没有列出的子程序 306
第十三章其它程序设计技巧 308
13.1屏幕保存器（Screen Saver） 308
13.2来自其它主机和结点的访问 308
13.2.1增加、删除或者列出主机 308
13.2.2允许和禁止访问控制 309
13.3窗口层次结构的获取 309
13.4关闭方式 309
13.5连接关闭操作 310
13.6数据管理 311
13.6.2相关表 311
13.6.1上下文相关管理程序 311
13.7随后库程序（The after function） 312
13.8坐标变换 312
13.9将程序移植到X环境 312
13.10 X扩展程序的使用 313
13.9.1从X10向X11移植 313
第十四章窗口管理 315
14.1外观规定 315
14.2转送子结构重构请求 316
14.3.1 阴影 317
14.3重设父窗口 317
14-1． 背景阴影 318
14-2． 背景阴影的窗口层次 318
14.4窗口安全记录 319
14-3． 阴影试验的实际效果 319
14.5.2设置图符尺寸 320
14.5.1读取条件特性 320
14-1． 窗口管理程序的条件特性 320
14.5窗口管理程序——客户程序通信 320
14.6窗口管理程序功能 321
14.7基本窗口管理程序 322
14-3． 没有兄弟窗口的叠状态的含义 322
14-2． 给出兄弟窗口的叠状态的含义 322
14.7.1程序的操作 323
14-4．winman生成的菜单 323
14.7.2主程序说明 324
14.7.4选择输入 332
14.7.3窗口分层 332
14-5． 菜单的窗口层 333
14.7.5管理输入 333
14.7.6转换区域的颜色 334
14.7.9绘制菜单 335
14.7.8独享定位器 335
14.7.7光标 335
14.7.10循环窗口 336
14.7.11提升及降低窗口 337
14.7.12移动窗口或改变窗口尺寸 338
14-6． 拖动窗口轮廓 343
14.7.13缩微或复原窗口 343
14.7.14建立图符 347
14.7.15获取图符尺寸 349
14.7.16更新图符表 351
14.7.17删除图符 352
14.7.18改变键盘焦点 352
14.7.19画聚焦窗口外框 355
14.7.20执行shell命令 356
14.8窗口管理程序未解决的问题 357
附录A术语汇编 358
附录B X10的兼容性 372
XDraw和XDrawFilled 372
B-1．顶点标志值 373
附录C编写X的扩展程序 375
基本协议支持库程序 375
连结Xlib 376
扩展程序的初始化 376
连结程序库 376
XESetCreateGC 377
XESetCopyGC 377
XESetCloseDisplay 377
XESetCreateFont 378
XESetFreeGC 378
XESetFreeFont 378
XESetWireToEvent 379
XESetEventToWire 379
XESetErrorString 380
XESetError 380
XFindOnExtensionList 381
XAddToExtensionList 381
XESetFlushGC 381
连结Xlib数据结构 381
图形批处理 382
GC缓存 382
分配一个资源ID 382
请求的格式 384
请求、回答和Xproto.h 384
编写扩展的二级程序 384
发送协议请求和参数 386
数据结构的锁定 386
开始编写二级功能程序 386
可变长度参数 387
应答 388
可移植性考虑 389
同步调用 389
内存的分配和释放 389
衍生正确的扩展程序操作码 390
附录D应用程序basecalc 391
附录E事件参考 430
公用结构成分的意义 430
ButtonPress,ButtonRelease 433
CirculateNotify 435
CirculateRequest 436
ClientMessage 437
ColormapNotify 439
ConfigureNotify 440
ConfigureRequest 442
CreateNotify 444
DestroyNotify 446
EnterNotify,LeaveNotify 447
E-1． 跨越边界事件和窗口的关系 449
E-2． 事件的detail成分和窗口关系 450
E-1． 定位指针在窗口间移动时所产生的事件 451
E-2． 在各种窗口关系情况下，指针从窗口A转移到窗口B时 451
产生的边界跨越事件和事件的detail成分 451
Expose 452
FocusIn,FocusOut 454
E-3． 事件FocusIn和FocusOut以及各窗口的关系 455
E-4． 事件的detail成分和窗口关系 456
E-3a． 事件FocusIn和FocusOut示意图 457
E-3b． 事件FocusIn和FocusOut示意图 458
GraphicsExpose,NoExpose 459
GravityNotify 461
KeymapNotify 462
KeyPress,KeyRelease 464
MapNotify,UnampNotify 466
MappingNotify 468
MapRequest 470
MotionNotify 471
PropertyNotify 473
ReparentNotify 474
ResizeRequest 475
SelectionClear 476
SelectionNotify 477
SelectionRequest 478
VisibilityNotify 479
E-5． 结构XVisibilityEvent的state值 480
选择区约定的状况 481
同级通过选择区通信 481
简介 481
附录F客户程序间通信约定提案 481
询问选择区拥有权 482
选择区拥有者的责任 483
放弃选择区的所有权 484
自愿放弃 484
强制放弃 484
请求一个选择区 485
大量数据传送 486
选择区标识符的用途 487
选择区PRIMARY 488
目标标识符 488
选择区CLIPBOARD 488
选择区SECONDARY 488
选择标识符 488
选择区特性的用途 489
STRING特性 489
INDIRECT特性 489
F-1． 目标标志符及其含义 490
INCREMENTAL特性 490
客户程序与窗口管理程序的通信 491
客户程序的动作 492
建立顶层窗口 492
客户程序特性 493
XA_WM_NAME 493
XA_WM_ICON_NAME 494
XA_WM_NORMAL_HINTS 494
XA_WM_HINTS 495
F-2． 输入方式 497
WM_TRANSIENT_FOR 498
窗口管理程序特性 498
WM_CLASS 498
配置窗口 499
映射窗口和解除对窗口的映射 499
键盘聚焦 500
着色图 501
缩微窗口图符 502
弹出式窗口 502
窗口组 502
客户程序对窗口管理程序操作的响应 503
移动 503
重新设置尺寸 503
（非）缩微化 503
着色图的修改 503
键盘聚焦 504
ClientMessages 504
窗口管理程序约定的状态 504
客户程序对会话管理程序操作的响应 505
终止 505
WM_CLIENT_MACHINE 505
终止 505
客户程序与会话管理程序的通信 505
WM_COMMAND 505
特性 505
客户程序的作用 505
会话管理程序的状态约定 506
共享资源的处理 506
键盘聚焦 506
定位器 506
着色图 507
致谢 507
附录G版本注释 508
获得X软件 509
附录H其它信息来源 509
故障修复 510
网络新闻 511
其它Xlib书籍 512
电话支持 513
培训 513
工具箱 513
H-1． X集团 513
自我发现 514
X集团 613