AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity
3a7e9a28d3
gtk2/gtk/gtkcssvalueprivate.h

101 lines
5.5 KiB
C
Raw Normal View History

css: Add GtkCssValue, an immutable refcounted css value
2012-03-06 13:16:08 +00:00
/*
* Copyright © 2012 Red Hat Inc.
*
* 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: Alexander Larsson <alexl@gnome.org>
*/
#ifndef __GTK_CSS_VALUE_PRIVATE_H__
#define __GTK_CSS_VALUE_PRIVATE_H__
#include <glib-object.h>
gtk: Don't include gtkstylecontext.h from gtkcsstypesprivate.h And make sure it's included everywhere it's needed.
2019-03-16 03:48:26 +00:00
css: Add GtkCssValue, an immutable refcounted css value
2012-03-06 13:16:08 +00:00
#include "gtkcsstypesprivate.h"
gtk: Don't include gtkstylecontext.h from gtkcsstypesprivate.h And make sure it's included everywhere it's needed.
2019-03-16 03:48:26 +00:00
#include "gtkstyleprovider.h"
css: Add GtkCssValue, an immutable refcounted css value
2012-03-06 13:16:08 +00:00
G_BEGIN_DECLS
#define GTK_TYPE_CSS_VALUE (_gtk_css_value_get_type ())
cssvalue: Make the structure vtable-based Don't use real classes, just a vtable.
2012-03-26 04:13:57 +00:00
/* A GtkCssValue is a refcounted immutable value type */
css: Add GtkCssValue, an immutable refcounted css value
2012-03-06 13:16:08 +00:00
typedef struct _GtkCssValue GtkCssValue;
cssvalue: Make the structure vtable-based Don't use real classes, just a vtable.
2012-03-26 04:13:57 +00:00
typedef struct _GtkCssValueClass GtkCssValueClass;
css: Add GtkCssValue, an immutable refcounted css value
2012-03-06 13:16:08 +00:00
cssvalue: Make the structure vtable-based Don't use real classes, just a vtable.
2012-03-26 04:13:57 +00:00
/* using define instead of struct here so compilers get the packing right */
#define GTK_CSS_VALUE_BASE \
const GtkCssValueClass *class; \
Replace "gint" with "int"
2020-07-24 13:54:49 +00:00
int ref_count; \
cssvalue: Add is_computed flag When a css value has "child" css values (e.g. a linear gradient has several color stop css values) which are all computed (won't change when compute() is called on them), we want to skip computing the entire subtree. Since css values are immutable, we can set the is_computed flag at construct time. Since GtkCssValue instances are 0-initialized in _gtk_css_value_alloc, the default for is_computed it FALSE. This commit only sets it to TRUE in a few cases, such as various "none" singleton values which will never change. Later commits will refine this and set it for more values.
2020-01-11 11:53:23 +00:00
guint is_computed: 1;
cssvalue: Make the structure vtable-based Don't use real classes, just a vtable.
2012-03-26 04:13:57 +00:00
struct _GtkCssValueClass {
cssvalue: Add type names for all classes This is important to have for debugging and e.g. to print statistics for the individual css value types
2020-01-09 10:57:00 +00:00
const char *type_name;
cssvalue: Make the structure vtable-based Don't use real classes, just a vtable.
2012-03-26 04:13:57 +00:00
void (* free) (GtkCssValue *value);
styleproperty: Make print_func take a GtkCssValue Also, constify GtkCssValue getters, so we can pass a const GtkCssValue to the print_func.
2012-03-26 04:46:29 +00:00
css: Introduce _gtk_css_value_compute() This commit is essentially a large reorganization. Instead of all value subtypes having their own compute function, there is the general _gtk_css_value_compute() function that then calls a vfunc on the subtype.
2012-07-11 04:56:07 +00:00
GtkCssValue * (* compute) (GtkCssValue *value,
css: Pass property_id to compute function This is a reorganization of how value computing should be done. Previously the GtkCssStyleProperty.compute vfunc was supposed to take care of special cases when it needed those for computation. However, this proved to be very complicated in cases where values were nested and only the last value (of a common type) needed to be special cased. A common example for this was the fallback handling for unresolvable colors. Now, we pass the property's ID along with all compute functions so we can do the special casing where it's necessary. Note that no actual changes happen in this commit. This will happen in follow-ups.
2012-07-12 01:43:15 +00:00
guint property_id,
css: Merge GtkStyleProviderPrivate into GtkStyleProvider This is just lots of renaming. The interface remains private, so the public API does not change, apart from removing the definition of the Interface object to avoid subclassing.
2017-10-31 03:31:46 +00:00
GtkStyleProvider *provider,
css: Move scale to GtkStyleProviderPrivate This way, we can remove it as a separate argument from gtk_css_value_compute() and allow computation to only depend on one thing: the style provider.
2015-01-31 10:56:15 +00:00
GtkCssStyle *style,
cssvalue: Remove GtkCssDependencies They are not used anymore.
2015-02-14 01:27:39 +00:00
GtkCssStyle *parent_style);
cssvalue: Add _gtk_css_value_equal() For now, we return FALSE for all default css values, so this is not very useful. I also think of this as an optimization equal, not a guaranteed equal, because we don't even have a notion of what "equal" means. For example, for background-repeat, "repeat, repeat" and "repeat" are functionally equivalent. But the cssvalue has no idea that it's used for background-repeat. As a more complicated example, "repeat, no-repeat" and "repeat" are equal to what one sees as long as there's only one image listed background-image-source. But once you start transition'ing to an image with 2 sources, it's different...
2012-03-26 23:43:12 +00:00
gboolean (* equal) (const GtkCssValue *value1,
const GtkCssValue *value2);
cssvalue: Add _gtk_css_value_transition() Returns a value that transitions between start and end or %NULL if the values cannot be transitioned. So far, all implementations but numbers and rgba return NULL.
2012-03-30 15:47:26 +00:00
GtkCssValue * (* transition) (GtkCssValue *start,
GtkCssValue *end,
cssvalue: Pass property ID to transition function This is to allow animating arrays properly. I'm not really thrilled about this solution (we leak propertys into the values again...), but it's the best I can come up with - I prefer it to having N different array types...
2012-08-30 13:51:29 +00:00
guint property_id,
cssvalue: Add _gtk_css_value_transition() Returns a value that transitions between start and end or %NULL if the values cannot be transitioned. So far, all implementations but numbers and rgba return NULL.
2012-03-30 15:47:26 +00:00
double progress);
Add pure and const annotations to various functions
2020-01-24 12:17:09 +00:00
gboolean (* is_dynamic) (const GtkCssValue *value);
css: Introduce the idea of dynamic values Dynamic values are values that change their contents with the current (monotonic) time. This just introduces the GtkCssValue API for it.
2018-02-13 04:55:33 +00:00
GtkCssValue * (* get_dynamic_value) (GtkCssValue *value,
gint64 monotonic_time);
styleproperty: Make print_func take a GtkCssValue Also, constify GtkCssValue getters, so we can pass a const GtkCssValue to the print_func.
2012-03-26 04:46:29 +00:00
void (* print) (const GtkCssValue *value,
GString *string);
cssvalue: Make the structure vtable-based Don't use real classes, just a vtable.
2012-03-26 04:13:57 +00:00
};
css: Add GtkCssValue, an immutable refcounted css value
2012-03-06 13:16:08 +00:00
GType _gtk_css_value_get_type (void) G_GNUC_CONST;
cssvalue: Make the structure vtable-based Don't use real classes, just a vtable.
2012-03-26 04:13:57 +00:00
GtkCssValue *_gtk_css_value_alloc (const GtkCssValueClass *klass,
gsize size);
#define _gtk_css_value_new(_name, _klass) ((_name *) _gtk_css_value_alloc ((_klass), sizeof (_name)))
css: Introduce the idea of dynamic values Dynamic values are values that change their contents with the current (monotonic) time. This just introduces the GtkCssValue API for it.
2018-02-13 04:55:33 +00:00
#define _gtk_css_value_ref gtk_css_value_ref
GtkCssValue * gtk_css_value_ref (GtkCssValue *value);
#define _gtk_css_value_unref gtk_css_value_unref
void gtk_css_value_unref (GtkCssValue *value);
cssvalue: Make the structure vtable-based Don't use real classes, just a vtable.
2012-03-26 04:13:57 +00:00
css: Introduce _gtk_css_value_compute() This commit is essentially a large reorganization. Instead of all value subtypes having their own compute function, there is the general _gtk_css_value_compute() function that then calls a vfunc on the subtype.
2012-07-11 04:56:07 +00:00
GtkCssValue *_gtk_css_value_compute (GtkCssValue *value,
css: Pass property_id to compute function This is a reorganization of how value computing should be done. Previously the GtkCssStyleProperty.compute vfunc was supposed to take care of special cases when it needed those for computation. However, this proved to be very complicated in cases where values were nested and only the last value (of a common type) needed to be special cased. A common example for this was the fallback handling for unresolvable colors. Now, we pass the property's ID along with all compute functions so we can do the special casing where it's necessary. Note that no actual changes happen in this commit. This will happen in follow-ups.
2012-07-12 01:43:15 +00:00
guint property_id,
css: Merge GtkStyleProviderPrivate into GtkStyleProvider This is just lots of renaming. The interface remains private, so the public API does not change, apart from removing the definition of the Interface object to avoid subclassing.
2017-10-31 03:31:46 +00:00
GtkStyleProvider *provider,
css: Move scale to GtkStyleProviderPrivate This way, we can remove it as a separate argument from gtk_css_value_compute() and allow computation to only depend on one thing: the style provider.
2015-01-31 10:56:15 +00:00
GtkCssStyle *style,
Add pure and const annotations to various functions
2020-01-24 12:17:09 +00:00
GtkCssStyle *parent_style) G_GNUC_PURE;
cssvalue: Add _gtk_css_value_equal() For now, we return FALSE for all default css values, so this is not very useful. I also think of this as an optimization equal, not a guaranteed equal, because we don't even have a notion of what "equal" means. For example, for background-repeat, "repeat, repeat" and "repeat" are functionally equivalent. But the cssvalue has no idea that it's used for background-repeat. As a more complicated example, "repeat, no-repeat" and "repeat" are equal to what one sees as long as there's only one image listed background-image-source. But once you start transition'ing to an image with 2 sources, it's different...
2012-03-26 23:43:12 +00:00
gboolean _gtk_css_value_equal (const GtkCssValue *value1,
Add pure and const annotations to various functions
2020-01-24 12:17:09 +00:00
const GtkCssValue *value2) G_GNUC_PURE;
cssvalue: Add a border value .. and parse border-image-slice with it.
2012-04-04 14:15:41 +00:00
gboolean _gtk_css_value_equal0 (const GtkCssValue *value1,
Add pure and const annotations to various functions
2020-01-24 12:17:09 +00:00
const GtkCssValue *value2) G_GNUC_PURE;
cssvalue: Add _gtk_css_value_transition() Returns a value that transitions between start and end or %NULL if the values cannot be transitioned. So far, all implementations but numbers and rgba return NULL.
2012-03-30 15:47:26 +00:00
GtkCssValue *_gtk_css_value_transition (GtkCssValue *start,
GtkCssValue *end,
cssvalue: Pass property ID to transition function This is to allow animating arrays properly. I'm not really thrilled about this solution (we leak propertys into the values again...), but it's the best I can come up with - I prefer it to having N different array types...
2012-08-30 13:51:29 +00:00
guint property_id,
cssvalue: Add _gtk_css_value_transition() Returns a value that transitions between start and end or %NULL if the values cannot be transitioned. So far, all implementations but numbers and rgba return NULL.
2012-03-30 15:47:26 +00:00
double progress);
Add pure and const annotations to various functions
2020-01-24 12:17:09 +00:00
gboolean gtk_css_value_is_dynamic (const GtkCssValue *value) G_GNUC_PURE;
css: Introduce the idea of dynamic values Dynamic values are values that change their contents with the current (monotonic) time. This just introduces the GtkCssValue API for it.
2018-02-13 04:55:33 +00:00
GtkCssValue * gtk_css_value_get_dynamic_value (GtkCssValue *value,
gint64 monotonic_time);
cssvalue: Add _gtk_css_value_equal() For now, we return FALSE for all default css values, so this is not very useful. I also think of this as an optimization equal, not a guaranteed equal, because we don't even have a notion of what "equal" means. For example, for background-repeat, "repeat, repeat" and "repeat" are functionally equivalent. But the cssvalue has no idea that it's used for background-repeat. As a more complicated example, "repeat, no-repeat" and "repeat" are equal to what one sees as long as there's only one image listed background-image-source. But once you start transition'ing to an image with 2 sources, it's different...
2012-03-26 23:43:12 +00:00
cssvalue: Add _gtk_css_value_to_string() This is a tiny wrapper around _gtk_css_value_print(). It's intended for usage in gdb and printf debugging.
2012-04-01 05:28:35 +00:00
char * _gtk_css_value_to_string (const GtkCssValue *value);
styleproperty: Make print_func take a GtkCssValue Also, constify GtkCssValue getters, so we can pass a const GtkCssValue to the print_func.
2012-03-26 04:46:29 +00:00
void _gtk_css_value_print (const GtkCssValue *value,
GString *string);
cssvalue: Add is_computed flag When a css value has "child" css values (e.g. a linear gradient has several color stop css values) which are all computed (won't change when compute() is called on them), we want to skip computing the entire subtree. Since css values are immutable, we can set the is_computed flag at construct time. Since GtkCssValue instances are 0-initialized in _gtk_css_value_alloc, the default for is_computed it FALSE. This commit only sets it to TRUE in a few cases, such as various "none" singleton values which will never change. Later commits will refine this and set it for more values.
2020-01-11 11:53:23 +00:00
gboolean gtk_css_value_is_computed (const GtkCssValue *value) G_GNUC_PURE;
styleproperty: Make print_func take a GtkCssValue Also, constify GtkCssValue getters, so we can pass a const GtkCssValue to the print_func.
2012-03-26 04:46:29 +00:00
css: Add GtkCssValue, an immutable refcounted css value
2012-03-06 13:16:08 +00:00
G_END_DECLS
#endif /* __GTK_CSS_VALUE_PRIVATE_H__ */
Reference in New Issue Copy Permalink