Top | ![]() |
![]() |
![]() |
![]() |
GtkGradient * | gtk_gradient_new_linear () |
GtkGradient * | gtk_gradient_new_radial () |
void | gtk_gradient_add_color_stop () |
GtkGradient * | gtk_gradient_ref () |
void | gtk_gradient_unref () |
gboolean | gtk_gradient_resolve () |
char * | gtk_gradient_to_string () |
GtkGradient is a boxed type that represents a gradient. It is the result of parsing a
gradient expression.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 * gtk_gradient_new_linear (gdouble x0
,gdouble y0
,gdouble x1
,gdouble y1
);
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()
.
x0 |
X coordinate of the starting point |
|
y0 |
Y coordinate of the starting point |
|
x1 |
X coordinate of the end point |
|
y1 |
Y coordinate of the end point |
Since 3.0
GtkGradient * gtk_gradient_new_radial (gdouble x0
,gdouble y0
,gdouble radius0
,gdouble x1
,gdouble y1
,gdouble radius1
);
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()
.
x0 |
X coordinate of the start circle |
|
y0 |
Y coordinate of the start circle |
|
radius0 |
radius of the start circle |
|
x1 |
X coordinate of the end circle |
|
y1 |
Y coordinate of the end circle |
|
radius1 |
radius of the end circle |
Since 3.0
void gtk_gradient_add_color_stop (GtkGradient *gradient
,gdouble offset
,GtkSymbolicColor *color
);
Adds a stop color to gradient
.
Since 3.0
GtkGradient *
gtk_gradient_ref (GtkGradient *gradient
);
Increases the reference count of gradient
.
Since 3.0
void
gtk_gradient_unref (GtkGradient *gradient
);
Decreases the reference count of gradient
, freeing its memory
if the reference count reaches 0.
Since 3.0
gboolean gtk_gradient_resolve (GtkGradient *gradient
,GtkStyleProperties *props
,cairo_pattern_t **resolved_gradient
);
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
.
gradient |
||
props |
GtkStyleProperties to use when resolving named colors |
|
resolved_gradient |
return location for the resolved pattern. |
[out] |
Since 3.0
char *
gtk_gradient_to_string (GtkGradient *gradient
);
Creates a string representation for gradient
that is suitable
for using in GTK CSS files.