/* * Copyright © 2019 Benjamin Otte * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library. If not, see . * * Authors: Benjamin Otte */ /** * SECTION:GskTransform * @Title: GskTransform * @Short_description: A description for transform operations * * #GskTransform is an object to describe transform matrices. Unlike * #graphene_matrix_t, #GskTransform retains the steps in how a transform was * constructed, and allows inspecting them. It is modeled after the way * CSS describes transforms. * * #GskTransform objects are immutable and cannot be changed after creation. * This means code can safely expose them as properties of objects without * having to worry about others changing them. */ #include "config.h" #include "gsktransformprivate.h" typedef struct _GskTransformClass GskTransformClass; struct _GskTransform { const GskTransformClass *transform_class; GskTransformCategory category; GskTransform *next; }; struct _GskTransformClass { gsize struct_size; const char *type_name; void (* finalize) (GskTransform *transform); void (* to_matrix) (GskTransform *transform, graphene_matrix_t *out_matrix); void (* apply_2d) (GskTransform *transform, float *out_xx, float *out_yx, float *out_xy, float *out_yy, float *out_dx, float *out_dy); void (* apply_affine) (GskTransform *transform, float *out_scale_x, float *out_scale_y, float *out_dx, float *out_dy); void (* apply_translate) (GskTransform *transform, float *out_dx, float *out_dy); void (* print) (GskTransform *transform, GString *string); GskTransform * (* apply) (GskTransform *transform, GskTransform *apply_to); GskTransform * (* invert) (GskTransform *transform, GskTransform *next); /* both matrices have the same type */ gboolean (* equal) (GskTransform *first_transform, GskTransform *second_transform); }; /** * GskTransform: (ref-func gsk_transform_ref) (unref-func gsk_transform_unref) * * The `GskTransform` structure contains only private data. */ G_DEFINE_BOXED_TYPE (GskTransform, gsk_transform, gsk_transform_ref, gsk_transform_unref) static gboolean gsk_transform_is_identity (GskTransform *self); static inline gboolean gsk_transform_has_class (GskTransform *self, const GskTransformClass *transform_class) { return self != NULL && self->transform_class == transform_class; } /*< private > * gsk_transform_alloc: * @transform_class: class structure for this self * @category: The category of this transform. Will be used to initialize * the result's category together with &next's category * @next: (transfer full): Next matrix to multiply with or %NULL if none * * Returns: (transfer full): the newly created #GskTransform */ static gpointer gsk_transform_alloc (const GskTransformClass *transform_class, GskTransformCategory category, GskTransform *next) { GskTransform *self; g_return_val_if_fail (transform_class != NULL, NULL); self = g_atomic_rc_box_alloc0 (transform_class->struct_size); self->transform_class = transform_class; self->category = next ? MIN (category, next->category) : category; self->next = gsk_transform_is_identity (next) ? NULL : next; return self; } /*** IDENTITY ***/ static void gsk_identity_transform_finalize (GskTransform *transform) { } static void gsk_identity_transform_to_matrix (GskTransform *transform, graphene_matrix_t *out_matrix) { graphene_matrix_init_identity (out_matrix); } static void gsk_identity_transform_apply_2d (GskTransform *transform, float *out_xx, float *out_yx, float *out_xy, float *out_yy, float *out_dx, float *out_dy) { } static void gsk_identity_transform_apply_affine (GskTransform *transform, float *out_scale_x, float *out_scale_y, float *out_dx, float *out_dy) { } static void gsk_identity_transform_apply_translate (GskTransform *transform, float *out_dx, float *out_dy) { } static void gsk_identity_transform_print (GskTransform *transform, GString *string) { g_string_append (string, "none"); } static GskTransform * gsk_identity_transform_apply (GskTransform *transform, GskTransform *apply_to) { /* We do the following to make sure inverting a non-NULL transform * will return a non-NULL transform. */ if (apply_to) return apply_to; else return gsk_transform_new (); } static GskTransform * gsk_identity_transform_invert (GskTransform *transform, GskTransform *next) { /* We do the following to make sure inverting a non-NULL transform * will return a non-NULL transform. */ if (next) return next; else return gsk_transform_new (); } static gboolean gsk_identity_transform_equal (GskTransform *first_transform, GskTransform *second_transform) { return TRUE; } static const GskTransformClass GSK_IDENTITY_TRANSFORM_CLASS = { sizeof (GskTransform), "GskIdentityMatrix", gsk_identity_transform_finalize, gsk_identity_transform_to_matrix, gsk_identity_transform_apply_2d, gsk_identity_transform_apply_affine, gsk_identity_transform_apply_translate, gsk_identity_transform_print, gsk_identity_transform_apply, gsk_identity_transform_invert, gsk_identity_transform_equal, }; /* * gsk_transform_is_identity: * @transform: (allow-none): A transform or %NULL * * Checks if the transform is a representation of the identity * transform. * * This is different from a transform like `scale(2) scale(0.5)` * which just results in an identity transform when simplified. * * Returns: %TRUE if this transform is a representation of * the identity transform **/ static gboolean gsk_transform_is_identity (GskTransform *self) { return self == NULL || (self->transform_class == &GSK_IDENTITY_TRANSFORM_CLASS && gsk_transform_is_identity (self->next)); } /*** MATRIX ***/ typedef struct _GskMatrixTransform GskMatrixTransform; struct _GskMatrixTransform { GskTransform parent; graphene_matrix_t matrix; }; static void gsk_matrix_transform_finalize (GskTransform *self) { } static void gsk_matrix_transform_to_matrix (GskTransform *transform, graphene_matrix_t *out_matrix) { GskMatrixTransform *self = (GskMatrixTransform *) transform; graphene_matrix_init_from_matrix (out_matrix, &self->matrix); } static void gsk_matrix_transform_apply_2d (GskTransform *transform, float *out_xx, float *out_yx, float *out_xy, float *out_yy, float *out_dx, float *out_dy) { GskMatrixTransform *self = (GskMatrixTransform *) transform; graphene_matrix_t mat; graphene_matrix_init_from_2d (&mat, *out_xx, *out_yx, *out_xy, *out_yy, *out_dx, *out_dy); graphene_matrix_multiply (&self->matrix, &mat, &mat); /* not using graphene_matrix_to_2d() because it may * fail the is_2d() check due to improper rounding */ *out_xx = graphene_matrix_get_value (&mat, 0, 0); *out_yx = graphene_matrix_get_value (&mat, 0, 1); *out_xy = graphene_matrix_get_value (&mat, 1, 0); *out_yy = graphene_matrix_get_value (&mat, 1, 1); *out_dx = graphene_matrix_get_value (&mat, 3, 0); *out_dy = graphene_matrix_get_value (&mat, 3, 1); } static void gsk_matrix_transform_apply_affine (GskTransform *transform, float *out_scale_x, float *out_scale_y, float *out_dx, float *out_dy) { GskMatrixTransform *self = (GskMatrixTransform *) transform; switch (transform->category) { case GSK_TRANSFORM_CATEGORY_UNKNOWN: case GSK_TRANSFORM_CATEGORY_ANY: case GSK_TRANSFORM_CATEGORY_3D: case GSK_TRANSFORM_CATEGORY_2D: default: g_assert_not_reached (); break; case GSK_TRANSFORM_CATEGORY_2D_AFFINE: *out_dx += *out_scale_x * graphene_matrix_get_x_translation (&self->matrix); *out_dy += *out_scale_y * graphene_matrix_get_y_translation (&self->matrix); *out_scale_x *= graphene_matrix_get_x_scale (&self->matrix); *out_scale_y *= graphene_matrix_get_y_scale (&self->matrix); break; case GSK_TRANSFORM_CATEGORY_2D_TRANSLATE: *out_dx += *out_scale_x * graphene_matrix_get_x_translation (&self->matrix); *out_dy += *out_scale_y * graphene_matrix_get_y_translation (&self->matrix); break; case GSK_TRANSFORM_CATEGORY_IDENTITY: break; } } static void gsk_matrix_transform_apply_translate (GskTransform *transform, float *out_dx, float *out_dy) { GskMatrixTransform *self = (GskMatrixTransform *) transform; switch (transform->category) { case GSK_TRANSFORM_CATEGORY_UNKNOWN: case GSK_TRANSFORM_CATEGORY_ANY: case GSK_TRANSFORM_CATEGORY_3D: case GSK_TRANSFORM_CATEGORY_2D: case GSK_TRANSFORM_CATEGORY_2D_AFFINE: default: g_assert_not_reached (); break; case GSK_TRANSFORM_CATEGORY_2D_TRANSLATE: *out_dx += graphene_matrix_get_x_translation (&self->matrix); *out_dy += graphene_matrix_get_y_translation (&self->matrix); break; case GSK_TRANSFORM_CATEGORY_IDENTITY: break; } } static void string_append_double (GString *string, double d) { char buf[G_ASCII_DTOSTR_BUF_SIZE]; g_ascii_formatd (buf, G_ASCII_DTOSTR_BUF_SIZE, "%g", d); g_string_append (string, buf); } static void gsk_matrix_transform_print (GskTransform *transform, GString *string) { GskMatrixTransform *self = (GskMatrixTransform *) transform; guint i; float f[16]; g_string_append (string, "matrix3d("); graphene_matrix_to_float (&self->matrix, f); for (i = 0; i < 16; i++) { if (i > 0) g_string_append (string, ", "); string_append_double (string, f[i]); } g_string_append (string, ")"); } static GskTransform * gsk_matrix_transform_apply (GskTransform *transform, GskTransform *apply_to) { GskMatrixTransform *self = (GskMatrixTransform *) transform; return gsk_transform_matrix_with_category (apply_to, &self->matrix, transform->category); } static GskTransform * gsk_matrix_transform_invert (GskTransform *transform, GskTransform *next) { GskMatrixTransform *self = (GskMatrixTransform *) transform; graphene_matrix_t inverse; if (!graphene_matrix_inverse (&self->matrix, &inverse)) { gsk_transform_unref (next); return NULL; } return gsk_transform_matrix_with_category (next, &inverse, transform->category); } static gboolean gsk_matrix_transform_equal (GskTransform *first_transform, GskTransform *second_transform) { GskMatrixTransform *first = (GskMatrixTransform *) first_transform; GskMatrixTransform *second = (GskMatrixTransform *) second_transform; if (graphene_matrix_equal_fast (&first->matrix, &second->matrix)) return TRUE; return graphene_matrix_equal (&first->matrix, &second->matrix); } static const GskTransformClass GSK_TRANSFORM_TRANSFORM_CLASS = { sizeof (GskMatrixTransform), "GskMatrixTransform", gsk_matrix_transform_finalize, gsk_matrix_transform_to_matrix, gsk_matrix_transform_apply_2d, gsk_matrix_transform_apply_affine, gsk_matrix_transform_apply_translate, gsk_matrix_transform_print, gsk_matrix_transform_apply, gsk_matrix_transform_invert, gsk_matrix_transform_equal, }; GskTransform * gsk_transform_matrix_with_category (GskTransform *next, const graphene_matrix_t *matrix, GskTransformCategory category) { GskMatrixTransform *result = gsk_transform_alloc (&GSK_TRANSFORM_TRANSFORM_CLASS, category, next); graphene_matrix_init_from_matrix (&result->matrix, matrix); return &result->parent; } /** * gsk_transform_matrix: * @next: (allow-none) (transfer full): the next transform * @matrix: the matrix to multiply @next with * * Multiplies @next with the given @matrix. * * Returns: The new matrix **/ GskTransform * gsk_transform_matrix (GskTransform *next, const graphene_matrix_t *matrix) { return gsk_transform_matrix_with_category (next, matrix, GSK_TRANSFORM_CATEGORY_UNKNOWN); } /*** TRANSLATE ***/ typedef struct _GskTranslateTransform GskTranslateTransform; struct _GskTranslateTransform { GskTransform parent; graphene_point3d_t point; }; static void gsk_translate_transform_finalize (GskTransform *self) { } static void gsk_translate_transform_to_matrix (GskTransform *transform, graphene_matrix_t *out_matrix) { GskTranslateTransform *self = (GskTranslateTransform *) transform; graphene_matrix_init_translate (out_matrix, &self->point); } static void gsk_translate_transform_apply_2d (GskTransform *transform, float *out_xx, float *out_yx, float *out_xy, float *out_yy, float *out_dx, float *out_dy) { GskTranslateTransform *self = (GskTranslateTransform *) transform; g_assert (self->point.z == 0.0); *out_dx += *out_xx * self->point.x + *out_xy * self->point.y; *out_dy += *out_yx * self->point.x + *out_yy * self->point.y; } static void gsk_translate_transform_apply_affine (GskTransform *transform, float *out_scale_x, float *out_scale_y, float *out_dx, float *out_dy) { GskTranslateTransform *self = (GskTranslateTransform *) transform; g_assert (self->point.z == 0.0); *out_dx += *out_scale_x * self->point.x; *out_dy += *out_scale_y * self->point.y; } static void gsk_translate_transform_apply_translate (GskTransform *transform, float *out_dx, float *out_dy) { GskTranslateTransform *self = (GskTranslateTransform *) transform; g_assert (self->point.z == 0.0); *out_dx += self->point.x; *out_dy += self->point.y; } static GskTransform * gsk_translate_transform_apply (GskTransform *transform, GskTransform *apply_to) { GskTranslateTransform *self = (GskTranslateTransform *) transform; return gsk_transform_translate_3d (apply_to, &self->point); } static GskTransform * gsk_translate_transform_invert (GskTransform *transform, GskTransform *next) { GskTranslateTransform *self = (GskTranslateTransform *) transform; return gsk_transform_translate_3d (next, &GRAPHENE_POINT3D_INIT (-self->point.x, -self->point.y, -self->point.z)); } static gboolean gsk_translate_transform_equal (GskTransform *first_transform, GskTransform *second_transform) { GskTranslateTransform *first = (GskTranslateTransform *) first_transform; GskTranslateTransform *second = (GskTranslateTransform *) second_transform; return graphene_point3d_equal (&first->point, &second->point); } static void gsk_translate_transform_print (GskTransform *transform, GString *string) { GskTranslateTransform *self = (GskTranslateTransform *) transform; if (self->point.z == 0) g_string_append (string, "translate("); else g_string_append (string, "translate3d("); string_append_double (string, self->point.x); g_string_append (string, ", "); string_append_double (string, self->point.y); if (self->point.z != 0) { g_string_append (string, ", "); string_append_double (string, self->point.z); } g_string_append (string, ")"); } static const GskTransformClass GSK_TRANSLATE_TRANSFORM_CLASS = { sizeof (GskTranslateTransform), "GskTranslateTransform", gsk_translate_transform_finalize, gsk_translate_transform_to_matrix, gsk_translate_transform_apply_2d, gsk_translate_transform_apply_affine, gsk_translate_transform_apply_translate, gsk_translate_transform_print, gsk_translate_transform_apply, gsk_translate_transform_invert, gsk_translate_transform_equal, }; /** * gsk_transform_translate: * @next: (allow-none) (transfer full): the next transform * @point: the point to translate the matrix by * * Translates @next in 2dimensional space by @point. * * Returns: The new matrix **/ GskTransform * gsk_transform_translate (GskTransform *next, const graphene_point_t *point) { graphene_point3d_t point3d; graphene_point3d_init (&point3d, point->x, point->y, 0); return gsk_transform_translate_3d (next, &point3d); } /** * gsk_transform_translate_3d: * @next: (allow-none) (transfer full): the next transform * @point: the point to translate the matrix by * * Translates @next by @point. * * Returns: The new matrix **/ GskTransform * gsk_transform_translate_3d (GskTransform *next, const graphene_point3d_t *point) { GskTranslateTransform *result; if (graphene_point3d_equal (point, graphene_point3d_zero ())) return next; if (gsk_transform_has_class (next, &GSK_TRANSLATE_TRANSFORM_CLASS)) { GskTranslateTransform *t = (GskTranslateTransform *) next; GskTransform *r = gsk_transform_translate_3d (gsk_transform_ref (next->next), &GRAPHENE_POINT3D_INIT(t->point.x + point->x, t->point.y + point->y, t->point.z + point->z)); gsk_transform_unref (next); return r; } result = gsk_transform_alloc (&GSK_TRANSLATE_TRANSFORM_CLASS, point->z == 0.0 ? GSK_TRANSFORM_CATEGORY_2D_TRANSLATE : GSK_TRANSFORM_CATEGORY_3D, next); graphene_point3d_init_from_point (&result->point, point); return &result->parent; } /*** ROTATE ***/ typedef struct _GskRotateTransform GskRotateTransform; struct _GskRotateTransform { GskTransform parent; float angle; }; static void gsk_rotate_transform_finalize (GskTransform *self) { } static inline void _sincos (float deg, float *out_s, float *out_c) { if (deg == 90.0) { *out_c = 0.0; *out_s = 1.0; } else if (deg == 180.0) { *out_c = -1.0; *out_s = 0.0; } else if (deg == 270.0) { *out_c = 0.0; *out_s = -1.0; } else if (deg == 0.0) { *out_c = 1.0; *out_s = 0.0; } else { float angle = deg * M_PI / 180.0; #ifdef HAVE_SINCOSF sincosf (angle, out_s, out_c); #else *out_s = sinf (angle); *out_c = cosf (angle); #endif } } static void gsk_rotate_transform_to_matrix (GskTransform *transform, graphene_matrix_t *out_matrix) { GskRotateTransform *self = (GskRotateTransform *) transform; float c, s; _sincos (self->angle, &s, &c); graphene_matrix_init_from_2d (out_matrix, c, s, -s, c, 0, 0); } static void gsk_rotate_transform_apply_2d (GskTransform *transform, float *out_xx, float *out_yx, float *out_xy, float *out_yy, float *out_dx, float *out_dy) { GskRotateTransform *self = (GskRotateTransform *) transform; float s, c, xx, xy, yx, yy; if (fmodf (self->angle, 360.0f) == 0.0) return; _sincos (self->angle, &s, &c); xx = c * *out_xx + s * *out_xy; yx = c * *out_yx + s * *out_yy; xy = -s * *out_xx + c * *out_xy; yy = -s * *out_yx + c * *out_yy; *out_xx = xx; *out_yx = yx; *out_xy = xy; *out_yy = yy; } static GskTransform * gsk_rotate_transform_apply (GskTransform *transform, GskTransform *apply_to) { GskRotateTransform *self = (GskRotateTransform *) transform; return gsk_transform_rotate (apply_to, self->angle); } static GskTransform * gsk_rotate_transform_invert (GskTransform *transform, GskTransform *next) { GskRotateTransform *self = (GskRotateTransform *) transform; return gsk_transform_rotate (next, - self->angle); } static gboolean gsk_rotate_transform_equal (GskTransform *first_transform, GskTransform *second_transform) { GskRotateTransform *first = (GskRotateTransform *) first_transform; GskRotateTransform *second = (GskRotateTransform *) second_transform; return G_APPROX_VALUE (first->angle, second->angle, 0.01f); } static void gsk_rotate_transform_print (GskTransform *transform, GString *string) { GskRotateTransform *self = (GskRotateTransform *) transform; g_string_append (string, "rotate("); string_append_double (string, self->angle); g_string_append (string, ")"); } static const GskTransformClass GSK_ROTATE_TRANSFORM_CLASS = { sizeof (GskRotateTransform), "GskRotateTransform", gsk_rotate_transform_finalize, gsk_rotate_transform_to_matrix, gsk_rotate_transform_apply_2d, NULL, NULL, gsk_rotate_transform_print, gsk_rotate_transform_apply, gsk_rotate_transform_invert, gsk_rotate_transform_equal, }; static inline float normalize_angle (float angle) { float f; if (angle >= 0 && angle < 360) return angle; f = angle - (360 * ((int)(angle / 360.0))); if (f < 0) f = 360 + f; return f; } /** * gsk_transform_rotate: * @next: (allow-none) (transfer full): the next transform * @angle: the rotation angle, in degrees (clockwise) * * Rotates @next @angle degrees in 2D - or in 3Dspeak, around the z axis. * * Returns: The new matrix **/ GskTransform * gsk_transform_rotate (GskTransform *next, float angle) { GskRotateTransform *result; if (angle == 0.0f) return next; if (gsk_transform_has_class (next, &GSK_ROTATE_TRANSFORM_CLASS)) { GskTransform *r = gsk_transform_rotate (gsk_transform_ref (next->next), ((GskRotateTransform *) next)->angle + angle); gsk_transform_unref (next); return r; } result = gsk_transform_alloc (&GSK_ROTATE_TRANSFORM_CLASS, GSK_TRANSFORM_CATEGORY_2D, next); result->angle = normalize_angle (angle); return &result->parent; } /*** ROTATE 3D ***/ typedef struct _GskRotate3dTransform GskRotate3dTransform; struct _GskRotate3dTransform { GskTransform parent; float angle; graphene_vec3_t axis; }; static void gsk_rotate3d_transform_finalize (GskTransform *self) { } static void gsk_rotate3d_transform_to_matrix (GskTransform *transform, graphene_matrix_t *out_matrix) { GskRotate3dTransform *self = (GskRotate3dTransform *) transform; graphene_matrix_init_rotate (out_matrix, self->angle, &self->axis); } static GskTransform * gsk_rotate3d_transform_apply (GskTransform *transform, GskTransform *apply_to) { GskRotate3dTransform *self = (GskRotate3dTransform *) transform; return gsk_transform_rotate_3d (apply_to, self->angle, &self->axis); } static GskTransform * gsk_rotate3d_transform_invert (GskTransform *transform, GskTransform *next) { GskRotate3dTransform *self = (GskRotate3dTransform *) transform; return gsk_transform_rotate_3d (next, - self->angle, &self->axis); } static gboolean gsk_rotate3d_transform_equal (GskTransform *first_transform, GskTransform *second_transform) { GskRotate3dTransform *first = (GskRotate3dTransform *) first_transform; GskRotate3dTransform *second = (GskRotate3dTransform *) second_transform; return G_APPROX_VALUE (first->angle, second->angle, 0.01f) && graphene_vec3_equal (&first->axis, &second->axis); } static void gsk_rotate3d_transform_print (GskTransform *transform, GString *string) { GskRotate3dTransform *self = (GskRotate3dTransform *) transform; float f[3]; guint i; g_string_append (string, "rotate3d("); graphene_vec3_to_float (&self->axis, f); for (i = 0; i < 3; i++) { string_append_double (string, f[i]); g_string_append (string, ", "); } string_append_double (string, self->angle); g_string_append (string, ")"); } static const GskTransformClass GSK_ROTATE3D_TRANSFORM_CLASS = { sizeof (GskRotate3dTransform), "GskRotate3dTransform", gsk_rotate3d_transform_finalize, gsk_rotate3d_transform_to_matrix, NULL, NULL, NULL, gsk_rotate3d_transform_print, gsk_rotate3d_transform_apply, gsk_rotate3d_transform_invert, gsk_rotate3d_transform_equal, }; /** * gsk_transform_rotate_3d: * @next: (allow-none) (transfer full): the next transform * @angle: the rotation angle, in degrees (clockwise) * @axis: The rotation axis * * Rotates @next @angle degrees around @axis. * * For a rotation in 2D space, use gsk_transform_rotate(). * * Returns: The new matrix **/ GskTransform * gsk_transform_rotate_3d (GskTransform *next, float angle, const graphene_vec3_t *axis) { GskRotate3dTransform *result; if (graphene_vec3_get_x (axis) == 0.0 && graphene_vec3_get_y (axis) == 0.0) return gsk_transform_rotate (next, angle); if (angle == 0.0f) return next; result = gsk_transform_alloc (&GSK_ROTATE3D_TRANSFORM_CLASS, GSK_TRANSFORM_CATEGORY_3D, next); result->angle = normalize_angle (angle); graphene_vec3_init_from_vec3 (&result->axis, axis); return &result->parent; } /*** SCALE ***/ typedef struct _GskScaleTransform GskScaleTransform; struct _GskScaleTransform { GskTransform parent; float factor_x; float factor_y; float factor_z; }; static void gsk_scale_transform_finalize (GskTransform *self) { } static void gsk_scale_transform_to_matrix (GskTransform *transform, graphene_matrix_t *out_matrix) { GskScaleTransform *self = (GskScaleTransform *) transform; graphene_matrix_init_scale (out_matrix, self->factor_x, self->factor_y, self->factor_z); } static void gsk_scale_transform_apply_2d (GskTransform *transform, float *out_xx, float *out_yx, float *out_xy, float *out_yy, float *out_dx, float *out_dy) { GskScaleTransform *self = (GskScaleTransform *) transform; g_assert (self->factor_z == 1.0); *out_xx *= self->factor_x; *out_yx *= self->factor_x; *out_xy *= self->factor_y; *out_yy *= self->factor_y; } static void gsk_scale_transform_apply_affine (GskTransform *transform, float *out_scale_x, float *out_scale_y, float *out_dx, float *out_dy) { GskScaleTransform *self = (GskScaleTransform *) transform; g_assert (self->factor_z == 1.0); *out_scale_x *= self->factor_x; *out_scale_y *= self->factor_y; } static GskTransform * gsk_scale_transform_apply (GskTransform *transform, GskTransform *apply_to) { GskScaleTransform *self = (GskScaleTransform *) transform; return gsk_transform_scale_3d (apply_to, self->factor_x, self->factor_y, self->factor_z); } static GskTransform * gsk_scale_transform_invert (GskTransform *transform, GskTransform *next) { GskScaleTransform *self = (GskScaleTransform *) transform; return gsk_transform_scale_3d (next, 1.f / self->factor_x, 1.f / self->factor_y, 1.f / self->factor_z); } static gboolean gsk_scale_transform_equal (GskTransform *first_transform, GskTransform *second_transform) { GskScaleTransform *first = (GskScaleTransform *) first_transform; GskScaleTransform *second = (GskScaleTransform *) second_transform; return G_APPROX_VALUE (first->factor_x, second->factor_x, FLT_EPSILON) && G_APPROX_VALUE (first->factor_y, second->factor_y, FLT_EPSILON) && G_APPROX_VALUE (first->factor_z, second->factor_z, FLT_EPSILON); } static void gsk_scale_transform_print (GskTransform *transform, GString *string) { GskScaleTransform *self = (GskScaleTransform *) transform; if (self->factor_z == 1.0) { g_string_append (string, "scale("); string_append_double (string, self->factor_x); if (self->factor_x != self->factor_y) { g_string_append (string, ", "); string_append_double (string, self->factor_y); } g_string_append (string, ")"); } else { g_string_append (string, "scale3d("); string_append_double (string, self->factor_x); g_string_append (string, ", "); string_append_double (string, self->factor_y); g_string_append (string, ", "); string_append_double (string, self->factor_z); g_string_append (string, ")"); } } static const GskTransformClass GSK_SCALE_TRANSFORM_CLASS = { sizeof (GskScaleTransform), "GskScaleTransform", gsk_scale_transform_finalize, gsk_scale_transform_to_matrix, gsk_scale_transform_apply_2d, gsk_scale_transform_apply_affine, NULL, gsk_scale_transform_print, gsk_scale_transform_apply, gsk_scale_transform_invert, gsk_scale_transform_equal, }; /** * gsk_transform_scale: * @next: (allow-none) (transfer full): the next transform * @factor_x: scaling factor on the X axis * @factor_y: scaling factor on the Y axis * * Scales @next in 2-dimensional space by the given factors. * Use gsk_transform_scale_3d() to scale in all 3 dimensions. * * Returns: The new matrix **/ GskTransform * gsk_transform_scale (GskTransform *next, float factor_x, float factor_y) { return gsk_transform_scale_3d (next, factor_x, factor_y, 1.0); } /** * gsk_transform_scale_3d: * @next: (allow-none) (transfer full): the next transform * @factor_x: scaling factor on the X axis * @factor_y: scaling factor on the Y axis * @factor_z: scaling factor on the Z axis * * Scales @next by the given factors. * * Returns: The new matrix **/ GskTransform * gsk_transform_scale_3d (GskTransform *next, float factor_x, float factor_y, float factor_z) { GskScaleTransform *result; if (factor_x == 1 && factor_y == 1 && factor_z == 1) return next; if (gsk_transform_has_class (next, &GSK_SCALE_TRANSFORM_CLASS)) { GskScaleTransform *scale = (GskScaleTransform *) next; GskTransform *r = gsk_transform_scale_3d (gsk_transform_ref (next->next), scale->factor_x * factor_x, scale->factor_y * factor_y, scale->factor_z * factor_z); gsk_transform_unref (next); return r; } result = gsk_transform_alloc (&GSK_SCALE_TRANSFORM_CLASS, factor_z != 1.0 ? GSK_TRANSFORM_CATEGORY_3D : GSK_TRANSFORM_CATEGORY_2D_AFFINE, next); result->factor_x = factor_x; result->factor_y = factor_y; result->factor_z = factor_z; return &result->parent; } /*** PERSPECTIVE ***/ typedef struct _GskPerspectiveTransform GskPerspectiveTransform; struct _GskPerspectiveTransform { GskTransform parent; float depth; }; static void gsk_perspective_transform_finalize (GskTransform *self) { } static void gsk_perspective_transform_to_matrix (GskTransform *transform, graphene_matrix_t *out_matrix) { GskPerspectiveTransform *self = (GskPerspectiveTransform *) transform; float f[16] = { 1.f, 0.f, 0.f, 0.f, 0.f, 1.f, 0.f, 0.f, 0.f, 0.f, 1.f, self->depth ? -1.f / self->depth : 0.f, 0.f, 0.f, 0.f, 1.f }; graphene_matrix_init_from_float (out_matrix, f); } static GskTransform * gsk_perspective_transform_apply (GskTransform *transform, GskTransform *apply_to) { GskPerspectiveTransform *self = (GskPerspectiveTransform *) transform; return gsk_transform_perspective (apply_to, self->depth); } static GskTransform * gsk_perspective_transform_invert (GskTransform *transform, GskTransform *next) { GskPerspectiveTransform *self = (GskPerspectiveTransform *) transform; return gsk_transform_perspective (next, - self->depth); } static gboolean gsk_perspective_transform_equal (GskTransform *first_transform, GskTransform *second_transform) { GskPerspectiveTransform *first = (GskPerspectiveTransform *) first_transform; GskPerspectiveTransform *second = (GskPerspectiveTransform *) second_transform; return G_APPROX_VALUE (first->depth, second->depth, 0.001f); } static void gsk_perspective_transform_print (GskTransform *transform, GString *string) { GskPerspectiveTransform *self = (GskPerspectiveTransform *) transform; g_string_append (string, "perspective("); string_append_double (string, self->depth); g_string_append (string, ")"); } static const GskTransformClass GSK_PERSPECTIVE_TRANSFORM_CLASS = { sizeof (GskPerspectiveTransform), "GskPerspectiveTransform", gsk_perspective_transform_finalize, gsk_perspective_transform_to_matrix, NULL, NULL, NULL, gsk_perspective_transform_print, gsk_perspective_transform_apply, gsk_perspective_transform_invert, gsk_perspective_transform_equal, }; /** * gsk_transform_perspective: * @next: (allow-none) (transfer full): the next transform * @depth: distance of the z=0 plane. Lower values give a more * flattened pyramid and therefore a more pronounced * perspective effect. * * Applies a perspective projection transform. This transform * scales points in X and Y based on their Z value, scaling * points with positive Z values away from the origin, and * those with negative Z values towards the origin. Points * on the z=0 plane are unchanged. * * Returns: The new matrix **/ GskTransform * gsk_transform_perspective (GskTransform *next, float depth) { GskPerspectiveTransform *result; if (gsk_transform_has_class (next, &GSK_PERSPECTIVE_TRANSFORM_CLASS)) { GskTransform *r = gsk_transform_perspective (gsk_transform_ref (next->next), ((GskPerspectiveTransform *) next)->depth + depth); gsk_transform_unref (next); return r; } result = gsk_transform_alloc (&GSK_PERSPECTIVE_TRANSFORM_CLASS, GSK_TRANSFORM_CATEGORY_ANY, next); result->depth = depth; return &result->parent; } /*** PUBLIC API ***/ static void gsk_transform_finalize (GskTransform *self) { self->transform_class->finalize (self); gsk_transform_unref (self->next); } /** * gsk_transform_ref: * @self: (allow-none): a #GskTransform * * Acquires a reference on the given #GskTransform. * * Returns: (transfer none): the #GskTransform with an additional reference */ GskTransform * gsk_transform_ref (GskTransform *self) { if (self == NULL) return NULL; return g_atomic_rc_box_acquire (self); } /** * gsk_transform_unref: * @self: (allow-none): a #GskTransform * * Releases a reference on the given #GskTransform. * * If the reference was the last, the resources associated to the @self are * freed. */ void gsk_transform_unref (GskTransform *self) { if (self == NULL) return; g_atomic_rc_box_release_full (self, (GDestroyNotify) gsk_transform_finalize); } /** * gsk_transform_print: * @self: (allow-none): a #GskTransform * @string: The string to print into * * Converts @self into a human-readable string representation suitable * for printing that can later be parsed with gsk_transform_parse(). **/ void gsk_transform_print (GskTransform *self, GString *string) { g_return_if_fail (string != NULL); if (self == NULL) { g_string_append (string, "none"); return; } if (self->next != NULL) { gsk_transform_print (self->next, string); g_string_append (string, " "); } self->transform_class->print (self, string); } /** * gsk_transform_to_string: * @self: (allow-none): a #GskTransform * * Converts a matrix into a string that is suitable for * printing and can later be parsed with gsk_transform_parse(). * * This is a wrapper around gsk_transform_print(), see that function * for details. * * Returns: A new string for @self **/ char * gsk_transform_to_string (GskTransform *self) { GString *string; string = g_string_new (""); gsk_transform_print (self, string); return g_string_free (string, FALSE); } /** * gsk_transform_to_matrix: * @self: (allow-none): a #GskTransform * @out_matrix: (out caller-allocates): The matrix to set * * Computes the actual value of @self and stores it in @out_matrix. * The previous value of @out_matrix will be ignored. **/ void gsk_transform_to_matrix (GskTransform *self, graphene_matrix_t *out_matrix) { graphene_matrix_t m; if (self == NULL) { graphene_matrix_init_identity (out_matrix); return; } gsk_transform_to_matrix (self->next, out_matrix); self->transform_class->to_matrix (self, &m); graphene_matrix_multiply (&m, out_matrix, out_matrix); } /** * gsk_transform_to_2d: * @self: a 2D #GskTransform * @out_xx: (out): return location for the xx member * @out_yx: (out): return location for the yx member * @out_xy: (out): return location for the xy member * @out_yy: (out): return location for the yy member * @out_dx: (out): return location for the x0 member * @out_dy: (out): return location for the y0 member * * Converts a #GskTransform to a 2D transformation * matrix. * @self must be a 2D transformation. If you are not * sure, use gsk_transform_get_category() >= * %GSK_TRANSFORM_CATEGORY_2D to check. * * The returned values have the following layout: * * |[ * | xx yx | | a b 0 | * | xy yy | = | c d 0 | * | dx dy | | tx ty 1 | * ]| * * This function can be used to convert between a #GskTransform * and a matrix type from other 2D drawing libraries, in particular * Cairo. */ void gsk_transform_to_2d (GskTransform *self, float *out_xx, float *out_yx, float *out_xy, float *out_yy, float *out_dx, float *out_dy) { if (self == NULL || self->category < GSK_TRANSFORM_CATEGORY_2D) { if (self != NULL) { char *s = gsk_transform_to_string (self); g_warning ("Given transform \"%s\" is not a 2D transform.", s); g_free (s); } *out_xx = 1.0f; *out_yx = 0.0f; *out_xy = 0.0f; *out_yy = 1.0f; *out_dx = 0.0f; *out_dy = 0.0f; return; } gsk_transform_to_2d (self->next, out_xx, out_yx, out_xy, out_yy, out_dx, out_dy); self->transform_class->apply_2d (self, out_xx, out_yx, out_xy, out_yy, out_dx, out_dy); } /** * gsk_transform_to_affine: * @self: a #GskTransform * @out_scale_x: (out): return location for the scale * factor in the x direction * @out_scale_y: (out): return location for the scale * factor in the y direction * @out_dx: (out): return location for the translation * in the x direction * @out_dy: (out): return location for the translation * in the y direction * * Converts a #GskTransform to 2D affine transformation * factors. * @self must be a 2D transformation. If you are not * sure, use gsk_transform_get_category() >= * %GSK_TRANSFORM_CATEGORY_2D_AFFINE to check. */ void gsk_transform_to_affine (GskTransform *self, float *out_scale_x, float *out_scale_y, float *out_dx, float *out_dy) { if (self == NULL || self->category < GSK_TRANSFORM_CATEGORY_2D_AFFINE) { if (self != NULL) { char *s = gsk_transform_to_string (self); g_warning ("Given transform \"%s\" is not an affine 2D transform.", s); g_free (s); } *out_scale_x = 1.0f; *out_scale_y = 1.0f; *out_dx = 0.0f; *out_dy = 0.0f; return; } gsk_transform_to_affine (self->next, out_scale_x, out_scale_y, out_dx, out_dy); self->transform_class->apply_affine (self, out_scale_x, out_scale_y, out_dx, out_dy); } /** * gsk_transform_to_translate: * @self: a #GskTransform * @out_dx: (out): return location for the translation * in the x direction * @out_dy: (out): return location for the translation * in the y direction * * Converts a #GskTransform to a translation operation. * @self must be a 2D transformation. If you are not * sure, use gsk_transform_get_category() >= * %GSK_TRANSFORM_CATEGORY_2D_TRANSLATE to check. */ void gsk_transform_to_translate (GskTransform *self, float *out_dx, float *out_dy) { if (self == NULL || self->category < GSK_TRANSFORM_CATEGORY_2D_TRANSLATE) { if (self != NULL) { char *s = gsk_transform_to_string (self); g_warning ("Given transform \"%s\" is not a 2D translation.", s); g_free (s); } *out_dx = 0.0f; *out_dy = 0.0f; return; } gsk_transform_to_translate (self->next, out_dx, out_dy); self->transform_class->apply_translate (self, out_dx, out_dy); } /** * gsk_transform_transform: * @next: (allow-none) (transfer full): Transform to apply @other to * @other: (allow-none): Transform to apply * * Applies all the operations from @other to @next. * * Returns: The new matrix **/ GskTransform * gsk_transform_transform (GskTransform *next, GskTransform *other) { if (other == NULL) return next; next = gsk_transform_transform (next, other->next); return other->transform_class->apply (other, next); } /** * gsk_transform_invert: * @self: (allow-none) (transfer full): Transform to invert * * Inverts the given transform. * * If @self is not invertible, %NULL is returned. * Note that inverting %NULL also returns %NULL, which is * the correct inverse of %NULL. If you need to differentiate * between those cases, you should check @self is not %NULL * before calling this function. * * Returns: The inverted transform or %NULL if the transform * cannot be inverted. **/ GskTransform * gsk_transform_invert (GskTransform *self) { GskTransform *result = NULL; GskTransform *cur; for (cur = self; cur; cur = cur->next) { result = cur->transform_class->invert (cur, result); if (result == NULL) break; } gsk_transform_unref (self); return result; } /** * gsk_transform_equal: * @first: the first matrix * @second: the second matrix * * Checks two matrices for equality. Note that matrices need to be literally * identical in their operations, it is not enough that they return the * same result in gsk_transform_to_matrix(). * * Returns: %TRUE if the two matrices can be proven to be equal **/ gboolean gsk_transform_equal (GskTransform *first, GskTransform *second) { if (first == second) return TRUE; if (first == NULL || second == NULL) return FALSE; if (first->transform_class != second->transform_class) return FALSE; if (!gsk_transform_equal (first->next, second->next)) return FALSE; return first->transform_class->equal (first, second); } /** * gsk_transform_get_category: * @self: (allow-none): A #GskTransform * * Returns the category this transform belongs to. * * Returns: The category of the transform **/ GskTransformCategory gsk_transform_get_category (GskTransform *self) { if (self == NULL) return GSK_TRANSFORM_CATEGORY_IDENTITY; return self->category; } /* * gsk_transform_new: (constructor): * * Creates a new identity matrix. This function is meant to be used by language * bindings. For C code, this equivalent to using %NULL. * * Returns: A new identity matrix **/ GskTransform * gsk_transform_new (void) { return gsk_transform_alloc (&GSK_IDENTITY_TRANSFORM_CLASS, GSK_TRANSFORM_CATEGORY_IDENTITY, NULL); } /** * gsk_transform_transform_bounds: * @self: a #GskTransform * @rect: a #graphene_rect_t * @out_rect: (out caller-allocates): return location for the bounds * of the transformed rectangle * * Transforms a #graphene_rect_t using the given transform @self. * The result is the bounding box containing the coplanar quad. **/ void gsk_transform_transform_bounds (GskTransform *self, const graphene_rect_t *rect, graphene_rect_t *out_rect) { switch (gsk_transform_get_category (self)) { case GSK_TRANSFORM_CATEGORY_IDENTITY: graphene_rect_init_from_rect (out_rect, rect); break; case GSK_TRANSFORM_CATEGORY_2D_TRANSLATE: { float dx, dy; gsk_transform_to_translate (self, &dx, &dy); out_rect->origin.x = rect->origin.x + dx; out_rect->origin.y = rect->origin.y + dy; out_rect->size.width = rect->size.width; out_rect->size.height = rect->size.height; } break; case GSK_TRANSFORM_CATEGORY_2D_AFFINE: { float dx, dy, scale_x, scale_y; gsk_transform_to_affine (self, &scale_x, &scale_y, &dx, &dy); out_rect->origin.x = (rect->origin.x * scale_x) + dx; out_rect->origin.y = (rect->origin.y * scale_y) + dy; out_rect->size.width = rect->size.width * scale_x; out_rect->size.height = rect->size.height * scale_y; } break; case GSK_TRANSFORM_CATEGORY_UNKNOWN: case GSK_TRANSFORM_CATEGORY_ANY: case GSK_TRANSFORM_CATEGORY_3D: case GSK_TRANSFORM_CATEGORY_2D: default: { graphene_matrix_t mat; gsk_transform_to_matrix (self, &mat); graphene_matrix_transform_bounds (&mat, rect, out_rect); } break; } } static guint gsk_transform_parse_float (GtkCssParser *parser, guint n, gpointer data) { float *f = data; double d; if (!gtk_css_parser_consume_number (parser, &d)) return 0; f[n] = d; return 1; } static guint gsk_transform_parse_scale (GtkCssParser *parser, guint n, gpointer data) { float *f = data; double d; if (!gtk_css_parser_consume_number (parser, &d)) return 0; f[n] = d; f[1] = d; return 1; } gboolean gsk_transform_parser_parse (GtkCssParser *parser, GskTransform **out_transform) { const GtkCssToken *token; GskTransform *transform = NULL; float f[16] = { 0, }; gboolean parsed_something = FALSE; token = gtk_css_parser_get_token (parser); if (gtk_css_token_is_ident (token, "none")) { gtk_css_parser_consume_token (parser); *out_transform = NULL; return TRUE; } while (TRUE) { if (gtk_css_token_is_function (token, "matrix")) { graphene_matrix_t matrix; if (!gtk_css_parser_consume_function (parser, 6, 6, gsk_transform_parse_float, f)) goto fail; graphene_matrix_init_from_2d (&matrix, f[0], f[1], f[2], f[3], f[4], f[5]); transform = gsk_transform_matrix_with_category (transform, &matrix, GSK_TRANSFORM_CATEGORY_2D); } else if (gtk_css_token_is_function (token, "matrix3d")) { graphene_matrix_t matrix; if (!gtk_css_parser_consume_function (parser, 16, 16, gsk_transform_parse_float, f)) goto fail; graphene_matrix_init_from_float (&matrix, f); transform = gsk_transform_matrix (transform, &matrix); } else if (gtk_css_token_is_function (token, "perspective")) { if (!gtk_css_parser_consume_function (parser, 1, 1, gsk_transform_parse_float, f)) goto fail; transform = gsk_transform_perspective (transform, f[0]); } else if (gtk_css_token_is_function (token, "rotate") || gtk_css_token_is_function (token, "rotateZ")) { if (!gtk_css_parser_consume_function (parser, 1, 1, gsk_transform_parse_float, f)) goto fail; transform = gsk_transform_rotate (transform, f[0]); } else if (gtk_css_token_is_function (token, "rotate3d")) { graphene_vec3_t axis; if (!gtk_css_parser_consume_function (parser, 4, 4, gsk_transform_parse_float, f)) goto fail; graphene_vec3_init (&axis, f[0], f[1], f[2]); transform = gsk_transform_rotate_3d (transform, f[3], &axis); } else if (gtk_css_token_is_function (token, "rotateX")) { if (!gtk_css_parser_consume_function (parser, 1, 1, gsk_transform_parse_float, f)) goto fail; transform = gsk_transform_rotate_3d (transform, f[0], graphene_vec3_x_axis ()); } else if (gtk_css_token_is_function (token, "rotateY")) { if (!gtk_css_parser_consume_function (parser, 1, 1, gsk_transform_parse_float, f)) goto fail; transform = gsk_transform_rotate_3d (transform, f[0], graphene_vec3_y_axis ()); } else if (gtk_css_token_is_function (token, "scale")) { if (!gtk_css_parser_consume_function (parser, 1, 2, gsk_transform_parse_scale, f)) goto fail; transform = gsk_transform_scale (transform, f[0], f[1]); } else if (gtk_css_token_is_function (token, "scale3d")) { if (!gtk_css_parser_consume_function (parser, 3, 3, gsk_transform_parse_float, f)) goto fail; transform = gsk_transform_scale_3d (transform, f[0], f[1], f[2]); } else if (gtk_css_token_is_function (token, "scaleX")) { if (!gtk_css_parser_consume_function (parser, 1, 1, gsk_transform_parse_float, f)) goto fail; transform = gsk_transform_scale (transform, f[0], 1.f); } else if (gtk_css_token_is_function (token, "scaleY")) { if (!gtk_css_parser_consume_function (parser, 1, 1, gsk_transform_parse_float, f)) goto fail; transform = gsk_transform_scale (transform, 1.f, f[0]); } else if (gtk_css_token_is_function (token, "scaleZ")) { if (!gtk_css_parser_consume_function (parser, 1, 1, gsk_transform_parse_float, f)) goto fail; transform = gsk_transform_scale_3d (transform, 1.f, 1.f, f[0]); } else if (gtk_css_token_is_function (token, "translate")) { f[1] = 0.f; if (!gtk_css_parser_consume_function (parser, 1, 2, gsk_transform_parse_float, f)) goto fail; transform = gsk_transform_translate (transform, &GRAPHENE_POINT_INIT (f[0], f[1])); } else if (gtk_css_token_is_function (token, "translate3d")) { if (!gtk_css_parser_consume_function (parser, 3, 3, gsk_transform_parse_float, f)) goto fail; transform = gsk_transform_translate_3d (transform, &GRAPHENE_POINT3D_INIT (f[0], f[1], f[2])); } else if (gtk_css_token_is_function (token, "translateX")) { if (!gtk_css_parser_consume_function (parser, 1, 1, gsk_transform_parse_float, f)) goto fail; transform = gsk_transform_translate (transform, &GRAPHENE_POINT_INIT (f[0], 0.f)); } else if (gtk_css_token_is_function (token, "translateY")) { if (!gtk_css_parser_consume_function (parser, 1, 1, gsk_transform_parse_float, f)) goto fail; transform = gsk_transform_translate (transform, &GRAPHENE_POINT_INIT (0.f, f[0])); } else if (gtk_css_token_is_function (token, "translateZ")) { if (!gtk_css_parser_consume_function (parser, 1, 1, gsk_transform_parse_float, f)) goto fail; transform = gsk_transform_translate_3d (transform, &GRAPHENE_POINT3D_INIT (0.f, 0.f, f[0])); } else if (gtk_css_token_is_function (token, "skew")) { graphene_matrix_t matrix; if (!gtk_css_parser_consume_function (parser, 2, 2, gsk_transform_parse_float, f)) goto fail; f[0] = f[0] / 180.0 * G_PI; f[1] = f[1] / 180.0 * G_PI; graphene_matrix_init_skew (&matrix, f[0], f[1]); transform = gsk_transform_matrix (transform, &matrix); } else if (gtk_css_token_is_function (token, "skewX")) { graphene_matrix_t matrix; if (!gtk_css_parser_consume_function (parser, 1, 1, gsk_transform_parse_float, f)) goto fail; f[0] = f[0] / 180.0 * G_PI; graphene_matrix_init_skew (&matrix, f[0], 0); transform = gsk_transform_matrix (transform, &matrix); } else if (gtk_css_token_is_function (token, "skewY")) { graphene_matrix_t matrix; if (!gtk_css_parser_consume_function (parser, 1, 1, gsk_transform_parse_float, f)) goto fail; f[0] = f[0] / 180.0 * G_PI; graphene_matrix_init_skew (&matrix, 0, f[0]); transform = gsk_transform_matrix (transform, &matrix); } else { break; } parsed_something = TRUE; token = gtk_css_parser_get_token (parser); } if (!parsed_something) { gtk_css_parser_error_syntax (parser, "Expected a transform"); goto fail; } *out_transform = transform; return TRUE; fail: gsk_transform_unref (transform); *out_transform = NULL; return FALSE; } /** * gsk_transform_parse: * @string: the string to parse * @out_transform: (out): The location to put the transform in * * Parses the given @string into a transform and puts it in * @out_transform. Strings printed via gsk_transform_to_string() * can be read in again successfully using this function. * * If @string does not describe a valid transform, %FALSE is * returned and %NULL is put in @out_transform. * * Returns: %TRUE if @string described a valid transform. **/ gboolean gsk_transform_parse (const char *string, GskTransform **out_transform) { GtkCssParser *parser; GBytes *bytes; gboolean result; g_return_val_if_fail (string != NULL, FALSE); g_return_val_if_fail (out_transform != NULL, FALSE); bytes = g_bytes_new_static (string, strlen (string)); parser = gtk_css_parser_new_for_bytes (bytes, NULL, NULL, NULL, NULL, NULL); result = gsk_transform_parser_parse (parser, out_transform); if (result && !gtk_css_parser_has_token (parser, GTK_CSS_TOKEN_EOF)) { g_clear_pointer (out_transform, gsk_transform_unref); result = FALSE; } gtk_css_parser_unref (parser); g_bytes_unref (bytes); return result; }