![]() | Patrick's Programming Library Version 6.4.21 - Dokumentation |
Ein Datenobjekt zum Speichern eines Farbwertes. Mehr ...
Öffentliche Methoden | |
Color () | |
Konstruktor ohne Angabe von Werten. Mehr ... | |
Color (int red, int green, int blue, int alpha=255) | |
Konstruktor mit Angabe der Farbwerte. Mehr ... | |
Color (ppluint32 rgba) | |
Konstruktor mit Angabe eines Farbwertes als 32-Bit Wert. Mehr ... | |
Color (ppluint32 rgb, int alpha) | |
Konstruktor mit Angabe eines 32-Bit-Farbwertes und der Transparenz. Mehr ... | |
int | alpha () const |
Transparenz-Wert auslesen. Mehr ... | |
Color & | blend (const Color &background, const Color &foreground, int intensity) |
Farben überblenden. Mehr ... | |
Color & | blendf (const Color &background, const Color &foreground, float intensity) |
Farben überblenden. Mehr ... | |
int | blue () const |
blau-Anteil auslesen Mehr ... | |
int | brightness () const |
Helligkeit der Farbe. Mehr ... | |
ppluint32 | color () const |
Farbwert als 32-Bit-Wert auslesen. Mehr ... | |
int | green () const |
grün-Anteil auslesen Mehr ... | |
Color | grey () const |
Grauwert der Farbe. Mehr ... | |
bool | match (const Color &other, int tolerance=0) const |
Farbübereinstimmung prüfen. Mehr ... | |
operator pplint32 () const | |
Farbwert als 32-Bit-Wert auslesen. Mehr ... | |
operator ppluint32 () const | |
Farbwert als 32-Bit-Wert auslesen. Mehr ... | |
Color & | operator*= (float factor) |
Multiplikation der einzelnen Farbkomponenten mit einem Faktor. Mehr ... | |
int | red () const |
rot-Anteil auslesen Mehr ... | |
ppluint32 | rgb () const |
Farbwert als 32-Bit-Wert ohne Alpha-Kanal auslesen. Mehr ... | |
ppluint32 | rgba () const |
Farbwert als 32-Bit-Wert auslesen. Mehr ... | |
void | setAlpha (int alpha) |
Transparenz-Wert setzen. Mehr ... | |
void | setBlue (int blue) |
blau-Anteil setzen Mehr ... | |
void | setColor (int red, int green, int blue, int alpha=255) |
Farbwert anhand der einzelnen Farbkomponenten setzen. Mehr ... | |
void | setColor (ppluint32 rgba) |
Farbwert anhand eines 32-Bit-Wertes setzen. Mehr ... | |
void | setColor (ppluint32 rgb, int alpha) |
Farbwert anhand eines 32-Bit-Farbwertes und der Transparenz setzen. Mehr ... | |
void | setGreen (int green) |
grün-Anteil setzen Mehr ... | |
void | setRed (int red) |
rot-Anteil setzen Mehr ... | |
Private Methoden | |
int | Clamp (int value) |
Zurechtschneiden von Farbwerten. Mehr ... | |
Private Attribute | |
union { | |
struct { | |
ppluint8 a | |
ppluint8 b | |
ppluint8 g | |
ppluint8 r | |
} | |
ppluint32 c | |
}; | |
Freundbeziehungen | |
bool | operator!= (const Color &c1, const Color &c2) |
Vergleich zweier Farben. Mehr ... | |
const Color | operator* (const Color &size, float factor) |
Multiplikation einer Farbe mit einem Faktor. Mehr ... | |
const Color | operator* (float factor, const Color &size) |
Multiplikation einer Farbe mit einem Faktor. Mehr ... | |
bool | operator== (const Color &c1, const Color &c2) |
Farbwert als 32-Bit-Wert auslesen. Mehr ... | |
ppl6::grafix::Color::Color | ( | ) |
ppl6::grafix::Color::Color | ( | int | red, |
int | green, | ||
int | blue, | ||
int | alpha = 255 |
||
) |
red | Wert zwischen 0 und 255, der den rot-Anteil der Farbe festlegt |
green | Wert zwischen 0 und 255, der den grün-Anteil der Farbe festlegt |
blue | Wert zwischen 0 und 255, der den blau-Anteil der Farbe festlegt |
alpha | Optionaler Wert zwischen 0 und 255, der die Transparenz der Farbe festlegt. 0 bedeutet komplett transparent, 255 komplett sichtbar. |
ppl6::grafix::Color::Color | ( | ppluint32 | rgba | ) |
rgba | 32-Bit Farbwert mit folgendem Aufbau:
|
ppl6::grafix::Color::Color | ( | ppluint32 | rgb, |
int | alpha | ||
) |
rgb
und der Transparenz alpha
initialisiert wird.rgb | 32-Bit Farbwert mit folgendem Aufbau:
|
alpha | Der Transparenz-Wert der Farbe zwischen 0 (völlig transparent) und 255 (vollständig sichtbar). |
int ppl6::grafix::Color::alpha | ( | ) | const |
Color & ppl6::grafix::Color::blend | ( | const Color & | background, |
const Color & | foreground, | ||
int | intensity | ||
) |
background
und foreground
anhand des dritten Parameters intensity
vermischt. Dabei gilt, je höher der Wert intensity
, desto stärker kommt der Farbwert foreground
zur Geltung.background | Hintergrundfarbe |
foreground | Vordergrundfarbe |
intensity | Intensität der Vordergrundfarbe auf einer Skala von 0-255 |
Color & ppl6::grafix::Color::blendf | ( | const Color & | background, |
const Color & | foreground, | ||
float | intensity | ||
) |
background
und foreground
anhand des dritten Parameters intensity
vermischt. Dabei gilt, je höher der Wert intensity
, desto stärker kommt der Farbwert foreground
zur Geltung.background | Hintergrundfarbe |
foreground | Vordergrundfarbe |
intensity | Intensität der Vordergrundfarbe auf einer Skala von 0.0 bis 1.0 |
int ppl6::grafix::Color::blue | ( | ) | const |
int ppl6::grafix::Color::brightness | ( | ) | const |
|
private |
value | Der zu normalisierende Wert |
ppluint32 ppl6::grafix::Color::color | ( | ) | const |
int ppl6::grafix::Color::green | ( | ) | const |
Color ppl6::grafix::Color::grey | ( | ) | const |
bool ppl6::grafix::Color::match | ( | const Color & | other, |
int | tolerance = 0 |
||
) | const |
other
mit dieser übereinstimmt, wobei jeder der drei Farbwerte (rot, grün, blau) eine maximale Abweichung von tolerance
haben darf. Der Alpha-Kanal wird dabei nicht berücksichtigt.other | Der zu vergleichende Farbwert |
tolerance | Ein optionaler Parameter, der die maximale Toleranz auf einer Skala von 0-255 angibt. Der Default ist 0 |
true
zurück, andernfalls false
. ppl6::grafix::Color::operator pplint32 | ( | ) | const |
ppl6::grafix::Color::operator ppluint32 | ( | ) | const |
Color & ppl6::grafix::Color::operator*= | ( | float | factor | ) |
factor | Der Multiplikator als float-Wert |
int ppl6::grafix::Color::red | ( | ) | const |
ppluint32 ppl6::grafix::Color::rgb | ( | ) | const |
ppluint32 ppl6::grafix::Color::rgba | ( | ) | const |
void ppl6::grafix::Color::setAlpha | ( | int | alpha | ) |
red | Transparenz-Wert zwischen 0 (völlig transparent) und 255 (vollständig sichtbar). Ein Wert kleiner 0 wird zu 0, ein Wert größer 255 wird zu 255. |
void ppl6::grafix::Color::setBlue | ( | int | blue | ) |
red | blau-Anteil zwischen 0 und 255. Ein Wert kleiner 0 wird zu 0, ein Wert größer 255 wird zu 255. |
void ppl6::grafix::Color::setColor | ( | int | red, |
int | green, | ||
int | blue, | ||
int | alpha = 255 |
||
) |
red | Wert zwischen 0 und 255, der den rot-Anteil der Farbe festlegt |
green | Wert zwischen 0 und 255, der den grün-Anteil der Farbe festlegt |
blue | Wert zwischen 0 und 255, der den blau-Anteil der Farbe festlegt |
alpha | Optionaler Wert zwischen 0 und 255, der die Transparenz der Farbe festlegt. 0 bedeutet komplett transparent, 255 komplett sichtbar. Wird der Parameter nicht angegeben, wird automatisch 255 gesetzt. |
void ppl6::grafix::Color::setColor | ( | ppluint32 | rgba | ) |
rgba | 32-Bit Farbwert mit folgendem Aufbau:
|
void ppl6::grafix::Color::setColor | ( | ppluint32 | rgb, |
int | alpha | ||
) |
rgb
und der Transparenz alpha
gesetzt.rgb | 32-Bit Farbwert mit folgendem Aufbau:
|
alpha | Der Transparenz-Wert der Farbe zwischen 0 (völlig transparent) und 255 (vollständig sichtbar). |
void ppl6::grafix::Color::setGreen | ( | int | green | ) |
red | grün-Anteil zwischen 0 und 255. Ein Wert kleiner 0 wird zu 0, ein Wert größer 255 wird zu 255. |
void ppl6::grafix::Color::setRed | ( | int | red | ) |
red | rot-Anteil zwischen 0 und 255. Ein Wert kleiner 0 wird zu 0, ein Wert größer 255 wird zu 255. |
==
und !=
können zwei Farbwerte miteinander verglichen werden.c1 | Erster Farbwert |
c2 | Zweiter Farbwert |
==
wird true
zurückgegeben, wenn beide Farbwerte identisch sind und false
, wenn dies nicht der Fall ist. Bei Verwendung des Operators !=
wird true
zurückgegeben, wenn die Farbwerte unterschiedlich sind und false
, wenn sie identisch sind. color
mit dem Faktor factor
multipliziert und das Ergebnis als neuer Farbwert zurückgegeben. Ein Wert größer 1.0 bewirkt, dass die Farbe heller wird, bei Werten kleiner 1,0 wird die Farbe dunkler.Ist das Ergebnis der Multiplikation eines Farbwertes größer 255, wird er auf 255 gesetzt. Ein negativer Faktor wird zu 0.
color | Farbwert |
factor | Multiplikations-Faktor |
color
mit dem Faktor factor
multipliziert und das Ergebnis als neuer Farbwert zurückgegeben. Ein Wert größer 1.0 bewirkt, dass die Farbe heller wird, bei Werten kleiner 1,0 wird die Farbe dunkler.Ist das Ergebnis der Multiplikation eines Farbwertes größer 255, wird er auf 255 gesetzt. Ein negativer Faktor wird zu 0.
factor | Multiplikations-Faktor |
color | Farbwert |
union { ... } |
ppluint8 ppl6::grafix::Color::a |
ppluint8 ppl6::grafix::Color::b |
ppl6::grafix::Color::c |
ppluint8 ppl6::grafix::Color::g |
ppluint8 ppl6::grafix::Color::r |