mirror of
https://github.com/brl/mutter.git
synced 2024-11-29 19:40:43 -05:00
5858cac873
This allows to easily caculate shades of the same color or pick colors with the same saturation/luminance. In short, all sorts of interesting things. Reviewed-by: Robert Bragg <robert@linux.intel.com> Reviewed-by: Neil Roberts <neil@linux.intel.com> (cherry picked from commit edcbeaf3c941f7a2335fbec47d5248cd9b0e8088)
585 lines
13 KiB
C
585 lines
13 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/>.
|
|
*
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* SECTION:cogl-color
|
|
* @short_description: A generic color definition
|
|
*
|
|
* #CoglColor is a simple structure holding the definition of a color such
|
|
* that it can be efficiently used by GL
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
|
|
#if !defined(__COGL_H_INSIDE__) && !defined(COGL_COMPILATION)
|
|
#error "Only <cogl/cogl.h> can be included directly."
|
|
#endif
|
|
|
|
#ifndef __COGL_COLOR_H__
|
|
#define __COGL_COLOR_H__
|
|
|
|
#include <cogl/cogl-types.h>
|
|
#include <cogl/cogl-macros.h>
|
|
|
|
COGL_BEGIN_DECLS
|
|
|
|
/**
|
|
* cogl_color_new:
|
|
*
|
|
* Creates a new (empty) color
|
|
*
|
|
* Return value: a newly-allocated #CoglColor. Use cogl_color_free()
|
|
* to free the allocated resources
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
CoglColor *
|
|
cogl_color_new (void);
|
|
|
|
/**
|
|
* cogl_color_copy:
|
|
* @color: the color to copy
|
|
*
|
|
* Creates a copy of @color
|
|
*
|
|
* Return value: a newly-allocated #CoglColor. Use cogl_color_free()
|
|
* to free the allocate resources
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
CoglColor *
|
|
cogl_color_copy (const CoglColor *color);
|
|
|
|
/**
|
|
* cogl_color_free:
|
|
* @color: the color to free
|
|
*
|
|
* Frees the resources allocated by cogl_color_new() and cogl_color_copy()
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
void
|
|
cogl_color_free (CoglColor *color);
|
|
|
|
/**
|
|
* cogl_color_init_from_4ub:
|
|
* @color: A pointer to a #CoglColor to initialize
|
|
* @red: value of the red channel, between 0 and 255
|
|
* @green: value of the green channel, between 0 and 255
|
|
* @blue: value of the blue channel, between 0 and 255
|
|
* @alpha: value of the alpha channel, between 0 and 255
|
|
*
|
|
* Sets the values of the passed channels into a #CoglColor.
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
void
|
|
cogl_color_init_from_4ub (CoglColor *color,
|
|
uint8_t red,
|
|
uint8_t green,
|
|
uint8_t blue,
|
|
uint8_t alpha);
|
|
|
|
/**
|
|
* cogl_color_set_from_4ub:
|
|
* @color: A pointer to a #CoglColor to initialize
|
|
* @red: value of the red channel, between 0 and 255
|
|
* @green: value of the green channel, between 0 and 255
|
|
* @blue: value of the blue channel, between 0 and 255
|
|
* @alpha: value of the alpha channel, between 0 and 255
|
|
*
|
|
* Sets the values of the passed channels into a #CoglColor.
|
|
*
|
|
* Since: 1.0
|
|
* Deprecated: 1.4: Use cogl_color_init_from_4ub instead.
|
|
*/
|
|
void
|
|
cogl_color_set_from_4ub (CoglColor *color,
|
|
uint8_t red,
|
|
uint8_t green,
|
|
uint8_t blue,
|
|
uint8_t alpha)
|
|
COGL_DEPRECATED_IN_1_4_FOR (cogl_color_init_from_4ub);
|
|
|
|
/**
|
|
* cogl_color_init_from_4f:
|
|
* @color: A pointer to a #CoglColor to initialize
|
|
* @red: value of the red channel, between 0 and 1.0
|
|
* @green: value of the green channel, between 0 and 1.0
|
|
* @blue: value of the blue channel, between 0 and 1.0
|
|
* @alpha: value of the alpha channel, between 0 and 1.0
|
|
*
|
|
* Sets the values of the passed channels into a #CoglColor
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
void
|
|
cogl_color_init_from_4f (CoglColor *color,
|
|
float red,
|
|
float green,
|
|
float blue,
|
|
float alpha);
|
|
|
|
/**
|
|
* cogl_color_set_from_4f:
|
|
* @color: A pointer to a #CoglColor to initialize
|
|
* @red: value of the red channel, between 0 and %1.0
|
|
* @green: value of the green channel, between 0 and %1.0
|
|
* @blue: value of the blue channel, between 0 and %1.0
|
|
* @alpha: value of the alpha channel, between 0 and %1.0
|
|
*
|
|
* Sets the values of the passed channels into a #CoglColor
|
|
*
|
|
* Since: 1.0
|
|
* Deprecated: 1.4: Use cogl_color_init_from_4f instead.
|
|
*/
|
|
void
|
|
cogl_color_set_from_4f (CoglColor *color,
|
|
float red,
|
|
float green,
|
|
float blue,
|
|
float alpha)
|
|
COGL_DEPRECATED_IN_1_4_FOR (cogl_color_init_from_4f);
|
|
|
|
/**
|
|
* cogl_color_init_from_4fv:
|
|
* @color: A pointer to a #CoglColor to initialize
|
|
* @color_array: a pointer to an array of 4 float color components
|
|
*
|
|
* Sets the values of the passed channels into a #CoglColor
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
void
|
|
cogl_color_init_from_4fv (CoglColor *color,
|
|
const float *color_array);
|
|
|
|
/**
|
|
* cogl_color_get_red_byte:
|
|
* @color: a #CoglColor
|
|
*
|
|
* Retrieves the red channel of @color as a byte value
|
|
* between 0 and 255
|
|
*
|
|
* Return value: the red channel of the passed color
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
unsigned char
|
|
cogl_color_get_red_byte (const CoglColor *color);
|
|
|
|
/**
|
|
* cogl_color_get_green_byte:
|
|
* @color: a #CoglColor
|
|
*
|
|
* Retrieves the green channel of @color as a byte value
|
|
* between 0 and 255
|
|
*
|
|
* Return value: the green channel of the passed color
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
unsigned char
|
|
cogl_color_get_green_byte (const CoglColor *color);
|
|
|
|
/**
|
|
* cogl_color_get_blue_byte:
|
|
* @color: a #CoglColor
|
|
*
|
|
* Retrieves the blue channel of @color as a byte value
|
|
* between 0 and 255
|
|
*
|
|
* Return value: the blue channel of the passed color
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
unsigned char
|
|
cogl_color_get_blue_byte (const CoglColor *color);
|
|
|
|
/**
|
|
* cogl_color_get_alpha_byte:
|
|
* @color: a #CoglColor
|
|
*
|
|
* Retrieves the alpha channel of @color as a byte value
|
|
* between 0 and 255
|
|
*
|
|
* Return value: the alpha channel of the passed color
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
unsigned char
|
|
cogl_color_get_alpha_byte (const CoglColor *color);
|
|
|
|
/**
|
|
* cogl_color_get_red_float:
|
|
* @color: a #CoglColor
|
|
*
|
|
* Retrieves the red channel of @color as a floating point
|
|
* value between 0.0 and 1.0
|
|
*
|
|
* Return value: the red channel of the passed color
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
float
|
|
cogl_color_get_red_float (const CoglColor *color);
|
|
|
|
/**
|
|
* cogl_color_get_green_float:
|
|
* @color: a #CoglColor
|
|
*
|
|
* Retrieves the green channel of @color as a floating point
|
|
* value between 0.0 and 1.0
|
|
*
|
|
* Return value: the green channel of the passed color
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
float
|
|
cogl_color_get_green_float (const CoglColor *color);
|
|
|
|
/**
|
|
* cogl_color_get_blue_float:
|
|
* @color: a #CoglColor
|
|
*
|
|
* Retrieves the blue channel of @color as a floating point
|
|
* value between 0.0 and 1.0
|
|
*
|
|
* Return value: the blue channel of the passed color
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
float
|
|
cogl_color_get_blue_float (const CoglColor *color);
|
|
|
|
/**
|
|
* cogl_color_get_alpha_float:
|
|
* @color: a #CoglColor
|
|
*
|
|
* Retrieves the alpha channel of @color as a floating point
|
|
* value between 0.0 and 1.0
|
|
*
|
|
* Return value: the alpha channel of the passed color
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
float
|
|
cogl_color_get_alpha_float (const CoglColor *color);
|
|
|
|
/**
|
|
* cogl_color_get_red:
|
|
* @color: a #CoglColor
|
|
*
|
|
* Retrieves the red channel of @color as a fixed point
|
|
* value between 0 and 1.0.
|
|
*
|
|
* Return value: the red channel of the passed color
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
float
|
|
cogl_color_get_red (const CoglColor *color);
|
|
|
|
/**
|
|
* cogl_color_get_green:
|
|
* @color: a #CoglColor
|
|
*
|
|
* Retrieves the green channel of @color as a fixed point
|
|
* value between 0 and 1.0.
|
|
*
|
|
* Return value: the green channel of the passed color
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
float
|
|
cogl_color_get_green (const CoglColor *color);
|
|
|
|
/**
|
|
* cogl_color_get_blue:
|
|
* @color: a #CoglColor
|
|
*
|
|
* Retrieves the blue channel of @color as a fixed point
|
|
* value between 0 and 1.0.
|
|
*
|
|
* Return value: the blue channel of the passed color
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
float
|
|
cogl_color_get_blue (const CoglColor *color);
|
|
|
|
/**
|
|
* cogl_color_get_alpha:
|
|
* @color: a #CoglColor
|
|
*
|
|
* Retrieves the alpha channel of @color as a fixed point
|
|
* value between 0 and 1.0.
|
|
*
|
|
* Return value: the alpha channel of the passed color
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
float
|
|
cogl_color_get_alpha (const CoglColor *color);
|
|
|
|
/**
|
|
* cogl_color_set_red_byte:
|
|
* @color: a #CoglColor
|
|
* @red: a byte value between 0 and 255
|
|
*
|
|
* Sets the red channel of @color to @red.
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
void
|
|
cogl_color_set_red_byte (CoglColor *color,
|
|
unsigned char red);
|
|
|
|
/**
|
|
* cogl_color_set_green_byte:
|
|
* @color: a #CoglColor
|
|
* @green: a byte value between 0 and 255
|
|
*
|
|
* Sets the green channel of @color to @green.
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
void
|
|
cogl_color_set_green_byte (CoglColor *color,
|
|
unsigned char green);
|
|
|
|
/**
|
|
* cogl_color_set_blue_byte:
|
|
* @color: a #CoglColor
|
|
* @blue: a byte value between 0 and 255
|
|
*
|
|
* Sets the blue channel of @color to @blue.
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
void
|
|
cogl_color_set_blue_byte (CoglColor *color,
|
|
unsigned char blue);
|
|
|
|
/**
|
|
* cogl_color_set_alpha_byte:
|
|
* @color: a #CoglColor
|
|
* @alpha: a byte value between 0 and 255
|
|
*
|
|
* Sets the alpha channel of @color to @alpha.
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
void
|
|
cogl_color_set_alpha_byte (CoglColor *color,
|
|
unsigned char alpha);
|
|
|
|
/**
|
|
* cogl_color_set_red_float:
|
|
* @color: a #CoglColor
|
|
* @red: a float value between 0.0f and 1.0f
|
|
*
|
|
* Sets the red channel of @color to @red.
|
|
*
|
|
* since: 1.4
|
|
*/
|
|
void
|
|
cogl_color_set_red_float (CoglColor *color,
|
|
float red);
|
|
|
|
/**
|
|
* cogl_color_set_green_float:
|
|
* @color: a #CoglColor
|
|
* @green: a float value between 0.0f and 1.0f
|
|
*
|
|
* Sets the green channel of @color to @green.
|
|
*
|
|
* since: 1.4
|
|
*/
|
|
void
|
|
cogl_color_set_green_float (CoglColor *color,
|
|
float green);
|
|
|
|
/**
|
|
* cogl_color_set_blue_float:
|
|
* @color: a #CoglColor
|
|
* @blue: a float value between 0.0f and 1.0f
|
|
*
|
|
* Sets the blue channel of @color to @blue.
|
|
*
|
|
* since: 1.4
|
|
*/
|
|
void
|
|
cogl_color_set_blue_float (CoglColor *color,
|
|
float blue);
|
|
|
|
/**
|
|
* cogl_color_set_alpha_float:
|
|
* @color: a #CoglColor
|
|
* @alpha: a float value between 0.0f and 1.0f
|
|
*
|
|
* Sets the alpha channel of @color to @alpha.
|
|
*
|
|
* since: 1.4
|
|
*/
|
|
void
|
|
cogl_color_set_alpha_float (CoglColor *color,
|
|
float alpha);
|
|
|
|
/**
|
|
* cogl_color_set_red:
|
|
* @color: a #CoglColor
|
|
* @red: a float value between 0.0f and 1.0f
|
|
*
|
|
* Sets the red channel of @color to @red.
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
void
|
|
cogl_color_set_red (CoglColor *color,
|
|
float red);
|
|
|
|
/**
|
|
* cogl_color_set_green:
|
|
* @color: a #CoglColor
|
|
* @green: a float value between 0.0f and 1.0f
|
|
*
|
|
* Sets the green channel of @color to @green.
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
void
|
|
cogl_color_set_green (CoglColor *color,
|
|
float green);
|
|
|
|
/**
|
|
* cogl_color_set_blue:
|
|
* @color: a #CoglColor
|
|
* @blue: a float value between 0.0f and 1.0f
|
|
*
|
|
* Sets the blue channel of @color to @blue.
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
void
|
|
cogl_color_set_blue (CoglColor *color,
|
|
float blue);
|
|
|
|
/**
|
|
* cogl_color_set_alpha:
|
|
* @color: a #CoglColor
|
|
* @alpha: a float value between 0.0f and 1.0f
|
|
*
|
|
* Sets the alpha channel of @color to @alpha.
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
void
|
|
cogl_color_set_alpha (CoglColor *color,
|
|
float alpha);
|
|
|
|
/**
|
|
* cogl_color_premultiply:
|
|
* @color: the color to premultiply
|
|
*
|
|
* Converts a non-premultiplied color to a pre-multiplied color. For
|
|
* example, semi-transparent red is (1.0, 0, 0, 0.5) when non-premultiplied
|
|
* and (0.5, 0, 0, 0.5) when premultiplied.
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
void
|
|
cogl_color_premultiply (CoglColor *color);
|
|
|
|
/**
|
|
* cogl_color_unpremultiply:
|
|
* @color: the color to unpremultiply
|
|
*
|
|
* Converts a pre-multiplied color to a non-premultiplied color. For
|
|
* example, semi-transparent red is (0.5, 0, 0, 0.5) when premultiplied
|
|
* and (1.0, 0, 0, 0.5) when non-premultiplied.
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
void
|
|
cogl_color_unpremultiply (CoglColor *color);
|
|
|
|
/**
|
|
* cogl_color_equal:
|
|
* @v1: a #CoglColor
|
|
* @v2: a #CoglColor
|
|
*
|
|
* Compares two #CoglColor<!-- -->s and checks if they are the same.
|
|
*
|
|
* This function can be passed to g_hash_table_new() as the @key_equal_func
|
|
* parameter, when using #CoglColor<!-- -->s as keys in a #GHashTable.
|
|
*
|
|
* Return value: %TRUE if the two colors are the same.
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
CoglBool
|
|
cogl_color_equal (const void *v1, const void *v2);
|
|
|
|
/**
|
|
* cogl_color_to_hsl:
|
|
* @color: a #CoglColor
|
|
* @hue: (out): return location for the hue value or %NULL
|
|
* @saturation: (out): return location for the saturation value or %NULL
|
|
* @luminance: (out): return location for the luminance value or %NULL
|
|
*
|
|
* Converts @color to the HLS format.
|
|
*
|
|
* The @hue value is in the 0 .. 360 range. The @luminance and
|
|
* @saturation values are in the 0 .. 1 range.
|
|
*
|
|
* Since: 1.16
|
|
*/
|
|
void
|
|
cogl_color_to_hsl (const CoglColor *color,
|
|
float *hue,
|
|
float *saturation,
|
|
float *luminance);
|
|
|
|
/**
|
|
* cogl_color_init_from_hsl:
|
|
* @color: (out): return location for a #CoglColor
|
|
* @hue: hue value, in the 0 .. 360 range
|
|
* @saturation: saturation value, in the 0 .. 1 range
|
|
* @luminance: luminance value, in the 0 .. 1 range
|
|
*
|
|
* Converts a color expressed in HLS (hue, luminance and saturation)
|
|
* values into a #CoglColor.
|
|
*
|
|
* Since: 1.16
|
|
*/
|
|
void
|
|
cogl_color_init_from_hsl (CoglColor *color,
|
|
float hue,
|
|
float saturation,
|
|
float luminance);
|
|
|
|
COGL_END_DECLS
|
|
|
|
#endif /* __COGL_COLOR_H__ */
|