From 55097b869512e3805e785c8c8a8bed74654acb42 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Mon, 24 Jan 2022 14:42:26 -0500 Subject: layout-line: Add docs --- pango/pango-layout-line.c | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/pango/pango-layout-line.c b/pango/pango-layout-line.c index eb9f79c8..6d69067f 100644 --- a/pango/pango-layout-line.c +++ b/pango/pango-layout-line.c @@ -11,6 +11,25 @@ #include #include +/** + * PangoLayoutLine: + * + * A `PangoLayoutLine` represents one of the lines resulting from laying + * out a paragraph via `PangoLayout` or `PangoLineBreaker`. + * + * A line consists of a number of runs (i.e. ranges of text with uniform + * script, font and attributes that are shaped as a unit). Runs are + * represented as [struct@Pango.LayoutRun] objects. + * + * A `PangoLayoutLine` always has its origin at the leftmost point of its + * baseline. To position lines in an entire paragraph of text (i.e. in layout + * coordinates), the `PangoLines` object stores X and Y coordinates to + * offset each line to. + * + * The most convenient way to access the visual extents and components + * of a `PangoLayoutLine` is via a [struct@Pango.LayoutIter] iterator. + */ + /* {{{ LineData */ void -- cgit v1.2.1