Documentation de Gambas - /comp/gb.opengl/gl/color3f

/comp/gb.opengl/gl/color3f

# Gl.Color3f (gb.opengl)

Static Sub Color3f ( Red As Float, Green As Float, Blue As Float )

Définit la couleur courante

### Paramètres

red, green, blue

  Spécifient les nouvelles valeurs rouge, vert et bleu, pour la couleur courante.

alpha

  Spécifie une nouvelle valeur alpha pour la couleur en cours. Inclus uniquement dans les commandes Gl.Color4 à 4 arguments.

### Paramètres

v

  Spécifie un pointeur vers un tableau qui contient les valeurs red, green, blue, et (parfois) alpha.

### Description

GL stocke à la fois une valeur single d’index de couleur courante et une couleur courante définie par quatre valeurs RGBA. Gl.Color définit une nouvelle couleur RGBA à 4 valeurs. Gl.Color a deux variantes principales : Gl.Color3 et Gl.Color4. Les variants Gl.Color3 spécifient les nouvelles valeurs rouge, vert et bleu explicitement, et met la valeur alpha courante à 1.0 implicitement. Les variants Gl.Color4 spécifient les quatre composantes de couleur explicitement.

Gl.Color3b, Gl.Color4b, Gl.Color3s, Gl.Color4s, Gl.Color3i, et Gl.Color4i prennent comme arguments trois ou quatre octets signés, entiers courts ou longs. Quand vest ajouté au nom, la commande de couleur peut prendre un pointeur vers un tableau de ces valeurs.

Les valeurs de la couleur en cours sont stockées au format virgule flottante, avec taille de mantisse et d’exposant non spécifiés. Les composantes couleur entier non signé, lorsque spécifiées, sont réparties linéairement dans les valeurs virgule flottante de telle sorte que la valeur représentable la plus grande corresponde à 1.0 (pleine intensité), et 0 à 0.0 (intensité nulle). Les composantes couleur en entiers signés, lorsque spécifié, sont réparties linéairement dans les valeurs virgule flottante de telle sorte que la valeur représentable la plus positive corresponde à 1.0 et la plus négative à -1.0 . (Notez que ces correspondances ne convertissent pas 0 précisément en 0.0)

Ni les valeurs flottantes ni les valeurs entières non signées ne sont limitées au domaine 0 1 avant la mise à jour de la couleur courante. Cependant, les composantes de couleur sont limitées à ce domaine avant d’être interpolées ou écrites dans un tampon de couleur.

### Notes

La valeur initiale pour la couleur courante est (1, 1, 1, 1).

La couleur courante peut être mise à jour n’importe quand. En particulier, Gl.Color peut être appelée entre un appel à Gl.Begin et l’appel correspondant à Gl.End.

### Gets Associés

Gl.Get avec l’argument Gl.CURRENT_COLOR

Gl.Get avec l’argument Gl.RGBA_MODE

### Voir aussi

Gl.ColorPointer, Gl.Index, Gl.SecondaryColor

Voir documentation originale sur le site OpenGL