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>
This commit is contained in:
Sergey Bugaev 2023-08-23 18:13:16 +03:00
parent 4e8e59cd58
commit d07a6b8566
2 changed files with 5 additions and 3 deletions

View File

@ -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
*/

View File

@ -2068,9 +2068,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,