1b2dd815b4
This adds much more comprehensive support for gobject-introspection based bindings by registering all objects as fundamental types that inherit from CoglObject, and all structs as boxed types. Co-Author: Robert Bragg <robert@linux.intel.com> Reviewed-by: Neil Roberts <neil@linux.intel.com>
605 lines
14 KiB
C
605 lines
14 KiB
C
/*
|
|
* Cogl
|
|
*
|
|
* A Low Level GPU Graphics and Utilities API
|
|
*
|
|
* Copyright (C) 2008,2009 Intel Corporation.
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person
|
|
* obtaining a copy of this software and associated documentation
|
|
* files (the "Software"), to deal in the Software without
|
|
* restriction, including without limitation the rights to use, copy,
|
|
* modify, merge, publish, distribute, sublicense, and/or sell copies
|
|
* of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be
|
|
* included in all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
|
|
* BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
|
|
* ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
* SOFTWARE.
|
|
*
|
|
*
|
|
*/
|
|
|
|
#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__
|
|
|
|
/**
|
|
* 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
|
|
*/
|
|
|
|
#include <cogl/cogl-types.h>
|
|
#include <cogl/cogl-macros.h>
|
|
|
|
#ifdef COGL_HAS_GTYPE_SUPPORT
|
|
#include <glib-object.h>
|
|
#endif
|
|
|
|
COGL_BEGIN_DECLS
|
|
|
|
#ifdef COGL_HAS_GTYPE_SUPPORT
|
|
/**
|
|
* cogl_color_get_gtype:
|
|
*
|
|
* Returns: a #GType that can be used with the GLib type system.
|
|
*/
|
|
GType cogl_color_get_gtype (void);
|
|
#endif
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
COGL_DEPRECATED_IN_1_4_FOR (cogl_color_init_from_4ub)
|
|
void
|
|
cogl_color_set_from_4ub (CoglColor *color,
|
|
uint8_t red,
|
|
uint8_t green,
|
|
uint8_t blue,
|
|
uint8_t alpha);
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
COGL_DEPRECATED_IN_1_4_FOR (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_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__ */
|