gtk_symbolic_color_new_literal ()

GtkSymbolicColor *
gtk_symbolic_color_new_literal (const GdkRGBA *color);

Creates a symbolic color pointing to a literal color.

Since 3.0

gtk_symbolic_color_new_name ()

GtkSymbolicColor *
gtk_symbolic_color_new_name (const gchar *name);

Creates a symbolic color pointing to an unresolved named color. See gtk_style_context_lookup_color() and gtk_style_properties_lookup_color().

Since 3.0

gtk_symbolic_color_new_shade ()

GtkSymbolicColor *
gtk_symbolic_color_new_shade (GtkSymbolicColor *color,
                              gdouble factor);

Creates a symbolic color defined as a shade of another color. A factor > 1.0 would resolve to a brighter color, while < 1.0 would resolve to a darker color.

Since 3.0

gtk_symbolic_color_new_alpha ()

GtkSymbolicColor *
gtk_symbolic_color_new_alpha (GtkSymbolicColor *color,
                              gdouble factor);

Creates a symbolic color by modifying the relative alpha value of color . A factor < 1.0 would resolve to a more transparent color, while > 1.0 would resolve to a more opaque color.

Since 3.0

gtk_symbolic_color_new_mix ()

GtkSymbolicColor *
gtk_symbolic_color_new_mix (GtkSymbolicColor *color1,
                            GtkSymbolicColor *color2,
                            gdouble factor);

Creates a symbolic color defined as a mix of another two colors. a mix factor of 0 would resolve to color1 , while a factor of 1 would resolve to color2 .

Since 3.0

gtk_symbolic_color_new_win32 ()

GtkSymbolicColor *
gtk_symbolic_color_new_win32 (const gchar *theme_class,
                              gint id);

Creates a symbolic color based on the current win32 theme.

Note that while this call is available on all platforms the actual value returned is not reliable on non-win32 platforms.

Since 3.4

gtk_symbolic_color_ref ()

GtkSymbolicColor *
gtk_symbolic_color_ref (GtkSymbolicColor *color);

Increases the reference count of color

Since 3.0

gtk_symbolic_color_unref ()

void
gtk_symbolic_color_unref (GtkSymbolicColor *color);

Decreases the reference count of color , freeing its memory if the reference count reaches 0.

Since 3.0

gtk_symbolic_color_resolve ()

gboolean
gtk_symbolic_color_resolve (GtkSymbolicColor *color,
                            GtkStyleProperties *props,
                            GdkRGBA *resolved_color);

If color is resolvable, resolved_color will be filled in with the resolved color, and TRUE will be returned. Generally, if color can’t be resolved, it is due to it being defined on top of a named color that doesn’t exist in props .

When props is NULL, resolving of named colors will fail, so if your color is or references such a color, this function will return FALSE.

Since 3.0

gtk_symbolic_color_to_string ()

char *
gtk_symbolic_color_to_string (GtkSymbolicColor *color);

Converts the given color to a string representation. This is useful both for debugging and for serialization of strings. The format of the string may change between different versions of GTK, but it is guaranteed that the GTK css parser is able to read the string and create the same symbolic color from it.

GtkSymbolicColor

typedef struct _GtkSymbolicColor GtkSymbolicColor;