glColor4ubv-Funktion

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

Syntax

void WINAPI glColor4ubv(
   const GLubyte *v
);

Parameter

V

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

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Hinweise

Die 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 neue rote, grüne und blaue Werte explizit 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 ganze Zahlen mit Vorzeichen, 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 Mantisse- und Exponentengrößen gespeichert. Ganzzahlige Farbkomponenten ohne Vorzeichen werden, wenn angegeben, linear Gleitkommawerten zugeordnet, damit der größte darstellbare Wert 1,0 (volle Intensität) und 0 0 (Intensität 0) zugeordnet wird. Ganzzahlige Farbkomponenten mit Vorzeichen werden, wenn angegeben, linear Gleitkommawerten zugeordnet, damit 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 klammert, ] bevor die aktuelle Farbe aktualisiert wird. Farbkomponenten werden jedoch an diesen Bereich klammert, bevor sie interpoliert oder in einen Farbpuffer geschrieben werden.

Requirements (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