估计现在已经没有谁使用XCB这么底层的库写应用程序了，要用也是用经过精心封装的Motif, LessTiff, GTK, Qt, EWL, ETK或者Cairo等高层次的库。我之所以这么费心地去折腾XCB，其实主要也是为了学习。毕竟，使用最接近底层的UI库写代码是学习X协议及GUI编程原理的最好方法。
XCB的主要教程可以参考这里：http://xcb.freedesktop.org/tutorial/
和X协议有关的文档，在这里：http://www.x.org/releases/X11R7.7/doc/
在这里要继续吐槽freedesktop.org。没错，XCB的官网又是在freedesktop.org，而且正如我前几篇随笔中提到的Xft、Freetype一样，文档极其不完善。不过在其XcbApi页面有这样的提示“Refactoring this page...please be patient...”，那就耐心等待吧。好在代码是最好的文档，在Fedora 20中安装libxcb-devel软件包后，可以直接到/usr/include/xcb目录下查看XCB库的头文件，所以真要学习XCB也不是很难。如下图，我系统中的XCB库的头文件：
下面是一个最简单的XCB程序，它的功能是创建一个窗口。由于没有任何事件处理的机制，所以使用了pause()让程序暂停，要退出程序，必须得按Ctrl+C。
1 #include
2 #include
3 #include
4 #include
5 #include
6
7 double get_time(){
8 struct timeval timeval;
9 gettimeofday(&timeval, NULL);
10 return (double)timeval.tv_sec + (((double)timeval.tv_usec)/1000000);
11 }
12
13 int main(){
14 double start_time = get_time();
15
16 xcb_connection_t *connection = xcb_connect(NULL, NULL);
17 const xcb_setup_t *setup = xcb_get_setup(connection);
18 xcb_screen_iterator_t iter = xcb_setup_roots_iterator(setup);
19 xcb_screen_t *screen = iter.data;
20
21 xcb_window_t window = xcb_generate_id(connection);
22 xcb_create_window(
23 connection,
24 XCB_COPY_FROM_PARENT,
25 window,
26 screen->root,
27 100,100,
28 400, 300,
29 10,
30 XCB_WINDOW_CLASS_INPUT_OUTPUT,
31 screen->root_visual,
32 0, NULL);
33 xcb_map_window(connection, window);
34 xcb_flush(connection);
35
36 printf("花费时间：%f秒。",get_time()-start_time);
37 fflush(stdout);
38
39 pause();
40 xcb_disconnect(connection);
41 return 0;
42 }
从这段代码可以看出，要创建一个简单的窗口程序，必须经过如下步骤：
1、连接到XServer的Display，通过xcb_connect()函数进行，返回一个xcb_connection_t的指针，在这一步中，同时可以获得当前屏幕的Screen number；
2、获得xcb_setup，通过xcb_get_setup()函数进行。xcb_setup里面保存的是应用程序和XServer之间通讯时需要用到的信息，包括协议的版本、字节的顺序等。一般情况下，我们不需要关注这些细节；
3、获得Screen对象，这一步很重要，也很复杂。重要是因为只有获得一个Screen后，才能在屏幕上创建窗口，创建窗口时需要用到Screen中的一些信息。复杂是因为一个Display可以有多个Screen，所以通过xcb_setup_roots_iterator()函数返回的是一个迭代器，可以通过该迭代器对所有的Screen进行遍历。如果只有一个Screen，则返回的第一个迭代器中的data就指向该Screen。XCB中使用xcb_screen_t结构来保存Screen的信息；
4、创建窗口并显示窗口，这需要三步，第一步先使用xcb_generate_id()函数生成一个ID，第二步使用xcb_create_window()函数创建一个窗口，第三步使用xcb_map_window让窗口显示出来。
通过以上的代码，我还学到了一个技巧，那就是使用gettimeofday()函数来获取一个精确到微秒的时间，用来查看应用程序的耗时。
程序运行如下图：
这个新创建的窗口自己没有背景，所以它创建的时候屏幕上有什么，它窗口里面就有什么。对于程序中用到的数据结构和枚举的含义，可以直接查看xcb的头文件，配合ctags和taglist.vim插件使用的话，只需要按Ctrl+]键，就可以自动跳转到这些数据结构的定义处(在Vim中使用taglist的方法见这里Linux江湖02：打造属于自己的Vim)，如下两图：
最后，我对第一个简单的程序进行适当的扩展，看看怎么获取Display中有几个Screen以及怎么遍历Screen，最后显示Screen的一些信息。程序如下：
1 #include
2 #include
3 #include
4 #include
5 #include
6
7 double get_time(){
8 struct timeval timeval;
9 gettimeofday(&timeval, NULL);
10 return (double)timeval.tv_sec + (((double)timeval.tv_usec)/1000000);
11 }
12
13 int main(){
14 double start_time = get_time();
15 int screen_number;
16
17 xcb_connection_t *connection = xcb_connect(NULL, &screen_number);
18 const xcb_setup_t *setup = xcb_get_setup(connection);
19 xcb_screen_iterator_t iter = xcb_setup_roots_iterator(setup);
20 printf("当前的Screen Number为：%d\n",screen_number);
21 printf("iter.rem = %d，下面开始遍历:\n",iter.rem);
22
23 xcb_screen_t *screen;
24 for(; iter.rem!=0; xcb_screen_next(&iter)){
25 screen = iter.data;
26 printf("*****看到多少行这个提示，就说明有多少个Screen。*****\n");
27 printf(" Screen->root:%d\n",screen->root);
28 printf(" Screen->root_depth:%d\n",screen->root_depth);
29 printf(" Screen->white_pixel:%d\n",screen->white_pixel);
30 printf(" Screen->black_pixel:%d\n",screen->black_pixel);
31 printf(" Screen->width_in_pixels:%d\n",screen->width_in_pixels);
32 printf(" Screen->height_in_pixels:%d\n",screen->height_in_pixels);
33 printf(" Screen->width_in_millimeters:%d\n",screen->width_in_millimeters);
34 printf(" Screen->height_in_millimeters:%d\n",screen->height_in_millimeters);
35 }
36
37
38 xcb_window_t window = xcb_generate_id(connection);
39 xcb_create_window(
40 connection,
41 XCB_COPY_FROM_PARENT,
42 window,
43 screen->root,
44 100,100,
45 400, 300,
46 10,
47 XCB_WINDOW_CLASS_INPUT_OUTPUT,
48 screen->root_visual,
49 0, NULL);
50 xcb_map_window(connection, window);
51 xcb_flush(connection);
52
53 printf("花费时间：%f秒。",get_time()-start_time);
54 fflush(stdout);
55
56 pause();
57 xcb_disconnect(connection);
58 return 0;
59 }
最后运行效果如下图：
(京山游侠于2014-06-25发布于博客园，转载请注明出处。)
