Using CtkPrintContext in a “draw-page” callback

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

static void
draw_page (CtkPrintOperation *operation,
	   CtkPrintContext   *context,
	   int                page_nr)
{
  cairo_t *cr;
  PangoLayout *layout;
  PangoFontDescription *desc;

  cr = ctk_print_context_get_cairo_context (context);

  // Draw a red rectangle, as wide as the paper (inside the margins)
  cairo_set_source_rgb (cr, 1.0, 0, 0);
  cairo_rectangle (cr, 0, 0, ctk_print_context_get_width (context), 50);

  cairo_fill (cr);

  // Draw some lines
  cairo_move_to (cr, 20, 10);
  cairo_line_to (cr, 40, 20);
  cairo_arc (cr, 60, 60, 20, 0, M_PI);
  cairo_line_to (cr, 80, 20);

  cairo_set_source_rgb (cr, 0, 0, 0);
  cairo_set_line_width (cr, 5);
  cairo_set_line_cap (cr, CAIRO_LINE_CAP_ROUND);
  cairo_set_line_join (cr, CAIRO_LINE_JOIN_ROUND);

  cairo_stroke (cr);

  // Draw some text
  layout = ctk_print_context_create_pango_layout (context);
  pango_layout_set_text (layout, "Hello World! Printing is easy", -1);
  desc = pango_font_description_from_string ("sans 28");
  pango_layout_set_font_description (layout, desc);
  pango_font_description_free (desc);

  cairo_move_to (cr, 30, 20);
  pango_cairo_layout_path (cr, layout);

  // Font Outline
  cairo_set_source_rgb (cr, 0.93, 1.0, 0.47);
  cairo_set_line_width (cr, 0.5);
  cairo_stroke_preserve (cr);

  // Font Fill
  cairo_set_source_rgb (cr, 0, 0.0, 1.0);
  cairo_fill (cr);

  g_object_unref (layout);
}

Printing support was added in CTK+ 2.10.

ctk_print_context_get_cairo_context ()

cairo_t *
ctk_print_context_get_cairo_context (CtkPrintContext *context);

Obtains the cairo context that is associated with the CtkPrintContext.

Since: 2.10

ctk_print_context_set_cairo_context ()

void
ctk_print_context_set_cairo_context (CtkPrintContext *context,
                                     cairo_t *cr,
                                     double dpi_x,
                                     double dpi_y);

Sets a new cairo context on a print context.

This function is intended to be used when implementing an internal print preview, it is not needed for printing, since CTK+ itself creates a suitable cairo context in that case.

Since: 2.10

ctk_print_context_get_page_setup ()

CtkPageSetup *
ctk_print_context_get_page_setup (CtkPrintContext *context);

Obtains the CtkPageSetup that determines the page dimensions of the CtkPrintContext.

Since: 2.10

ctk_print_context_get_width ()

gdouble
ctk_print_context_get_width (CtkPrintContext *context);

Obtains the width of the CtkPrintContext, in pixels.

Since: 2.10

ctk_print_context_get_height ()

gdouble
ctk_print_context_get_height (CtkPrintContext *context);

Obtains the height of the CtkPrintContext, in pixels.

Since: 2.10

ctk_print_context_get_dpi_x ()

gdouble
ctk_print_context_get_dpi_x (CtkPrintContext *context);

Obtains the horizontal resolution of the CtkPrintContext, in dots per inch.

Since: 2.10

ctk_print_context_get_dpi_y ()

gdouble
ctk_print_context_get_dpi_y (CtkPrintContext *context);

Obtains the vertical resolution of the CtkPrintContext, in dots per inch.

Since: 2.10

ctk_print_context_get_pango_fontmap ()

PangoFontMap *
ctk_print_context_get_pango_fontmap (CtkPrintContext *context);

Returns a PangoFontMap that is suitable for use with the CtkPrintContext.

Since: 2.10

ctk_print_context_create_pango_context ()

PangoContext *
ctk_print_context_create_pango_context
                               (CtkPrintContext *context);

Creates a new PangoContext that can be used with the CtkPrintContext.

Since: 2.10

ctk_print_context_create_pango_layout ()

PangoLayout *
ctk_print_context_create_pango_layout (CtkPrintContext *context);

Creates a new PangoLayout that is suitable for use with the CtkPrintContext.

Since: 2.10

ctk_print_context_get_hard_margins ()

gboolean
ctk_print_context_get_hard_margins (CtkPrintContext *context,
                                    gdouble *top,
                                    gdouble *bottom,
                                    gdouble *left,
                                    gdouble *right);

Obtains the hardware printer margins of the CtkPrintContext, in units.

Since: 2.20

CtkPrintContext

typedef struct _CtkPrintContext CtkPrintContext;