glColor3ubv-Funktion

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

Syntax

void WINAPI glColor3ubv(
   const GLubyte *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-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	Gl.h
Bibliothek	Opengl32.lib
DLL	Opengl32.dll

Siehe auch

glBegin

glEnd

glGetBooleanv, glGetDoublev, glGetFloatv, glGetIntegerv

glIndex