Documentation de Gambas - /comp/gb.opengl/gl/bindtexture

/comp/gb.opengl/gl/bindtexture

# Gl.BindTexture (gb.opengl)

Static Sub BindTexture ( Target As Integer, Texture As Integer )

Attache la texture nommée à une texture cible

### Paramètres

target

  Spécifie la cible à laquelle la texture est attachée. Doit être Gl.TEXTURE_1D, Gl.TEXTURE_2D, Gl.TEXTURE_3D, ou Gl.TEXTURE_1D_ARRAY, Gl.TEXTURE_2D_ARRAY, Gl.TEXTURE_RECTANGLE, Gl.TEXTURE_CUBE_MAP, Gl.TEXTURE_2D_MULTISAMPLE ou Gl.TEXTURE_2D_MULTISAMPLE_ARRAY..

texture

  Spécifie le nom de la texture.

### Description

Gl.BindTexture vous permet de créer et d’utiliser une texture nommée. L’appel à Gl.BindTexture avec target défini à Gl.TEXTURE_1D, Gl.TEXTURE_2D, Gl.TEXTURE_3D, ou Gl.TEXTURE_1D_ARRAY, Gl.TEXTURE_2D_ARRAY, Gl.TEXTURE_RECTANGLE, Gl.TEXTURE_CUBE_MAP, Gl.TEXTURE_2D_MULTISAMPLE or Gl.TEXTURE_2D_MULTISAMPLE_ARRAY et texture défini avec le nom d’une nouvelle texture attache la texture nommée à une texture cible. Quand une texture est attachée à une cible, le lien précédent de cette cible est automatiquement rompu.

Les noms de texture sont des constantes non signées. La valeur 0 est réservée pour représenter la texture par défaut pour chaque texture cible. Les noms de texture et le contenu des textures correspondantes sont des variables locales de l’espace objet du contexte de rendu GL courant ; deux contextes de rendu ne partagent les noms de texture que si le partage a été explicitement activé via les fonctions appropriées des interfaces de fenêtres GL.

Vous devez utiliser Gl.GenTextures pour générer un jeu de noms de nouvelles textures.

Quand une texture est attachée pour la première fois, elle présuppose les cibles spécifiées : une texture liée la première fois à Gl.GL_TEXTURE_1D devient mono dimensionnelle, une texture liée la première fois à Gl.GL_TEXTURE_2D devient bidimensionnelle, une texture liée la première fois à Gl.TEXTURE_3D devient tridimensionnelle, une texture liée la première fois à Gl.TEXTURE_1D_ARRAY devient mono dimensionnelle, une texture liée la première fois à Gl.TEXTURE_2D_ARRAY devient bidimensionnelle, une texture liée la première fois à Gl.TEXTURE_ RECTANGLE devient une texture rectangle, une texture liée la première fois à Gl.TEXTURE_CUBE_MAP devient une texture projetée sur un cube, une texture liée la première fois à Gl.TEXTURE_2D_MULTISAMPLE devient un tableau d’échantillons de textures bidimensionnelle. L’état d’une texture mono dimensionnelle immédiatement après son premier attachement est équivalent à l’état de la texture par défaut Gl.GL_TEXTURE_1D lors de l’initialisation de GL, et de manière similaire pour les autres types de textures.

Quand une texture est attachée, les opérations GL sur la cible à laquelle elle est liée affectent la texture liée, et les requêtes de la cible à laquelle elle est liée renvoient l’état de la texture liée. En effet, les textures cibles deviennent des alias pour les textures qui leur sont actuellement liées, et le nom de texture zéro fait référence aux textures par défaut qui leur ont été liées lors de l’initialisation.

Un attachement de texture créé avec Gl.BindTexture reste actif jusqu’a ce qu’une texture différente soit attachée à la même cible, ou jusqu’à ce que la texture attachée soit effacée par Gl.DeleteTextures.

Une fois créée, une texture nommée peut être reliée à nouveau à la même cible d’origine autant de fois que nécessaire. Il est habituellement plus rapide d’utiliser Gl.BindTexture pour lier une texture nommée existante à l’une des textures cibles que de recharger cette image de texture en utilisant Gl.TexImage1D, Gl.TexImage2D, Gl.TexImage3D ou toute autre fonction similaire.

### Notes

Les cibles Gl.TEXTURE_2D_MULTISAMPLE et Gl.TEXTURE_2D_MULTISAMPLE_ARRAY ne sont disponibles qu’à partir de la version GL 3.2.

### Erreurs

Gl.GL_INVALID_ENUM est générée si target n’est pas l’une des valeurs allouables.

Gl.INVALID_VALUE est générée si target n’est pas un nom retourné par un appel précédent à Gl.GenTextures.

Gl.GL_INVALID_OPERATION est générée si texture a été précédemment créé avec une cible qui ne concorde pas avec de target.

### Gets Associés

Gl.Get avec l'argument Gl.TEXTURE_BINDING_1D, Gl.TEXTURE_BINDING_2D, Gl.TEXTURE_BINDING_3D, Gl.TEXTURE_BINDING_1D_ARRAY, Gl.TEXTURE_BINDING_2D_ARRAY, Gl.TEXTURE_BINDING_RECTANGLE, Gl.TEXTURE_BINDING_2D_MULTISAMPLE, ou Gl.TEXTURE_BINDING_2D_MULTISAMPLE_ARRAY.

### Voir aussi

Gl.DeleteTextures, Gl.GenTextures, Gl.Get, Gl.GetTexParameter, Gl.IsTexture, Gl.TexImage1D, Gl.TexImage2D, Gl.TexImage2DMultisample, Gl.TexImage3D, Gl.TexImage3DMultisample, Gl.TexParameter

Copyright © 1991-2006 Silicon Graphics, Inc. Ce document est sous licence SGI Free Software B License. Pour tout detail, voir http://oss.sgi.com/projects/FreeB.

➡ Voir documentation originale