Struct
GtkGradient
Description [src]
struct GtkGradient {
/* No available fields */
}
GtkGradient is a boxed type that represents a gradient. It is the result of parsing a [gradient expression][gtkcssprovider-gradients]. To obtain the gradient represented by a GtkGradient, it has to be resolved with gtk_gradient_resolve(), which replaces all symbolic color references by the colors they refer to (in a given context) and constructs a #cairo_pattern_t value.
It is not normally necessary to deal directly with GtkGradients
,
since they are mostly used behind the scenes by GtkStyleContext
and
GtkCssProvider
.
GtkGradient
is deprecated. It was used internally by GTK’s CSS engine
to represent gradients. As its handling is not conforming to modern
web standards, it is not used anymore. If you want to use gradients in
your own code, please use Cairo directly.
Constructors
gtk_gradient_new_linear
Creates a new linear gradient along the line defined by (x0, y0) and (x1, y1). Before using the gradient a number of stop colors must be added through gtk_gradient_add_color_stop().
deprecated: 3.8 since: 3.0
gtk_gradient_new_radial
Creates a new radial gradient along the two circles defined by (x0, y0, radius0) and (x1, y1, radius1). Before using the gradient a number of stop colors must be added through gtk_gradient_add_color_stop().
deprecated: 3.8 since: 3.0
Instance methods
gtk_gradient_resolve
If gradient
is resolvable, resolved_gradient
will be filled in
with the resolved gradient as a cairo_pattern_t, and TRUE
will
be returned. Generally, if gradient
can’t be resolved, it is
due to it being defined on top of a named color that doesn’t
exist in props
.
deprecated: 3.8 since: 3.0
gtk_gradient_to_string
Creates a string representation for gradient
that is suitable
for using in GTK CSS files.
deprecated: 3.8
gtk_gradient_unref
Decreases the reference count of gradient
, freeing its memory
if the reference count reaches 0.
deprecated: 3.8 since: 3.0