glBindTexture fonction)
La fonction glBindTexture permet la création d’une texture nommée qui est liée à une cible de texture.
Syntaxe
void WINAPI glBindTexture(
GLenum target,
GLuint texture
);
Paramètres
-
cible
-
Cible à laquelle la texture est liée. Doit avoir la texture GL _ valeur _ 1D ou la _ texture GL _ 2D.
-
motif
-
Nom d’une texture ; le nom de la texture ne peut pas être actuellement utilisé.
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 .
| Name | Signification |
|---|---|
|
La cible du paramètre n’est pas une valeur acceptée. |
|
La texture de paramètre n’a pas la même dimensionnalité que la cible, ou la fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd. |
Remarques
La fonction glBindTexture vous permet de créer une texture nommée. L’appel de glBindTexture avec target défini sur la texture GL _ _ 1J ou GL _ texture _ 2D, et texture définie sur le nom de la nouvelle texture que vous avez créée lie le nom de la texture à la cible de texture appropriée. Quand une texture est liée à une cible, la liaison précédente pour cette cible n’est plus appliquée.
Les noms de texture sont des entiers non signés dont la valeur zéro est réservée pour représenter la texture par défaut de chaque cible de texture. Les noms de texture et le contenu de texture correspondant sont locaux à l’espace de liste d’affichage partagé du contexte de rendu OpenGL actuel ; deux contextes de rendu partagent des noms de texture uniquement s’ils partagent également des listes d’affichage. Vous pouvez générer un ensemble de nouveaux noms de texture à l’aide de glGenTextures.
Lorsqu’une texture est liée pour la première fois, elle suppose la dimensionnalité de sa cible de texture ; une texture liée à une _ texture GL _ 1D devient unidimensionnelle et une texture liée à la _ texture GL _ 2D devient à deux dimensions. Les opérations que vous effectuez sur une cible de texture affectent également une texture liée à la cible. Lorsque vous interrogez une cible de texture, la valeur de retour est l’état de la texture qui lui est liée. Les cibles de texture deviennent des alias des textures actuellement liées.
Lorsque vous liez une texture à glBindTexture, la liaison reste active jusqu’à ce qu’une texture différente soit liée à la même cible ou que vous supprimiez la texture liée avec la fonction glDeleteTextures . Une fois que vous avez créé une texture nommée, vous pouvez la lier à une cible de texture qui a la même dimensionnalité que le plus souvent nécessaire.
Il est généralement beaucoup plus rapide d’utiliser glBindTexture pour lier une texture nommée existante à l’une des cibles de texture que de recharger l’image de texture à l’aide de glTexImage1D ou glTexImage2D. Pour contrôler davantage les performances de la texturation, utilisez glPrioritizeTextures.
Vous pouvez inclure des appels à glBindTexture dans des listes d’affichage.
Notes
La fonction glBindTexture est disponible uniquement dans OpenGL version 1,1 ou ultérieure.
Les fonctions suivantes récupèrent les informations relatives à glBindTexture:
- glGet avec l’argument _ Binding GL texture _ 1D _
glGet avec argument GL _ texture _ 2D _ liaison
Configuration requise
| 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 |
|
| Bibliothèque |
|
| DLL |
|