使用 Cairo 进行渲染

Cairo 库是一个拥有强大渲染模型的矢量图形库。它具备抗锯齿基元、alpha 合成和渐变等特性。Cairo 针对图像、PDF 文件和在 X 及其他窗口系统上的屏幕提供了多种后端。使用本部分的函数允许 Pango 向 Cairo 表面渲染。

将 Pango 与 Cairo 结合使用非常简单。使用 pango_cairo_font_map_create_context() 创建的 PangoContext 可用于任何 Cairo 上下文（cairo_t），但使用 pango_cairo_update_context() 需要针对 Cairo 上下文的当前变换矩阵和目标表面对其进行更新。如果程序不需要操作 PangoContext 的属性，实用函数 pango_cairo_create_layout() 和 pango_cairo_update_layout() 便可处理常见用例。

当使用诸如 pango_layout_get_extents() 等函数获取布局或布局片段的度量时，所报告的度量均采用用户空间坐标。如果某个文本片段长 10 个单位，且您调用 cairo_scale (cr, 2.0)，其依然会多多少少长 10 个单位。然而，提示信息（即调整文本以在像素网格中显示美观的进程）将影响结果，因此您不应预设度量一定与当前变换矩阵完全无关。请注意，Pango 中的基本度量函数会以整数 Pango 单位报告结果。要获得 Cairo 中使用的浮点单位，请除以 PANGO_SCALE。

使用 Pango 与 Cairo

#include <math.h>
#include <pango/pangocairo.h>

#define RADIUS 150
#define N_WORDS 10
#define FONT "Sans Bold 27"

static void
draw_text (cairo_t *cr)
{
  PangoLayout *layout;
  PangoFontDescription *desc;
  int i;

  /* Center coordinates on the middle of the region we are drawing */
  cairo_translate (cr, RADIUS, RADIUS);

  /* Create a PangoLayout, set the font and text */
  layout = pango_cairo_create_layout (cr);

  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++)
    {
      int width, height;
      double angle = (360. * i) / N_WORDS;
      double red;

      cairo_save (cr);

      /* Gradient from red at angle == 60 to blue at angle == 240 */
      red   = (1 + cos ((angle - 60) * G_PI / 180.)) / 2;
      cairo_set_source_rgb (cr, red, 0, 1.0 - red);

      cairo_rotate (cr, angle * G_PI / 180.);

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

      pango_layout_get_size (layout, &width, &height);
      cairo_move_to (cr, - ((double)width / PANGO_SCALE) / 2, - RADIUS);
      pango_cairo_show_layout (cr, layout);

      cairo_restore (cr);
    }

  /* free the layout object */
  g_object_unref (layout);
}

int
main (int argc, char **argv)
{
  cairo_t *cr;
  char *filename;
  cairo_status_t status;
  cairo_surface_t *surface;

  if (argc != 2)
    {
      g_printerr ("Usage: cairosimple OUTPUT_FILENAME\n");
      return 1;
    }

  filename = argv[1];

  surface = cairo_image_surface_create (CAIRO_FORMAT_ARGB32,
                                        2 * RADIUS, 2 * RADIUS);
  cr = cairo_create (surface);

  cairo_set_source_rgb (cr, 1.0, 1.0, 1.0);
  cairo_paint (cr);
  draw_text (cr);
  cairo_destroy (cr);

  status = cairo_surface_write_to_png (surface, filename);
  cairo_surface_destroy (surface);

  if (status != CAIRO_STATUS_SUCCESS)
    {
      g_printerr ("Could not save png to '%s'\n", filename);
      return 1;
    }

  return 0;
}

在构建并运行上述示例代码后，您应看到以下结果

Output of rotated-example