AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity
5dd8801ee5
gtk2/gsk/gsktransform.h

123 lines
7.5 KiB
C
Raw Normal View History

gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
/*
* 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 <http://www.gnu.org/licenses/>.
*
* Authors: Benjamin Otte <otte@gnome.org>
*/
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
#ifndef __GSK_TRANSFORM_H__
#define __GSK_TRANSFORM_H__
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
#if !defined (__GSK_H_INSIDE__) && !defined (GSK_COMPILATION)
#error "Only <gsk/gsk.h> can be included directly."
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
#endif
transform: Make category public API Also rename it from GskMatrixCategory to GskTransformCategory.
2019-03-01 06:51:23 +00:00
#include <gsk/gskenums.h>
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
#include <gsk/gsktypes.h>
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
G_BEGIN_DECLS
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
#define GSK_TYPE_TRANSFORM (gsk_transform_get_type ())
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
GDK_AVAILABLE_IN_ALL
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
GType gsk_transform_get_type (void) G_GNUC_CONST;
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
GDK_AVAILABLE_IN_ALL
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
GskTransform * gsk_transform_ref (GskTransform *self);
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
GDK_AVAILABLE_IN_ALL
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
void gsk_transform_unref (GskTransform *self);
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
GDK_AVAILABLE_IN_ALL
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
void gsk_transform_print (GskTransform *self,
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
GString *string);
GDK_AVAILABLE_IN_ALL
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
char * gsk_transform_to_string (GskTransform *self);
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
GDK_AVAILABLE_IN_ALL
transform: Add gsk_transform_parse() It uses the new CSS parser.
2019-03-21 04:52:41 +00:00
gboolean gsk_transform_parse (const char *string,
GskTransform **out_transform);
GDK_AVAILABLE_IN_ALL
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
void gsk_transform_to_matrix (GskTransform *self,
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
graphene_matrix_t *out_matrix);
GDK_AVAILABLE_IN_ALL
transform: Redo querying API Make the API expect a tranform of the proper category instead of doing the check ourselves and returning TRUE/FALSE. The benefit is that the mai use case is switch (transform->category) statements and in those we know the category and don't need to check TRUE/FALSE. Using the wrong matrix will now cause a g_warning().
2019-03-04 18:33:04 +00:00
void gsk_transform_to_2d (GskTransform *self,
transform: Add more API In particular, add a per-category querying API for the matrix: - gsk_transform_to_translate() - gsk_transform_to_affine() - gsk_transform_to_2d() - gsk_transform_to_matrix() This way, code can use the relevant one for the given category.
2019-03-01 05:24:33 +00:00
float *out_xx,
float *out_yx,
float *out_xy,
float *out_yy,
float *out_dx,
transform: Redo querying API Make the API expect a tranform of the proper category instead of doing the check ourselves and returning TRUE/FALSE. The benefit is that the mai use case is switch (transform->category) statements and in those we know the category and don't need to check TRUE/FALSE. Using the wrong matrix will now cause a g_warning().
2019-03-04 18:33:04 +00:00
float *out_dy);
transform: Add more API In particular, add a per-category querying API for the matrix: - gsk_transform_to_translate() - gsk_transform_to_affine() - gsk_transform_to_2d() - gsk_transform_to_matrix() This way, code can use the relevant one for the given category.
2019-03-01 05:24:33 +00:00
GDK_AVAILABLE_IN_ALL
transform: Redo querying API Make the API expect a tranform of the proper category instead of doing the check ourselves and returning TRUE/FALSE. The benefit is that the mai use case is switch (transform->category) statements and in those we know the category and don't need to check TRUE/FALSE. Using the wrong matrix will now cause a g_warning().
2019-03-04 18:33:04 +00:00
void gsk_transform_to_affine (GskTransform *self,
transform: Add more API In particular, add a per-category querying API for the matrix: - gsk_transform_to_translate() - gsk_transform_to_affine() - gsk_transform_to_2d() - gsk_transform_to_matrix() This way, code can use the relevant one for the given category.
2019-03-01 05:24:33 +00:00
float *out_scale_x,
float *out_scale_y,
float *out_dx,
transform: Redo querying API Make the API expect a tranform of the proper category instead of doing the check ourselves and returning TRUE/FALSE. The benefit is that the mai use case is switch (transform->category) statements and in those we know the category and don't need to check TRUE/FALSE. Using the wrong matrix will now cause a g_warning().
2019-03-04 18:33:04 +00:00
float *out_dy);
transform: Add more API In particular, add a per-category querying API for the matrix: - gsk_transform_to_translate() - gsk_transform_to_affine() - gsk_transform_to_2d() - gsk_transform_to_matrix() This way, code can use the relevant one for the given category.
2019-03-01 05:24:33 +00:00
GDK_AVAILABLE_IN_ALL
transform: Redo querying API Make the API expect a tranform of the proper category instead of doing the check ourselves and returning TRUE/FALSE. The benefit is that the mai use case is switch (transform->category) statements and in those we know the category and don't need to check TRUE/FALSE. Using the wrong matrix will now cause a g_warning().
2019-03-04 18:33:04 +00:00
void gsk_transform_to_translate (GskTransform *self,
transform: Add more API In particular, add a per-category querying API for the matrix: - gsk_transform_to_translate() - gsk_transform_to_affine() - gsk_transform_to_2d() - gsk_transform_to_matrix() This way, code can use the relevant one for the given category.
2019-03-01 05:24:33 +00:00
float *out_dx,
transform: Redo querying API Make the API expect a tranform of the proper category instead of doing the check ourselves and returning TRUE/FALSE. The benefit is that the mai use case is switch (transform->category) statements and in those we know the category and don't need to check TRUE/FALSE. Using the wrong matrix will now cause a g_warning().
2019-03-04 18:33:04 +00:00
float *out_dy);
transform: Add more API In particular, add a per-category querying API for the matrix: - gsk_transform_to_translate() - gsk_transform_to_affine() - gsk_transform_to_2d() - gsk_transform_to_matrix() This way, code can use the relevant one for the given category.
2019-03-01 05:24:33 +00:00
transform: Make category public API Also rename it from GskMatrixCategory to GskTransformCategory.
2019-03-01 06:51:23 +00:00
GDK_AVAILABLE_IN_ALL
GskTransformCategory gsk_transform_get_category (GskTransform *self) G_GNUC_PURE;
transform: Add more API In particular, add a per-category querying API for the matrix: - gsk_transform_to_translate() - gsk_transform_to_affine() - gsk_transform_to_2d() - gsk_transform_to_matrix() This way, code can use the relevant one for the given category.
2019-03-01 05:24:33 +00:00
GDK_AVAILABLE_IN_ALL
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
gboolean gsk_transform_equal (GskTransform *first,
GskTransform *second) G_GNUC_PURE;
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
GDK_AVAILABLE_IN_ALL
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
GskTransform * gsk_transform_new (void);
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
GDK_AVAILABLE_IN_ALL
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
GskTransform * gsk_transform_transform (GskTransform *next,
transform: Add G_GNUC_WARN_UNUSED_RESULT annotations These functions return the new transform so their return value should really never be ignored.
2019-06-02 08:33:30 +00:00
GskTransform *other) G_GNUC_WARN_UNUSED_RESULT;
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
GDK_AVAILABLE_IN_ALL
transform: Add G_GNUC_WARN_UNUSED_RESULT annotations These functions return the new transform so their return value should really never be ignored.
2019-06-02 08:33:30 +00:00
GskTransform * gsk_transform_invert (GskTransform *self) G_GNUC_WARN_UNUSED_RESULT;
transform: Implement gsk_transform_invert() And use it. And test it.
2019-03-03 16:57:11 +00:00
GDK_AVAILABLE_IN_ALL
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
GskTransform * gsk_transform_matrix (GskTransform *next,
transform: Add G_GNUC_WARN_UNUSED_RESULT annotations These functions return the new transform so their return value should really never be ignored.
2019-06-02 08:33:30 +00:00
const graphene_matrix_t *matrix) G_GNUC_WARN_UNUSED_RESULT;
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
GDK_AVAILABLE_IN_ALL
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
GskTransform * gsk_transform_translate (GskTransform *next,
transform: Add G_GNUC_WARN_UNUSED_RESULT annotations These functions return the new transform so their return value should really never be ignored.
2019-06-02 08:33:30 +00:00
const graphene_point_t *point) G_GNUC_WARN_UNUSED_RESULT;
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
GDK_AVAILABLE_IN_ALL
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
GskTransform * gsk_transform_translate_3d (GskTransform *next,
transform: Add G_GNUC_WARN_UNUSED_RESULT annotations These functions return the new transform so their return value should really never be ignored.
2019-06-02 08:33:30 +00:00
const graphene_point3d_t *point) G_GNUC_WARN_UNUSED_RESULT;
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
GDK_AVAILABLE_IN_ALL
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
GskTransform * gsk_transform_rotate (GskTransform *next,
transform: Add G_GNUC_WARN_UNUSED_RESULT annotations These functions return the new transform so their return value should really never be ignored.
2019-06-02 08:33:30 +00:00
float angle) G_GNUC_WARN_UNUSED_RESULT;
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
GDK_AVAILABLE_IN_ALL
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
GskTransform * gsk_transform_rotate_3d (GskTransform *next,
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
float angle,
transform: Add G_GNUC_WARN_UNUSED_RESULT annotations These functions return the new transform so their return value should really never be ignored.
2019-06-02 08:33:30 +00:00
const graphene_vec3_t *axis) G_GNUC_WARN_UNUSED_RESULT;
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
GDK_AVAILABLE_IN_ALL
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
GskTransform * gsk_transform_scale (GskTransform *next,
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
float factor_x,
transform: Add G_GNUC_WARN_UNUSED_RESULT annotations These functions return the new transform so their return value should really never be ignored.
2019-06-02 08:33:30 +00:00
float factor_y) G_GNUC_WARN_UNUSED_RESULT;
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
GDK_AVAILABLE_IN_ALL
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
GskTransform * gsk_transform_scale_3d (GskTransform *next,
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
float factor_x,
float factor_y,
transform: Add G_GNUC_WARN_UNUSED_RESULT annotations These functions return the new transform so their return value should really never be ignored.
2019-06-02 08:33:30 +00:00
float factor_z) G_GNUC_WARN_UNUSED_RESULT;
transform: Add perspective() This commit adds gsk_transform_perspective(), gtk_snapshot_perspective() and support for perspective() in the CSS syntax.
2019-03-05 08:27:30 +00:00
GDK_AVAILABLE_IN_ALL
GskTransform * gsk_transform_perspective (GskTransform *next,
transform: Add G_GNUC_WARN_UNUSED_RESULT annotations These functions return the new transform so their return value should really never be ignored.
2019-06-02 08:33:30 +00:00
float depth) G_GNUC_WARN_UNUSED_RESULT;
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
transform: Add more API In particular, add a per-category querying API for the matrix: - gsk_transform_to_translate() - gsk_transform_to_affine() - gsk_transform_to_2d() - gsk_transform_to_matrix() This way, code can use the relevant one for the given category.
2019-03-01 05:24:33 +00:00
GDK_AVAILABLE_IN_ALL
void gsk_transform_transform_bounds (GskTransform *self,
const graphene_rect_t *rect,
graphene_rect_t *out_rect);
gtk: Add GtkTransform This is a new object (well, boxed type, but I'm calling it object) for dealing with transform in a more constructive way than graphene_matrix_t by keeping track of how the transform was created. This way, reasoning about the transform becomes easier, and we can create better ways to print it or transition from one transform to another one. An example of this is that while a 0 degree and a 360degree rotation are both the identity matrix, doing a transition between the two would cause a rotation.
2019-02-17 11:54:04 +00:00
G_END_DECLS
transform: Move to GSK The renaming of the prefix makes this a large patch.
2019-02-28 08:52:49 +00:00
#endif /* __GSK_TRANSFORM_H__ */
Reference in New Issue Copy Permalink