99bef3116d
This is to try and improve API consistency. Simple cogl structures that don't derive from CoglObject and which can be allocated on the stack, such as CoglColor and CoglMatrix should all have "_init" or "_init_from" functions to initialize all the structure members. (As opposed to a cogl_xyz_new() function for CoglObjects). CoglColor previously used the naming scheme "_set_from" for these initializers but "_set" is typically reserved for setting individual properties of a structure/object. This adds three _init functions: cogl_color_init_from_4ub cogl_color_init_from_4f cogl_color_init_from_4fv The _set_from functions are now deprecated but only with a gtk-doc annotation for now. This is because the cogl_color_set_from API is quite widely used already and so were giving a grace period before enabling a GCC deprecated warning just because otherwise the MX maintainers will complain to me that I've made their build logs look messy.
314 lines
6.4 KiB
C
314 lines
6.4 KiB
C
/*
|
|
* Cogl
|
|
*
|
|
* An object oriented GL/GLES Abstraction/Utility Layer
|
|
*
|
|
* Copyright (C) 2008,2009 Intel Corporation.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
*
|
|
*/
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
#include "config.h"
|
|
#endif
|
|
|
|
#include <string.h>
|
|
|
|
#include "cogl.h"
|
|
#include "cogl-color.h"
|
|
#include "cogl-fixed.h"
|
|
|
|
CoglColor *
|
|
cogl_color_new (void)
|
|
{
|
|
return g_slice_new (CoglColor);
|
|
}
|
|
|
|
CoglColor *
|
|
cogl_color_copy (const CoglColor *color)
|
|
{
|
|
if (G_LIKELY (color))
|
|
return g_slice_dup (CoglColor, color);
|
|
|
|
return NULL;
|
|
}
|
|
|
|
void
|
|
cogl_color_free (CoglColor *color)
|
|
{
|
|
if (G_LIKELY (color))
|
|
g_slice_free (CoglColor, color);
|
|
}
|
|
|
|
void
|
|
cogl_color_init_from_4ub (CoglColor *color,
|
|
guint8 red,
|
|
guint8 green,
|
|
guint8 blue,
|
|
guint8 alpha)
|
|
{
|
|
g_return_if_fail (color != NULL);
|
|
|
|
color->red = red;
|
|
color->green = green;
|
|
color->blue = blue;
|
|
color->alpha = alpha;
|
|
}
|
|
|
|
/* XXX: deprecated, use cogl_color_init_from_4ub */
|
|
void
|
|
cogl_color_set_from_4ub (CoglColor *dest,
|
|
guint8 red,
|
|
guint8 green,
|
|
guint8 blue,
|
|
guint8 alpha)
|
|
{
|
|
cogl_color_init_from_4ub (dest, red, green, blue, alpha);
|
|
}
|
|
|
|
void
|
|
cogl_color_init_from_4f (CoglColor *color,
|
|
float red,
|
|
float green,
|
|
float blue,
|
|
float alpha)
|
|
{
|
|
g_return_if_fail (color != NULL);
|
|
|
|
color->red = (red * 255);
|
|
color->green = (green * 255);
|
|
color->blue = (blue * 255);
|
|
color->alpha = (alpha * 255);
|
|
}
|
|
|
|
/* XXX: deprecated, use cogl_color_init_from_4f */
|
|
void
|
|
cogl_color_set_from_4f (CoglColor *color,
|
|
float red,
|
|
float green,
|
|
float blue,
|
|
float alpha)
|
|
{
|
|
cogl_color_init_from_4f (color, red, green, blue, alpha);
|
|
}
|
|
|
|
void
|
|
cogl_color_init_from_4fv (CoglColor *color,
|
|
float *color_array)
|
|
{
|
|
g_return_if_fail (color != NULL);
|
|
|
|
color->red = (color_array[0] * 255);
|
|
color->green = (color_array[1] * 255);
|
|
color->blue = (color_array[2] * 255);
|
|
color->alpha = (color_array[3] * 255);
|
|
}
|
|
|
|
unsigned char
|
|
cogl_color_get_red_byte (const CoglColor *color)
|
|
{
|
|
return color->red;
|
|
}
|
|
|
|
float
|
|
cogl_color_get_red_float (const CoglColor *color)
|
|
{
|
|
return (float) color->red / 255.0;
|
|
}
|
|
|
|
float
|
|
cogl_color_get_red (const CoglColor *color)
|
|
{
|
|
return ((float) color->red / 255.0);
|
|
}
|
|
|
|
unsigned char
|
|
cogl_color_get_green_byte (const CoglColor *color)
|
|
{
|
|
return color->green;
|
|
}
|
|
|
|
float
|
|
cogl_color_get_green_float (const CoglColor *color)
|
|
{
|
|
return (float) color->green / 255.0;
|
|
}
|
|
|
|
float
|
|
cogl_color_get_green (const CoglColor *color)
|
|
{
|
|
return ((float) color->green / 255.0);
|
|
}
|
|
|
|
unsigned char
|
|
cogl_color_get_blue_byte (const CoglColor *color)
|
|
{
|
|
return color->blue;
|
|
}
|
|
|
|
float
|
|
cogl_color_get_blue_float (const CoglColor *color)
|
|
{
|
|
return (float) color->blue / 255.0;
|
|
}
|
|
|
|
float
|
|
cogl_color_get_blue (const CoglColor *color)
|
|
{
|
|
return ((float) color->blue / 255.0);
|
|
}
|
|
|
|
unsigned char
|
|
cogl_color_get_alpha_byte (const CoglColor *color)
|
|
{
|
|
return color->alpha;
|
|
}
|
|
|
|
float
|
|
cogl_color_get_alpha_float (const CoglColor *color)
|
|
{
|
|
return (float) color->alpha / 255.0;
|
|
}
|
|
|
|
float
|
|
cogl_color_get_alpha (const CoglColor *color)
|
|
{
|
|
return ((float) color->alpha / 255.0);
|
|
}
|
|
|
|
void
|
|
cogl_color_set_red_byte (CoglColor *color,
|
|
unsigned char red)
|
|
{
|
|
color->red = red;
|
|
}
|
|
|
|
void
|
|
cogl_color_set_red_float (CoglColor *color,
|
|
float red)
|
|
{
|
|
color->red = red * 255.0;
|
|
}
|
|
|
|
void
|
|
cogl_color_set_red (CoglColor *color,
|
|
float red)
|
|
{
|
|
color->red = red * 255.0;
|
|
}
|
|
|
|
void
|
|
cogl_color_set_green_byte (CoglColor *color,
|
|
unsigned char green)
|
|
{
|
|
color->green = green;
|
|
}
|
|
|
|
void
|
|
cogl_color_set_green_float (CoglColor *color,
|
|
float green)
|
|
{
|
|
color->green = green * 255.0;
|
|
}
|
|
|
|
void
|
|
cogl_color_set_green (CoglColor *color,
|
|
float green)
|
|
{
|
|
color->green = green * 255.0;
|
|
}
|
|
|
|
void
|
|
cogl_color_set_blue_byte (CoglColor *color,
|
|
unsigned char blue)
|
|
{
|
|
color->blue = blue;
|
|
}
|
|
|
|
void
|
|
cogl_color_set_blue_float (CoglColor *color,
|
|
float blue)
|
|
{
|
|
color->blue = blue * 255.0;
|
|
}
|
|
|
|
void
|
|
cogl_color_set_blue (CoglColor *color,
|
|
float blue)
|
|
{
|
|
color->blue = blue * 255.0;
|
|
}
|
|
|
|
void
|
|
cogl_color_set_alpha_byte (CoglColor *color,
|
|
unsigned char alpha)
|
|
{
|
|
color->alpha = alpha;
|
|
}
|
|
|
|
void
|
|
cogl_color_set_alpha_float (CoglColor *color,
|
|
float alpha)
|
|
{
|
|
color->alpha = alpha * 255.0;
|
|
}
|
|
|
|
void
|
|
cogl_color_set_alpha (CoglColor *color,
|
|
float alpha)
|
|
{
|
|
color->alpha = alpha * 255.0;
|
|
}
|
|
|
|
void
|
|
cogl_color_premultiply (CoglColor *color)
|
|
{
|
|
color->red = (color->red * color->alpha + 128) / 255;
|
|
color->green = (color->green * color->alpha + 128) / 255;
|
|
color->blue = (color->blue * color->alpha + 128) / 255;
|
|
}
|
|
|
|
void
|
|
cogl_color_unpremultiply (CoglColor *color)
|
|
{
|
|
if (color->alpha != 0)
|
|
{
|
|
color->red = (color->red * 255) / color->alpha;
|
|
color->green = (color->green * 255) / color->alpha;
|
|
color->blue = (color->blue * 255) / color->alpha;
|
|
}
|
|
}
|
|
|
|
gboolean
|
|
cogl_color_equal (gconstpointer v1, gconstpointer v2)
|
|
{
|
|
const guint32 *c1 = v1, *c2 = v2;
|
|
|
|
g_return_val_if_fail (v1 != NULL, FALSE);
|
|
g_return_val_if_fail (v2 != NULL, FALSE);
|
|
|
|
/* XXX: We don't compare the padding */
|
|
return *c1 == *c2 ? TRUE : FALSE;
|
|
}
|
|
|
|
void
|
|
_cogl_color_get_rgba_4ubv (const CoglColor *color,
|
|
guint8 *dest)
|
|
{
|
|
memcpy (dest, color, 4);
|
|
}
|
|
|