libbtng API Reference: Color Manipulation

this section describes the color api. colors can be created from html-like color descriptions, or loaded from the color database. there are means to adjust brightness and color saturation, and to convert rgb to hsv and vice versa.

function list

btColor *{[doc:libbtng:btCreateColor()|btCreateColor]}(char *cstr); create a color by rgb or rgba definition, or by name.

void {[doc:libbtng:btDestroyColor()|btDestroyColor]}(btColor *c); destroy a color.

char *{[doc:libbtng:btColorRGBAString()|btColorRGBAString]}(btColor *c); return the rgba string representing a color.

void {[doc:libbtng:btColorAdjustBrightness()|btColorAdjBrightness]}(btColor *c, Sint8 incr); adjust the brightness of a color.

void {[doc:libbtng:btColorAdjustSaturation()|btColorAdjSaturation]}(btColor *c, float fact); adjust the saturation of a color.

void {[doc:libbtng:btColor2HSVColor()|btColor2HSVColor]}(btColor *c, btHSVColor *hsv); convert an rgb or rgba color to it's hsv representation.

void {[doc:libbtng:btHSVColor2Color()|btHSVColor2Color]}(btHSVColor *hsv, btColor *c); convert an hsv color to it's rgba representation.

data types

{[doc:libbtng:btColor|btColor]} the data type representing an rgb color.

{[doc:libbtng:btHSVColor|btHSVColor]} the data type representing an hsv color.

links

• {[doc:libbtng|libbtng api reference]}