在上一篇中,我展示了怎么连接X服务器以及怎么创建一个窗口。创建窗口是编写GUI程序的根本。在GUI编程中还有另外两个重点,其一是事件处理,其二是在窗口中绘图。这一篇中,将展示如何使用XCB在窗口中进行绘图。
先看一个示例代码及其运行效果,代码如下:
1 #include <stdlib.h> 2 #include <stdio.h> 3 4 #include <xcb/xcb.h> 5 6 int 7 main () 8 { 9 /* geometric objects */ 10 xcb_point_t points[] = { 11 {40, 40}, 12 {40, 80}, 13 {80, 40}, 14 {80, 80}}; 15 16 xcb_point_t polyline[] = { 17 {200, 40}, 18 { 20, 80}, /* rest of points are relative */ 19 {100,-80}, 20 {40, 40}}; 21 22 xcb_segment_t segments[] = { 23 {400, 40, 560, 120}, 24 {440, 100, 520, 240}}; 25 26 xcb_rectangle_t rectangles[] = { 27 { 40, 200, 160, 80}, 28 { 320, 200, 40, 160}}; 29 30 xcb_arc_t arcs[] = { 31 {40, 400, 240, 160, 0, 90 << 6}, 32 {360, 400, 220, 160, 0, 270 << 6}}; 33 34 35 /* Open the connection to the X server */ 36 xcb_connection_t *connection = xcb_connect (NULL, NULL); 37 38 /* Get the first screen */ 39 xcb_screen_t *screen = xcb_setup_roots_iterator (xcb_get_setup (connection)).data; 40 41 /* Create black (foreground) graphic context */ 42 xcb_drawable_t window = screen->root; 43 xcb_gcontext_t gc = xcb_generate_id (connection); 44 uint32_t mask = XCB_GC_FOREGROUND | XCB_GC_GRAPHICS_EXPOSURES; 45 uint32_t values[2] = {screen->black_pixel, 0}; 46 47 xcb_create_gc (connection, gc, window, mask, values); 48 49 50 /* Create a window */ 51 window = xcb_generate_id (connection); 52 53 mask = XCB_CW_BACK_PIXEL | XCB_CW_EVENT_MASK; 54 values[0] = screen->white_pixel; 55 values[1] = XCB_EVENT_MASK_EXPOSURE; 56 57 xcb_create_window (connection, /* connection */ 58 XCB_COPY_FROM_PARENT, /* depth */ 59 window, /* window Id */ 60 screen->root, /* parent window */ 61 0, 0, /* x, y */ 62 800, 600, /* width, height */ 63 10, /* border_width */ 64 XCB_WINDOW_CLASS_INPUT_OUTPUT, /* class */ 65 screen->root_visual, /* visual */ 66 mask, values ); /* masks */ 67 68 69 /* Map the window on the screen and flush*/ 70 xcb_map_window (connection, window); 71 xcb_flush (connection); 72 73 74 /* draw primitives */ 75 xcb_generic_event_t *event; 76 while ((event = xcb_wait_for_event (connection))) { 77 switch (event->response_type & ~0x80) { 78 case XCB_EXPOSE: 79 /* We draw the points */ 80 xcb_poly_point (connection, XCB_COORD_MODE_ORIGIN, window, gc, 4, points); 81 82 /* We draw the polygonal line */ 83 xcb_poly_line (connection, XCB_COORD_MODE_PREVIOUS, window, gc, 4, polyline); 84 85 /* We draw the segments */ 86 xcb_poly_segment (connection, window, gc, 2, segments); 87 88 /* draw the rectangles */ 89 xcb_poly_rectangle (connection, window, gc, 2, rectangles); 90 91 /* draw the arcs */ 92 xcb_poly_arc (connection, window, gc, 2, arcs); 93 94 /* flush the request */ 95 xcb_flush (connection); 96 97 break; 98 default: 99 /* Unknown event type, ignore it */ 100 break; 101 } 102 103 free (event); 104 } 105 106 return 0; 107 }
运行效果如下图:
下面,对以上GUI绘图的程序进行分析:
1、任何绘图程序,无论使用的是Win32 API,还是Java Swing,都离不开GC和DC的概念,使用XCB编写窗口程序也是如此。这两个概念,一个代表了图怎么绘,一个代表了图绘在哪里。由于绘图时需要指定太多的信息,比如画笔的粗细、线型、前景色、背景色等等,如果把这些信息统统作为参数传递给绘图函数,就会产生两个问题:一是调用这些函数太复杂,二是效率太低。所以,目前所有主流的GUI库都采用了一致的做法,那就是把这些信息组织成一个context,我们称之为graphic context,可简称gcontext或GC。DC可以认为是绘图时所用的画布,我们可以直接把图绘到屏幕上,也可以把图绘到窗口中,当然,也可以绘到控件中(因为控件的本质也是窗口)。在面向对象的编程语言中,可以绘图的组件往往都继承自Drawable。在XCB中,从绘图函数的签名可以看出,它仍然将绘图的目标称为drawable,虽然它只是一个id。
2、什么时候绘图。理论上讲,任何时候都可以调用绘图函数。但是从实践上来讲,所有的GUI程序都是在窗口重绘的事件中调用绘图函数。窗口重绘事件,有的叫onPaint,有的叫onDraw,XCB中比较奇怪,叫EXPOSE。不管叫什么,其道理是一样的。那就是当窗口初次显示、从隐藏到显示或窗口内容需要刷新时,都会触发该事件,所以在处理该事件的代码中调用绘图函数是最好的,既可以保证我们看到绘图的结果,又兼顾效率(窗口不可见时绘图函数不用执行,窗口不变化时绘图函数也不用执行)。MVC模式也是构建在这样的基础之上,将数据与显示分离,数据可以随时被操作,但是绘图只在窗口重绘时进行。
3、调用绘图函数。这个不需要多讲,因为几乎所有的绘图函数都是自解释的,看到函数名,就知道它要进行什么操作。
在XCB中,创建GC可以通过xcb_create_gc()函数进行,创建窗口可以通过xcb_create_window()函数进行。在这两个函数中,都有一个比较奇怪的模式,那就是通过一个mask和value数组来设定GC和窗口的具体信息。在上一篇中,创建的窗口没有背景,而这一篇中,窗口具有白色背景,就是因为这里调用xcb_create_window时,在其mask参数中指定了XCB_CW_BACK_PIXEL。
借助于ctags和Vim的taglist.vim插件,可以非常方便地查看这些mask的取值及其意义,只需按下Ctrl+]就可以跳到相应的定义处。如下两图,是enum xcb_gc_t中定义的一系列XCB_GC_***:
再下面两个图,是创建窗口是可以用到的mask值:
这些枚举都有很详细的注释,所以我就不在这里啰嗦了。libxcb的头文件中的注释,本身就是一种很好的学习资料,不是吗?
(京山游侠于2014-07-05发布于博客园,转载请注明出处。)
使用XCB编写X Window程序(02):在窗口中绘图