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

/comp/gb.opengl/gl/coloriv

# Gl.Coloriv (gb.opengl)

Static Sub Coloriv ( Colors As Integer[] )

Définit la couleur courante

### Paramètres

red, green, blue

  Spécifie les nouvelles valeurs rouge, vert, bleu de la couleur courante.

alpha

  Spécifie la nouvelle valeur alpha de la couleur courante. Inclus seulement dans les commandes Gl.Color4 à quatre arguments.

### Paramètres

v

  Specifie un pointuer vers un tableau contenant les valeurs rouge, vert, bleu et (parfois) alpha.

### Description

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

Gl.Color3b, Gl.Color4b, Gl.Color3s, Gl.Color4s, Gl.Color3i, et Gl.Color4i prennent comme arguments trois ou quatre octets signés, de type short ou long. Quand v est ajouté au nom, la commande de couleur peut recevoir 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ées. Les composantes couleur de type entier non signé, lorsqu’elles sont spécifiées, sont linéairement interpolées en valeurs flottantes de telle sorte que la valeur représentable la plus grande corresponde à 1.0 (pleine intensité), et 0 à 0.0 (intensité zéro). Les composantes couleur de type entier signé, lorsqu’elles sont spécifiées, sont linéairement interpolées en valeurs flottantes de telle sorte que la valeur représentable la plus positive corresponde à 1.0 (pleine intensité), et la plus négative à -1.0 . (Notez que cette interpolation ne convertit pas 0 exactement en 0.0.) Les valeurs en virgule flottante sont transposées directement.

Ni les valeurs flottantes, ni celles de type entier signé ne sont normées dans le domaine 0 1 avant la mise à jour de la couleur en cours. 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 de 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