ClutterColor

typedef struct {
  guint8 red;
  guint8 green;
  guint8 blue;
  
  guint8 alpha;
} ClutterColor;

Color representation.

clutter_color_copy ()

ClutterColor*       clutter_color_copy                  (const ClutterColor *color);

Makes a copy of the color structure. The result must be freed using clutter_color_free().

Since 0.2

clutter_color_free ()

void                clutter_color_free                  (ClutterColor *color);

Frees a color structure created with clutter_color_copy().

Since 0.2

clutter_color_parse ()

gboolean            clutter_color_parse                 (const gchar *color,
                                                         ClutterColor *dest);

Parses a string definition of a color, filling the red, green, blue and alpha channels of dest. If alpha is not specified it will be set full opaque. The color in dest is not allocated.

The color may be defined by any of the formats understood by pango_color_parse; these include literal color names, like Red or DarkSlateGray, or hexadecimal specifications like #3050b2 or #333.

Since 0.2

clutter_color_from_hls ()

void                clutter_color_from_hls              (ClutterColor *dest,
                                                         guint8 hue,
                                                         guint8 luminance,
                                                         guint8 saturation);

Converts a color expressed in HLS (hue, luminance and saturation) values into a ClutterColor.

clutter_color_from_hlsx ()

void                clutter_color_from_hlsx             (ClutterColor *dest,
                                                         ClutterFixed hue,
                                                         ClutterFixed luminance,
                                                         ClutterFixed saturation);

Converts a color expressed in HLS (hue, luminance and saturation) values into a ClutterColor.

clutter_color_from_pixel ()

void                clutter_color_from_pixel            (ClutterColor *dest,
                                                         guint32 pixel);

Converts pixel from the packed representation of a four 8 bit channel color to a ClutterColor.

clutter_color_add ()

void                clutter_color_add                   (const ClutterColor *src1,
                                                         const ClutterColor *src2,
                                                         ClutterColor *dest);

Adds src2 to src1 and saves the resulting color inside dest.

The alpha channel of dest is as the maximum value between the alpha channels of src1 and src2.

clutter_color_subtract ()

void                clutter_color_subtract              (const ClutterColor *src1,
                                                         const ClutterColor *src2,
                                                         ClutterColor *dest);

Subtracts src2 from src1 and saves the resulting color inside dest. This function assumes that the components of src1 are greater than the components of src2; the result is, otherwise, undefined.

The alpha channel of dest is set as the minimum value between the alpha channels of src1 and src2.

clutter_color_equal ()

gboolean            clutter_color_equal                 (const ClutterColor *a,
                                                         const ClutterColor *b);

Compares two ClutterColors and checks if they are the same.

Since 0.2

clutter_color_lighten ()

void                clutter_color_lighten               (const ClutterColor *src,
                                                         ClutterColor *dest);

Lightens src by a fixed amount, and saves the changed color in dest.

clutter_color_darken ()

void                clutter_color_darken                (const ClutterColor *src,
                                                         ClutterColor *dest);

Darkens src by a fixed amount, and saves the changed color in dest.

clutter_color_shade ()

void                clutter_color_shade                 (const ClutterColor *src,
                                                         ClutterColor *dest,
                                                         gdouble shade);

Shades src by the factor of shade and saves the modified color into dest.

clutter_color_shadex ()

void                clutter_color_shadex                (const ClutterColor *src,
                                                         ClutterColor *dest,
                                                         ClutterFixed shade);

Fixed point version of clutter_color_shade().

Shades src by the factor of shade and saves the modified color into dest.

Since 0.2

clutter_color_to_hls ()

void                clutter_color_to_hls                (const ClutterColor *src,
                                                         guint8 *hue,
                                                         guint8 *luminance,
                                                         guint8 *saturation);

Converts src to the HLS format. Returned HLS values are from interval 0 .. 255.

clutter_color_to_hlsx ()

void                clutter_color_to_hlsx               (const ClutterColor *src,
                                                         ClutterFixed *hue,
                                                         ClutterFixed *luminance,
                                                         ClutterFixed *saturation);

Converts src to the HLS format. Returned hue is in degrees (0 .. 360), luminance and saturation from interval <0 .. 1>.

clutter_color_to_pixel ()

guint32             clutter_color_to_pixel              (const ClutterColor *src);

Converts src into a packed 32 bit integer, containing all the four 8 bit channels used by ClutterColor.

clutter_color_to_string ()

gchar*              clutter_color_to_string             (const ClutterColor *color);

Returns a textual specification of color in the hexadecimal form #rrggbbaa, where r, g, b and a are hex digits representing the red, green, blue and alpha components respectively.

Since 0.2