transform: Improve docs

Add an example for reconstructing transforms.
2021-09-17 09:57:07 -04:00
parent 6a60214e8c
commit bef54a382d
1 changed files with 7 additions and 0 deletions
--- 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
 *