snapshot, gsktransform: Mention that rotation happens around (0, 0)

...and not around the center of the render node, as one could expect
given that the render node syntax for rotation, transform: rotate(90);,
happens to match the CSS syntax for the same thing, and CSS does rotate
around the center by default.

Signed-off-by: Sergey Bugaev <bugaevc@gmail.com>

diff --git a/gsk/gsktransform.c b/gsk/gsktransform.c
index 4f7174d34938a55db1924814dfc6479cf1b24c5b..ada7164e37afb3800684848cf620b71672d657e2 100644 (file)
--- a/gsk/gsktransform.c
+++ b/gsk/gsktransform.c
@@ -857,7 +857,8 @@ normalize_angle (float angle)
  * @next: (nullable) (transfer full): the next transform
  * @angle: the rotation angle, in degrees (clockwise)
  *
- * Rotates @next @angle degrees in 2D - or in 3D-speak, around the z axis.
+ * Rotates @next @angle degrees in 2D - or in 3D-speak, around the Z axis.
+ * The rotation happens around the origin point of (0, 0).
  *
  * Returns: (nullable): The new transform
  */

diff --git a/gtk/gtksnapshot.c b/gtk/gtksnapshot.c
index d837dc4c26a899101c8a2bfb0ad0a3265dab06d8..1e7327820109ede004f0087d524f2825585788f9 100644 (file)
--- a/gtk/gtksnapshot.c
+++ b/gtk/gtksnapshot.c
@@ -1858,9 +1858,10 @@ gtk_snapshot_translate_3d (GtkSnapshot              *snapshot,
  * @angle: the rotation angle, in degrees (clockwise)
  *
  * Rotates @@snapshot's coordinate system by @angle degrees in 2D space -
- * or in 3D speak, rotates around the Z axis.
+ * or in 3D speak, rotates around the Z axis. The rotation happens around
+ * the origin point of (0, 0) in the @snapshot's current coordinate system.
  *
- * To rotate around other axes, use [method@Gsk.Transform.rotate_3d].
+ * To rotate around axes other than the Z axis, use [method@Gsk.Transform.rotate_3d].
  */
 void
 gtk_snapshot_rotate (GtkSnapshot *snapshot,