Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|