summaryrefslogtreecommitdiff
path: root/docs/pango_rendering.md
blob: 9dfddd55b55bbf40767359ada7992d36c247fbd8 (plain)
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
---
Title: The Rendering Pipeline
---

# The Rendering Pipeline

The Pango rendering pipeline takes a string of Unicode characters, converts them
it into glyphs, and renders them on some output medium. This section describes the
various stages of this pipeline and the APIs that implement them.

<picture>
  <source srcset="pipeline-dark.png" media="(prefers-color-scheme: dark)">
  <img alt="Pango Rendering Pipeline" src="pipeline-light.png">
</picture>

Itemization
: breaks a piece of text into segments with consistent direction and shaping
  properies. Among other things, this determines which font to use for each
  character. Use pango_itemize() or pango_itemize_with_base_dir() to itemize text.

Shaping
: converts characters into glyphs. Use pango_shape(), pango_shape_full() or
  pango_shape_with_flags() to shape text.

Line Breaking
: determines where line breaks should be inserted into a sequence of glyphs.
  The function pango_break() determines possible line breaks. The actual line
  breaking is done by [class@Pango.Layout].

Justification
: adjusts inter-word spacing to form lines of even length. This is done by
  [class@Pango.Layout].

Rendering
: takes a string of positioned glyphs, and renders them onto a surface. This is
  accomplished by a [class@Pango.Renderer] object. The functions
  pango_cairo_show_glyph_string() and pango_cairo_show_layout() use a
  [class@Pango.Renderer] to draw text onto a cairo surface.