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 blaue Wert für die aktuelle Farbe.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Hinweise
Der GL speichert sowohl einen aktuellen einwertigen Farbindex als auch eine aktuelle vierwertige RGBA-Farbe. glcolor legt eine neue vierwertige RGBA-Farbe fest. glcolor verfügt über zwei Hauptvarianten: glcolor3 und glcolor4. Glcolor3-Varianten geben explizit neue Werte für Rot, Grün und Blau an und legen den aktuellen Alphawert implizit auf 1,0 (vollständige Intensität) fest. Glcolor4-Varianten geben alle vier Farbkomponenten explizit an.
glcolor3b, glcolor4b, glcolor3s, glcolor4s, glcolor3i und glcolor4i verwenden drei oder vier byte-, short- oder long-Ganzzahlen mit Vorzeichen als Argumente. Wenn v an den Namen angefügt wird, können die Farbbefehle einen Zeiger auf ein Array solcher Werte annehmen.
Aktuelle Farbwerte werden im Gleitkommaformat mit nicht angegebenen Mantisse- und Exponentengrößen gespeichert. Ganzzahlige Farbkomponenten ohne Vorzeichen werden, sofern angegeben, linear Gleitkommawerten zugeordnet, sodass der größte darstellbare Wert 1,0 (vollständige Intensität) und 0 0,0 (Null-Intensität) zugeordnet wird. Ganzzahlige Farbkomponenten mit Vorzeichen werden, sofern angegeben, 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 Gleitkomma- noch ganzzahlige Werte mit Vorzeichen werden an den Bereich [ 0,1 klammern, ] bevor die aktuelle Farbe aktualisiert wird. Farbkomponenten werden jedoch an diesen Bereich klammert, 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 |
|