c - 我在哪里可以找到 xcb 库的实现？

Question

我尝试学习 xcb 并且由于文档非常稀疏，我想研究方法本身的实现。例如，xcb_poly_line 方法的定义在源代码中没有给出 https://github.com/stapelberg/libxcb/tree/master/src .但是，当我包含它时它就起作用了。

Answer 1

XCB 中的大多数协议(protocol)绑定(bind)都是在构建时根据协议(protocol)的 XML 描述自动生成的。因此，要获得“真正的源代码”，您必须自己构建 XCB(但您不必安装它，因为要构建，首先会生成 C 源代码)。

但是，我认为生成的源代码不是很有用。您请求 xcb_poly_line。此请求的 XCB 描述如下所示(取自 https://gitlab.freedesktop.org/xorg/proto/xcbproto/blob/master/src/xproto.xml ):

  <request name="PolyLine" opcode="65" combine-adjacent="true">
    <field type="BYTE" name="coordinate_mode" enum="CoordMode" />
    <field type="DRAWABLE" name="drawable" />
    <field type="GCONTEXT" name="gc" />
    <list type="POINT" name="points" />
    <doc>
      [snip]
    </doc>
  </request>

在构建期间，会生成一个名为 xproto.c 的文件。其中，xcb_poly_line 定义如下:

xcb_void_cookie_t
xcb_poly_line (xcb_connection_t  *c,
               uint8_t            coordinate_mode,
               xcb_drawable_t     drawable,
               xcb_gcontext_t     gc,
               uint32_t           points_len,
               const xcb_point_t *points)
{
    static const xcb_protocol_request_t xcb_req = {
        .count = 4,
        .ext = 0,
        .opcode = XCB_POLY_LINE,
        .isvoid = 1
    };

    struct iovec xcb_parts[6];
    xcb_void_cookie_t xcb_ret;
    xcb_poly_line_request_t xcb_out;

    xcb_out.coordinate_mode = coordinate_mode;
    xcb_out.drawable = drawable;
    xcb_out.gc = gc;

    xcb_parts[2].iov_base = (char *) &xcb_out;
    xcb_parts[2].iov_len = sizeof(xcb_out);
    xcb_parts[3].iov_base = 0;
    xcb_parts[3].iov_len = -xcb_parts[2].iov_len & 3;
    /* xcb_point_t points */
    xcb_parts[4].iov_base = (char *) points;
    xcb_parts[4].iov_len = points_len * sizeof(xcb_point_t);
    xcb_parts[5].iov_base = 0;
    xcb_parts[5].iov_len = -xcb_parts[4].iov_len & 3;

    xcb_ret.sequence = xcb_send_request(c, 0, xcb_parts + 2, &xcb_req);
    return xcb_ret;
}

这个函数只接受给定的参数并将它们发送到 X11 服务器。没有应用任何魔法。

在 X.org X11 服务器中，PolyLine 请求由函数 ProcPolyLine 处理。它的实现很可能也不会给你太多启发:https://cgit.freedesktop.org/xorg/xserver/tree/dix/dispatch.c#n1802