glColor3b-Funktion
Legt die aktuelle Farbe fest.
Syntax
void WINAPI glColor3b(
GLbyte red,
GLbyte green,
GLbyte blue
);
Parameter
-
rot
-
Der neue rote Wert für die aktuelle Farbe.
-
grün
-
Der neue grüne Wert für die aktuelle Farbe.
-
blau
-
Der neue blaue Wert für die aktuelle Farbe.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Bemerkungen
Der GL speichert sowohl einen aktuellen einwertigen Farbindex als auch eine aktuelle RGBA-Farbe mit vier Werten. glcolor legt eine neue RGBA-Farbe mit vier Werten fest. glcolor hat zwei Hauptvarianten: glcolor3 und glcolor4. glcolor3-Varianten geben explizit neue rote, grüne und blaue Werte an und legen den aktuellen Alphawert implizit auf 1,0 (volle Intensität) fest. glcolor4 variants geben alle vier Farbkomponenten explizit an.
glcolor3b, glcolor4b, glcolor3s, glcolor4s, glcolor3i und glcolor4i verwenden drei oder vier byte-, kurze oder lange Ganzzahlen mit Vorzeichen als Argumente. Wenn v an den Namen angefügt wird, können die Farbbefehle einen Zeiger auf ein Array dieser Werte verwenden.
Aktuelle Farbwerte werden im Gleitkommaformat mit nicht angegebenen Mantisse- und Exponentengrößen gespeichert. Farbkomponenten ohne Vorzeichen werden bei Angabe linear Gleitkommawerten zugeordnet, sodass der größte darstellbare Wert 1,0 (volle Intensität) und 0,0 (null Intensität) zugeordnet wird. Farbkomponenten mit ganzzahliger Vorzeichen werden bei Angabe linear Gleitkommawerten zugeordnet, sodass der positivste darstellbare Wert 1,0 und der negativste darstellbare Wert -1,0 zugeordnet wird. (Beachten Sie, dass diese Zuordnung 0 nicht genau in 0,0 konvertiert.) Gleitkommawerte werden direkt zugeordnet.
Weder Gleitkommawerte noch ganzzahlige Werte mit Vorzeichen werden an den Bereich [0,1] geklemmt, bevor die aktuelle Farbe aktualisiert wird. Farbkomponenten werden jedoch an diesen Bereich geklemmt, bevor sie interpoliert oder in einen Farbpuffer geschrieben werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|