From: Matthias Clasen <mclasen@redhat.com>
Date: Fri, 17 Sep 2021 13:57:07 +0000 (-0400)
Subject: transform: Improve docs
X-Git-Tag: archive/raspbian/4.6.5+ds-1+rpi1~1^2~19^2~5^2~338^2~1
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=bef54a382daf64aff32bd55c5e40b80b39713179;p=gtk4.git

transform: Improve docs

Add an example for reconstructing transforms.
---

diff --git a/gsk/gsktransform.c b/gsk/gsktransform.c
index b58eb55aad..439d9340fc 100644
--- a/gsk/gsktransform.c
+++ b/gsk/gsktransform.c
@@ -1530,6 +1530,13 @@ gsk_transform_to_2d (GskTransform *self,
  *
  * Converts a `GskTransform` to 2D affine transformation factors.
  *
+ * To recreate an equivalent transform from the factors returned
+ * by this function, use
+ *
+ *     gsk_transform_scale (gsk_transform_translate (NULL,
+ *                                                   &GRAPHENE_POINT_T (dx, dy)),
+ *                          sx, sy)
+ *
  * @self must be a 2D transformation. If you are not
  * sure, use
  *