[pango/line-breaker] layout-line: Add docs
- From: Matthias Clasen <matthiasc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [pango/line-breaker] layout-line: Add docs
- Date: Mon, 24 Jan 2022 19:52:52 +0000 (UTC)
commit 60a2f824b1069781fe75d38c8bf4c595de82fc13
Author: Matthias Clasen <mclasen redhat com>
Date: Mon Jan 24 14:42:26 2022 -0500
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..409652aa 100644
--- a/pango/pango-layout-line.c
+++ b/pango/pango-layout-line.c
@@ -11,6 +11,25 @@
#include <math.h>
#include <hb-ot.h>
+/**
+ * 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 [class@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 [class@Pango.LayoutIter] iterator.
+ */
+
/* {{{ LineData */
void
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]