Vuo 2.4.4
|
A color, with component values specifying red, green, blue, and alpha (opacity).
Classes | |
struct | VuoColor |
A color, with component values specifying red, green, blue, and alpha (opacity). More... | |
Macros | |
#define | VuoColor_SUPPORTS_COMPARISON |
Instances of this type can be compared and sorted. | |
Functions | |
VuoColor | VuoColor_makeFromJson (json_object *js) |
Decodes the JSON object js to create a new value. | |
json_object * | VuoColor_getJson (const VuoColor value) |
Encodes value as a JSON object. | |
char * | VuoColor_getShortSummary (const VuoColor value) |
Returns a short HTML representation of value . | |
char * | VuoColor_getSummary (const VuoColor value) |
Returns a detailed HTML representation of value . | |
bool | VuoColor_areEqual (const VuoColor a, const VuoColor b) |
Returns true if both colors have the same intensity and alpha values. | |
bool | VuoColor_isLessThan (const VuoColor a, const VuoColor b) |
Returns true if a < b. | |
bool | VuoColor_areEqualWithinTolerance (const VuoColor a, const VuoColor b, const float tolerance) |
Like VuoColor_areEqual(), but permits color channel values to differ by up to tolerance . | |
static VuoColor | VuoColor_makeWithRGBA (VuoReal r, VuoReal g, VuoReal b, VuoReal a) __attribute__((const)) |
Returns a VuoColor with the given red, green, blue, alpha. | |
static void | VuoColor_getRGBA (VuoColor color, VuoReal *r, VuoReal *g, VuoReal *b, VuoReal *a) |
Gets the red, green, blue, alpha of a color. | |
static VuoColor | VuoColor_premultiply (VuoColor c) __attribute__((const)) |
Returns a VuoColor whose red, green, and blue values have been multiplied by its alpha. | |
VuoColor | VuoColor_makeWithHSLA (VuoReal hue, VuoReal saturation, VuoReal luminosity, VuoReal alpha) |
Returns a VuoColor with the given hue, saturation, lightness, alpha. | |
void | VuoColor_getHSLA (VuoColor color, VuoReal *h, VuoReal *s, VuoReal *l, VuoReal *a) |
Gets the hue, saturation, lightness, hue, alpha of a color. | |
VuoReal | VuoColor_getLightness (VuoColor color) |
Returns the HSL lightness of the color, in the range [0,1]. | |
VuoText | VuoColor_getHex (VuoColor color, VuoBoolean includeAlpha) |
Returns a hex string (like #445566ff ) representing the color. | |
VuoColor | VuoColor_average (VuoList_VuoColor colors) |
Returns the weighted (by alpha) average of colors . | |
static bool | VuoColor_isOpaque (VuoColor color) |
Returns true if the color is fully opaque. | |
bool | VuoColor_areAllOpaque (VuoList_VuoColor colors) |
Returns true if all colors are fully opaque. | |
VuoReal | VuoColor_brightness (VuoColor color, int32_t type) |
Returns a measure of the brightness of color . | |
static VuoColor | VuoColor_lerp (VuoColor a, VuoColor b, float t) __attribute__((const)) |
Returns a linearly-interpolated value between a and b using time t (between 0 and 1). | |
char * | VuoColor_getString (const VuoColor value) |
Automatically generated function. | |
void | VuoColor_retain (VuoColor value) |
Automatically generated function. | |
void | VuoColor_release (VuoColor value) |
Automatically generated function. | |
#define VuoColor_SUPPORTS_COMPARISON |
Instances of this type can be compared and sorted.
Definition at line 41 of file VuoColor.h.
bool VuoColor_areAllOpaque | ( | VuoList_VuoColor | colors | ) |
Returns true if all colors are fully opaque.
If the list is empty, returns false.
Definition at line 372 of file VuoColor.c.
Returns true if both colors have the same intensity and alpha values.
Definition at line 425 of file VuoColor.c.
Like VuoColor_areEqual(), but permits color channel values to differ by up to tolerance
.
Definition at line 436 of file VuoColor.c.
VuoColor VuoColor_average | ( | VuoList_VuoColor | colors | ) |
Returns the weighted (by alpha) average of colors
.
If there are no colors in the list, returns transparent black.
Definition at line 342 of file VuoColor.c.
Returns a measure of the brightness of color
.
Definition at line 393 of file VuoColor.c.
VuoText VuoColor_getHex | ( | VuoColor | color, |
VuoBoolean | includeAlpha | ||
) |
Returns a hex string (like #445566ff
) representing the color.
Definition at line 236 of file VuoColor.c.
Gets the hue, saturation, lightness, hue, alpha of a color.
Each value is in the range [0,1].
Definition at line 298 of file VuoColor.c.
struct json_object * VuoColor_getJson | ( | const VuoColor | value | ) |
Encodes value
as a JSON object.
Definition at line 147 of file VuoColor.c.
Returns the HSL lightness of the color, in the range [0,1].
Definition at line 330 of file VuoColor.c.
|
inlinestatic |
Gets the red, green, blue, alpha of a color.
Each value is in the range [0,1], and specifies a color in the sRGB color space.
RGB are not premultiplied by A.
Definition at line 75 of file VuoColor.h.
char * VuoColor_getShortSummary | ( | const VuoColor | value | ) |
Returns a short HTML representation of value
.
Definition at line 165 of file VuoColor.c.
char * VuoColor_getString | ( | const VuoColor | value | ) |
Automatically generated function.
char * VuoColor_getSummary | ( | const VuoColor | value | ) |
Returns a detailed HTML representation of value
.
Definition at line 177 of file VuoColor.c.
Returns true if a < b.
Definition at line 447 of file VuoColor.c.
|
inlinestatic |
Returns true if the color is fully opaque.
Definition at line 104 of file VuoColor.h.
Returns a linearly-interpolated value between a
and b
using time t
(between 0 and 1).
Definition at line 117 of file VuoColor.h.
VuoColor VuoColor_makeFromJson | ( | json_object * | js | ) |
Decodes the JSON object js
to create a new value.
Definition at line 49 of file VuoColor.c.
VuoColor VuoColor_makeWithHSLA | ( | VuoReal | hue, |
VuoReal | saturation, | ||
VuoReal | luminosity, | ||
VuoReal | alpha | ||
) |
Returns a VuoColor
with the given hue, saturation, lightness, alpha.
hue | Color circle from 0 (red) to 1/3 (green) to 2/3 (blue) to 1 (red). Values beyond that range are wrapped. |
saturation | 0 to 1 |
luminosity | 0 to 1 |
alpha | 0 to 1 |
Definition at line 261 of file VuoColor.c.
|
inlinestatic |
Returns a VuoColor
with the given red, green, blue, alpha.
Assumes each value is in the range [0,1], and specifies a color in the sRGB color space.
You should not premultiply RGB by A.
Definition at line 62 of file VuoColor.h.
Returns a VuoColor
whose red, green, and blue values have been multiplied by its alpha.
Definition at line 87 of file VuoColor.h.
void VuoColor_release | ( | VuoColor | value | ) |
Automatically generated function.
void VuoColor_retain | ( | VuoColor | value | ) |
Automatically generated function.