Pango 交互操作 [src]

Pango 是 GDK 和 GTK 使用的文本布局系统。本节中的函数和类型用于获取 PangoLayout 的剪辑区域,并获取可与 GDK 配合使用的 PangoContext。

在 GDK 中使用 Pango

创建 PangoLayout 对象是渲染文本的第一步,需要获取到 PangoContext 的句柄。对于 GTK 程序,通常需要使用 Gtk.Widget.get_pango_context 或 Gtk.Widget.create_pango_layout。获取 PangoLayout 后,可以使用 Pango 函数(如 pango_layout_set_text())设置文本和属性,并可以使用 pango_layout_get_size() 获取其大小。

注意:Pango 在内部使用固定点系统,因此可以使用 PANGO_SCALEPANGO_PIXELS() 宏在 Pango 单位和像素之间进行转换。

pango_cairo_show_layout() 可以最简单地渲染 Pango 布局;也可以用 pango_cairo_show_layout_line() 绘制布局的一部分。

使用 Pango 和 cairo 绘制变换后的文本

#define RADIUS 100
#define N_WORDS 10
#define FONT "Sans Bold 18"

PangoContext *context;
PangoLayout *layout;
PangoFontDescription *desc;

double radius;
int width, height;
int i;

// Set up a transformation matrix so that the user space coordinates for
// where we are drawing are [-RADIUS, RADIUS], [-RADIUS, RADIUS]
// We first center, then change the scale

width = gdk_surface_get_width (surface);
height = gdk_surface_get_height (surface);
radius = MIN (width, height) / 2.;

cairo_translate (cr,
                 radius + (width - 2 * radius) / 2,
                 radius + (height - 2 * radius) / 2);
                 cairo_scale (cr, radius / RADIUS, radius / RADIUS);

// Create a PangoLayout, set the font and text
context = gdk_pango_context_get_for_display (display);
layout = pango_layout_new (context);
pango_layout_set_text (layout, "Text", -1);
desc = pango_font_description_from_string (FONT);
pango_layout_set_font_description (layout, desc);
pango_font_description_free (desc);

// Draw the layout N_WORDS times in a circle
for (i = 0; i < N_WORDS; i++)
  {
    double red, green, blue;
    double angle = 2 * G_PI * i / n_words;

    cairo_save (cr);

    // Gradient from red at angle == 60 to blue at angle == 300
    red = (1 + cos (angle - 60)) / 2;
    green = 0;
    blue = 1 - red;

    cairo_set_source_rgb (cr, red, green, blue);
    cairo_rotate (cr, angle);

    // Inform Pango to re-layout the text with the new transformation matrix
    pango_cairo_update_layout (cr, layout);

    pango_layout_get_size (layout, &width, &height);

    cairo_move_to (cr, - width / 2 / PANGO_SCALE, - DEFAULT_TEXT_RADIUS);
    pango_cairo_show_layout (cr, layout);

    cairo_restore (cr);
  }

g_object_unref (layout);
g_object_unref (context);

上面的示例代码将产生以下结果