From bef54a382daf64aff32bd55c5e40b80b39713179 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Fri, 17 Sep 2021 09:57:07 -0400
Subject: transform: Improve docs

Add an example for reconstructing transforms.
---
 gsk/gsktransform.c | 7 +++++++
 1 file changed, 7 insertions(+)

(limited to 'gsk/gsktransform.c')

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
  *
-- 
cgit v1.2.1