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 : - 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.
- 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].
- 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.
- 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. - 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 |
|---|---|
|
Start ou Count était un entier non valide. |
|
la cible, le format ou le type n’était pas une valeur acceptée. |
|
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 |
|