[pango/pango2: 117/118] context: more docs
- From: Matthias Clasen <matthiasc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [pango/pango2: 117/118] context: more docs
- Date: Tue, 14 Jun 2022 01:34:27 +0000 (UTC)
commit 43a20ce58b7f3820a19f0239af19fe2d006f9fc5
Author: Matthias Clasen <mclasen redhat com>
Date: Mon Jun 13 08:43:27 2022 -0400
context: more docs
pango/pango-context.c | 16 +++++++++++++---
1 file changed, 13 insertions(+), 3 deletions(-)
---
diff --git a/pango/pango-context.c b/pango/pango-context.c
index 66dff58cc..17c7483c0 100644
--- a/pango/pango-context.c
+++ b/pango/pango-context.c
@@ -296,10 +296,14 @@ pango_context_class_init (PangoContextClass *klass)
/**
* PangoContext:matrix: (attributes org.gtk.Property.get=pango_context_get_matrix
org.gtk.Property.set=pango_context_set_matrix)
*
- * The transformation matrix that will be applied when rendering
+ * The 'user to device' transformation that will be applied when rendering
* with this context.
*
- * This matrix is also known as the 'ctm'.
+ * This matrix is also known as the current transformation matrix, or 'ctm'.
+ *
+ * The transformation is needed in cases where the font rendering applies
+ * hinting that depends on knowing the position of text with respect to
+ * the pixel grid. If your font rendering does not
*/
properties[PROP_MATRIX] =
g_param_spec_boxed ("matrix", NULL, NULL, PANGO_TYPE_MATRIX,
@@ -385,9 +389,15 @@ update_resolved_gravity (PangoContext *context)
* @matrix: (nullable): a `PangoMatrix`, or %NULL to unset any existing
* matrix. (No matrix set is the same as setting the identity matrix.)
*
- * Sets the transformation matrix that will be applied when rendering
+ * Sets the 'user to device' transformation that will be applied when rendering
* with this context.
*
+ * This matrix is also known as the current transformation matrix, or 'ctm'.
+ *
+ * The transformation is needed in cases where the font rendering applies
+ * hinting that depends on knowing the position of text with respect to
+ * the pixel grid.
+ *
* Note that reported metrics are in the user space coordinates before
* the application of the matrix, not device-space coordinates after the
* application of the matrix. So, they don't scale with the matrix, though
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]