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
_enum GL non valide _
La cible du paramètre n’est pas une valeur acceptée.
_opération non valide du GL _
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
GL. h
Bibliothèque
Opengl32. lib
DLL
Opengl32.dll

Voir aussi

glAreTexturesResident

glDeleteTextures

glGenTextures

glGet

glGetTexParameter

glIsTexture

glPrioritizeTextures

glTexImage1D

glTexImage2D

glTexParameter