glColor3bv-Funktion

Legt die aktuelle Farbe aus einem bereits vorhandenen Array von Farbwerten fest.

Syntax

void WINAPI glColor3bv(
   const GLbyte *v
);

Parameter

V

Ein Zeiger auf ein Array, das rote, grüne und blaue Werte enthält.

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
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Weitere Informationen

glBegin

glEnd

glGetBooleanv, glGetDoublev, glGetFloatv, glGetIntegerv

glIndex