diff options
| author | Matthias Clasen <mclasen@redhat.com> | 2021-08-08 21:56:40 +0000 |
|---|---|---|
| committer | Matthias Clasen <mclasen@redhat.com> | 2021-08-08 21:56:40 +0000 |
| commit | ed13e662d1a327671fc9f1a3ec7d71c4bbfe1280 (patch) | |
| tree | eb3e28c6d7b30bb240d30030e9680590469c28c1 /docs/pango_rendering.md | |
| parent | d6598871faaf2a44052ad1b738f4a8b84fe12cd0 (diff) | |
| parent | d20b0c92ff117c62fdacfc1bc1075730013a969d (diff) | |
| download | pango-ed13e662d1a327671fc9f1a3ec7d71c4bbfe1280.tar.gz | |
Merge branch 'layout-docs' into 'main'
docs: Fix up deps for images
See merge request GNOME/pango!395
Diffstat (limited to 'docs/pango_rendering.md')
| -rw-r--r-- | docs/pango_rendering.md | 20 |
1 files changed, 12 insertions, 8 deletions
diff --git a/docs/pango_rendering.md b/docs/pango_rendering.md index 2fd61e93..2745c0c0 100644 --- a/docs/pango_rendering.md +++ b/docs/pango_rendering.md @@ -8,28 +8,32 @@ 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. + character. Use [func@Pango.itemize] or [func@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. +: converts characters into glyphs. Use [func@Pango.shape], + [func@Pango.shape_full] or [func@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]. + The function [func@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 +: 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. |