glColorSubTableEXT fonction)

La fonction glColorSubTableEXT spécifie une partie de la palette de la texture ciblée à remplacer.

Syntaxe

void WINAPI glColorSubTableEXT(
         GLenum  target,
         GLsizei start,
         GLsizei count,
         GLenum  format,
         GLenum  type,
   const GLvoid  *data
);

Paramètres

cible

Texture de palette cible dont la palette doit être modifiée. Doit être une TEXTURE _ 1D ou une texture _ 2D.

start

Entrée d’index de la palette de départ de la palette à modifier.

count

Nombre d’entrées d’index de palette de la palette à modifier à partir du début. Le paramètre Count détermine la plage d’entrées d’index de palette qui sont modifiées.

format

Format des données de pixels. Les constantes symboliques suivantes sont acceptées.

Valeur Signification
GL_RGBA
Chaque pixel est un groupe de quatre composants dans l’ordre suivant : rouge, vert, bleu, alpha. Le format RVBA est déterminé de la façon suivante :
  1. La fonction glColorSubTableEXT convertit les valeurs à virgule flottante directement en un format interne avec une précision non spécifiée. Les valeurs entières signées sont mappées de façon linéaire au format interne, de sorte que la valeur entière représentable la plus positive correspond à 1,0, et la valeur représentable la plus négative correspond à-1,0. Les données entières non signées sont mappées de la même façon : la plus grande valeur entière correspond à 1,0, et zéro est mappé à 0,0.
  2. La fonction glColorSubTableEXT multiplie les valeurs de couleur résultantes par GL_c_SCALE et les ajoute à GL_c_BIAS, où c est rouge, vert, bleu et alpha pour les composants de couleur respectifs. Les résultats sont ancrés à la plage [0, 1].
  3. Si GL_MAP_COLOR a la valeur true, glColorSubTableEXT met à l’échelle chaque composant de couleur en fonction de la taille de la table de recherche GL_PIXEL_MAP_c_TO_c, puis remplace le composant par la valeur qu’il référence dans cette table. c est R, G, B ou a, respectivement.
  4. La fonction glColorSubTableEXT convertit les couleurs RVBA obtenues en fragments en attachant la coordonnée zet la coordonnée de texture de la position raster actuelle à chaque pixel, puis en affectant les coordonnées de la fenêtre x et y au nième fragment, de telle sorte quex? = xr + n mod largeur
    y? = r + n/largeur o
    où (xr , yr ) est la position de la trame actuelle.
  5. Ces fragments de pixels sont ensuite traités comme les fragments générés par la pixellisation des points, des lignes ou des polygones. La fonction glColorSubTableEXT applique le mappage de texture, le brouillard et toutes les opérations de fragment avant d’écrire les fragments dans le trame.
GL_RED
Chaque pixel est un composant rouge unique.
La fonction glColorSubTableEXT convertit ce composant au format interne de la même façon que le composant rouge d’un pixel RVBA est, puis le convertit en pixel RVBA avec le vert et le bleu réglés sur 0,0 et alpha défini sur 1,0. Après cette conversion, le pixel est traité comme s’il avait été lu en tant que pixel RVBA.
GL_GREEN
Chaque pixel est un composant vert unique.
La fonction glColorSubTableEXT convertit ce composant au format interne de la même façon que le composant vert d’un pixel RVBA est, puis le convertit en pixel RVBA avec rouge et bleu défini sur 0,0, et alpha défini sur 1,0. Après cette conversion, le pixel est traité comme s’il avait été lu en tant que pixel RVBA.
GL_BLUE
Chaque pixel est un composant bleu unique.
La fonction glColorSubTableEXT convertit ce composant au format interne de la même façon que le composant bleu d’un pixel RVBA est, puis le convertit en pixel RVBA avec Red et Green défini sur 0,0, et alpha défini sur 1,0. Après cette conversion, le pixel est traité comme s’il avait été lu en tant que pixel RVBA.
GL_ALPHA
Chaque pixel est un composant alpha unique.
La fonction glColorSubTableEXT convertit ce composant au format interne de la même façon que le composant alpha d’un pixel RVBA est, puis le convertit en un pixel RVBA avec rouge, vert et bleu défini sur 0,0. Après cette conversion, le pixel est traité comme s’il avait été lu en tant que pixel RVBA.
GL_RGB
Chaque pixel est un groupe de trois composants dans cet ordre : rouge, vert, bleu.
La fonction glColorSubTableEXT convertit chaque composant au format interne de la même façon que les composants rouge, vert et bleu d’un pixel RVBA. La triple couleur est convertie en un pixel RVBA avec alpha défini sur 1,0. Après cette conversion, le pixel est traité comme s’il avait été lu en tant que pixel RVBA.
GL_BGR_EXT
Chaque pixel est un groupe de trois composants dans cet ordre : bleu, vert, rouge.
GL_BGR_EXT fournit un format qui correspond à la disposition de la mémoire des Windows des bitmaps indépendantes du périphérique (dib). par conséquent, vos applications peuvent utiliser les mêmes données avec les appels de fonction Windows et les appels de fonction de pixel OpenGL.
GL_BGRA_EXT
Chaque pixel est un groupe de quatre composants dans l’ordre suivant : bleu, vert, rouge, alpha.
GL_BGRA_EXT fournit un format qui correspond à la disposition de la mémoire des Windows des bitmaps indépendantes du périphérique (dib). par conséquent, vos applications peuvent utiliser les mêmes données avec les appels de fonction Windows et les appels de fonction de pixel OpenGL.

type

Type de données pour les données. Les constantes symboliques suivantes sont acceptées : _ octet non signé GL _ , _ octet GL, GL _ non signé _ short, GL _ short, GL _ unsigned _ int, GL _ int et GL _ float.

Le tableau suivant résume la signification des constantes valides pour le paramètre de type .

Valeur Signification
_octet non signé GL _
Entier 8 bits non signé
_octet GL
Entier 8 bits signé
NON signé dans le GL _ _
Entier 16 bits non signé
_abrégé GL
Entier 16 bits signé
_entier non signé GL _
Entier 32 bits non signé
GL _ int
Entier de 32 bits
valeur _ float du GL
Valeur à virgule flottante simple précision

data

Pointeur vers les données de texture de palette. Les données sont traitées comme des pixels uniques d’une entrée de palette de texture 1D pour une entrée de palette.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Codes d’erreur

Les codes d’erreur suivants peuvent être récupérés par la fonction glGetError .

Nom Signification
_valeur non valide du GL _
Start ou Count était un entier non valide.
_enum GL non valide _
la cible, le format ou le type n’était pas une valeur acceptée.
_valeur non valide du GL _
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

La fonction glColorSubTableEXT spécifie des parties de la palette de la texture ciblée actuelle à remplacer. Contrairement à glColorTableEXT, vous ne pouvez pas spécifier le paramètre target comme une palette de texture de proxy.

Notes

La fonction glColorSubTableEXT est une fonction d’extension qui ne fait pas partie de la bibliothèque OpenGL standard, mais qui fait partie de l' _ extension de texture de palette ext GL _ _ . Pour vérifier si votre implémentation d’OpenGL prend en charge glColorSubTableEXT, appelez glGetString( _ Extensions GL). Si elle retourne la _ _ texture de palette ext GL _ , glColorSubTableEXT est pris en charge. Pour obtenir l’adresse de fonction d’une fonction d’extension, appelez wglGetProcAddress.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel - [Applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server - [Applications de bureau uniquement]
En-tête
GL. h

Voir aussi

glBegin

glColorTableEXT

glEnd

glGetColorTableEXT

glGetColorTableParameterfvEXT

glGetColorTableParameterivEXT

glGetString

wglGetProcAddress