isa/mutter
1
0
Fork 0
mirror of https://github.com/brl/mutter.git synced 2024-11-23 00:20:42 -05:00
Code Issues Packages Projects Releases Wiki Activity

color: Add initializers for ClutterColor

Browse Source 
Similar to the ones we have for the other boxed types in Clutter.
This commit is contained in:
Emmanuele Bassi 2012-04-13 11:26:38 +01:00
parent 2276f24ffd
commit 0fc4053613
2 changed files with 71 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

52
clutter/clutter-color.c
View File

@ -968,6 +968,12 @@ clutter_color_free (ClutterColor *color)
*
* Creates a new #ClutterColor with the given values.
*
* This function is the equivalent of:
*
* |[
* clutter_color_init (clutter_color_alloc (), red, green, blue, alpha);
* ]|
*
* Return value: (transfer full): the newly allocated color.
* Use clutter_color_free() when done
*
@ -979,9 +985,51 @@ clutter_color_new (guint8 red,
guint8 blue,
guint8 alpha)
{
ClutterColor *color;
return clutter_color_init (clutter_color_alloc (),
red,
green,
blue,
alpha);
}
color = g_slice_new (ClutterColor);
/**
* clutter_color_alloc:
*
* Allocates a new, transparent black #ClutterColor.
*
* Return value: (transfer full): the newly allocated #ClutterColor; use
* clutter_color_free() to free its resources
*
* Since: 1.12
*/
ClutterColor *
clutter_color_alloc (void)
{
return g_slice_new0 (ClutterColor);
}
/**
* clutter_color_init:
* @color: a #ClutterColor
* @red: red component of the color, between 0 and 255
* @green: green component of the color, between 0 and 255
* @blue: blue component of the color, between 0 and 255
* @alpha: alpha component of the color, between 0 and 255
*
* Initializes @color with the given values.
*
* Return value: (transfer none): the initialized #ClutterColor
*
* Since: 1.12
*/
ClutterColor *
clutter_color_init (ClutterColor *color,
guint8 red,
guint8 green,
guint8 blue,
guint8 alpha)
{
g_return_val_if_fail (color != NULL, NULL);
color->red = red;
color->green = green;

19
clutter/clutter-color.h
View File

@ -55,12 +55,31 @@ struct _ClutterColor
guint8 alpha;
};
/**
* CLUTTER_COLOR_INIT:
* @r: value for the red channel, between 0 and 255
* @g: value for the green channel, between 0 and 255
* @b: value for the blue channel, between 0 and 255
* @a: value for the alpha channel, between 0 and 255
*
* A macro that initializes a #ClutterColor, to be used when declaring it.
*
* Since: 1.12
*/
#define CLUTTER_COLOR_INIT(r,g,b,a) { (r), (g), (b), (a) }
GType clutter_color_get_type (void) G_GNUC_CONST;
ClutterColor *clutter_color_new (guint8 red,
guint8 green,
guint8 blue,
guint8 alpha);
ClutterColor *clutter_color_alloc (void);
ClutterColor *clutter_color_init (ClutterColor *color,
guint8 red,
guint8 green,
guint8 blue,
guint8 alpha);
ClutterColor *clutter_color_copy (const ClutterColor *color);
void clutter_color_free (ClutterColor *color);