glColor3s-Funktion
Legt die aktuelle Farbe fest.
Syntax
void WINAPI glColor3s(
GLshort red,
GLshort green,
GLshort 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 Blauwert 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-Varianten geben alle vier Farbkomponenten explizit an.
glcolor3b, glcolor4b, glcolor3s, glcolor4s, glcolor3i und glcolor4i nehmen drei oder vier Signiertbytes, kurze oder lange ganze Zahlen als Argumente an. Wenn v an den Namen angefügt wird, können die Farbbefehle einen Zeiger auf ein Array solcher Werte verwenden.
Aktuelle Farbwerte werden im Gleitkommaformat mit nicht angegebenen Mantissa- und Exponentengrößen gespeichert. Ganzzahlige Farbkomponenten ohne Vorzeichen werden bei Angabe linear Gleitkommawerten zugeordnet, sodass der größte darstellbare Wert 1,0 (volle Intensität) und 0 0 0 (null Intensität) zugeordnet wird. Wenn ganzzahlige Farbkomponenten mit Vorzeichen angegeben werden, werden Gleitkommawerte linear zugeordnet, sodass der positivste darstellbare Wert 1,0 und der negativste darstellbare Wert -1,0 zugeordnet wird. (Beachten Sie, dass diese Zuordnung 0 nicht präzise in 0,0 konvertiert.) Gleitkommawerte werden direkt zugeordnet.
Weder Gleitkommawerte noch ganzzahlige Vorzeichenwerte 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 |
|