glCopyTexImage2D fonction)

La fonction glCopyTexImage2D copie les pixels du trame dans une image de texture à deux dimensions.

Syntaxe

void WINAPI glCopyTexImage2D(
   GLenum  target,
   GLint   level,
   GLenum  internalFormat,
   GLint   x,
   GLint   y,
   GLsizei width,
   GLsizei height,
   GLint   border
);

Paramètres

cible

Cible dans laquelle les données de l’image seront modifiées. Doit avoir la texture GL de valeur _ _ 2D.

level

Numéro de niveau de détail. Le niveau 0 est l’image de base. Le niveau n est la n ième image de réduction mipmap.

internalFormat

Format interne et résolution des données de texture. Les valeurs 1, 2, 3 et 4 ne sont pas acceptées pour internalFormat. Le paramètre peut prendre l’une des valeurs symboliques suivantes.

Constante Bits R Bits G Bits B Un bits L bits I bits
GL _ alpha
_Alpha4 GL 4
_ALPHA8 GL 8
_ALPHA12 GL 12
_ALPHA16 GL 16
LUMINANCE du GL _
_LUMINANCE4 GL 4
_LUMINANCE8 GL 8
_LUMINANCE12 GL 12
_LUMINANCE16 GL 16
_luminance _ alpha du GL
GL _ LUMINANCE4 _ alpha4 4 4
GL _ LUMINANCE6 _ alpha2 2 6
GL _ LUMINANCE8 _ ALPHA8 8 8
GL _ LUMINANCE12 _ alpha4 4 12
GL _ LUMINANCE12 _ ALPHA12 12 12
GL _ LUMINANCE16 _ ALPHA16 16 16
intensité du GL _
_INTENSITY4 GL 4
_INTENSITY8 GL 8
_INTENSITY12 GL 12
_INTENSITY16 GL 16
_RGB GL
GL _ R3 _ G3 _ a2 3 3 2
_RGB4 GL 4 4 4
_RGB5 GL 5 5 5
_RGB8 GL 8 8 8
_RGB10 GL 10 10 10
_RGB12 GL 12 12 12
_RGB16 GL 16 16 16
GL _ RVBA
_RGBA2 GL 2 2 2 2
_RGBA4 GL 4 4 4 4
GL _ RGB5 _ a1 5 5 5 1
_RGBA8 GL 8 8 8 8
GL _ RGB10 _ a2 10 10 10 2
_RGBA12 GL 12 12 12 12
_RGBA16 GL 16 16 16 16

x

Coordonnée du plan x de la fenêtre du coin inférieur gauche de la zone rectangulaire de pixels à copier.

y

Coordonnée du plan y de la fenêtre du coin inférieur gauche de la zone rectangulaire de pixels à copier.

width

Largeur de l’image de texture. Doit être * de 2 x 2 pour un entier n.

height

Hauteur de l’image de texture. Doit être * de 2 x 2 pour un entier n.

2S

Largeur de la bordure. Doit être égal à zéro ou égal à 1.

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
_enum GL non valide _
la cible n’est pas une valeur acceptée.
_valeur non valide du GL _
le niveau était inférieur à zéro ou supérieur à log2 Max, où Max est la valeur retournée de la _ taille de texture max GL _ _ .
_valeur non valide du GL _
la bordure n’était pas égale à zéro ou 1.
_valeur non valide du GL _
la largeur était inférieure à zéro, supérieure à 2 + _ taille maximale de la texture GL _ _ , ou la largeur ne peut pas être représentée sous la forme 2n + 2 * pour un entier n.
_opération non valide du GL _
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

La fonction glCopyTexImage2D définit une image de texture à deux dimensions à l’aide de pixels du trame actuel, plutôt qu’à partir de la mémoire principale comme c’est le cas pour glTexImage2D.

À l’aide du niveau de mipmap spécifié avec Level, les tableaux de texture sont définis comme un rectangle de pixels avec l’angle inférieur gauche situé aux coordonnées x et y, largeur égale à la largeur + (2 * bordure) et une hauteur égale à hauteur + (2 * bordure). Le format interne du tableau de texture est spécifié avec le paramètre internalFormat .

La fonction glCopyTexImage2D traite les pixels d’une ligne de la même façon que glCopyPixels , sauf qu’avant la conversion finale des pixels, toutes les valeurs de composant de pixel sont ancrées à la plage [ 0, 1 ] et converties au format interne de la texture pour le stockage dans le tableau de texture. L’ordonnancement des pixels est déterminé par des coordonnées x et y inférieures correspondant à des coordonnées de texture s et t inférieures. Si l’un des pixels dans une ligne spécifiée du trame actuel est en dehors de la fenêtre associée au contexte de rendu actuel, ses valeurs ne sont pas définies.

Vous ne pouvez pas inclure d’appels à glCopyTexImage2D dans des listes d’affichage.

Notes

La fonction glCopyTexImage2D est disponible uniquement dans OpenGL version 1,1 ou ultérieure.

La texturation n’a aucun effet dans le mode d’index des couleurs. Les fonctions glPixelStore et glPixelTransfer affectent les images de texture exactement de la même façon qu’elles affectent glDrawPixels.

La fonction suivante récupère des informations relatives à glCopyTexImage2D:

glIsEnabled avec argument GL _ texture _ 2D

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
Bibliothèque
Opengl32. lib
DLL
Opengl32.dll

Voir aussi

glBegin

glCopyTexImage1D

glDrawPixels

glEnd

glFog

glPixelStore

glPixelTransfer

glTexEnv

glTexGen

glTexImage1D

glTexImage2D

glTexParameter