Función glBindTexture

La función glBindTexture permite crear una textura con nombre enlazada a un destino de textura.

Sintaxis

void WINAPI glBindTexture(
   GLenum target,
   GLuint texture
);

Parámetros

Destino

Destino al que está enlazada la textura. Debe tener el valor GL_TEXTURE_1D o GL_TEXTURE_2D.

Textura

Nombre de una textura; el nombre de textura no puede estar actualmente en uso.

Valor devuelto

Esta función no devuelve ningún valor.

Códigos de error

La función glGetError puede recuperar los siguientes códigos de error.

Nombre	Significado
GL_INVALID_ENUM	El destino del parámetro no era un valor aceptado.
GL_INVALID_OPERATION	La textura del parámetro no tenía la misma dimensionalidad que el destino, o se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Comentarios

La función glBindTexture permite crear una textura con nombre. Al llamar a glBindTexture con el destino establecido en GL_TEXTURE_1D o GL_TEXTURE_2D, y la textura establecida en el nombre de la nueva textura que ha creado enlaza el nombre de textura al destino de textura adecuado. Cuando una textura está enlazada a un destino, el enlace anterior para ese destino ya no está en vigor.

Los nombres de textura son enteros sin signo con el valor cero reservado para representar la textura predeterminada para cada destino de textura. Los nombres de textura y el contenido de textura correspondiente son locales para el espacio de lista de presentación compartido del contexto de representación de OpenGL actual; dos contextos de representación comparten nombres de textura solo si también comparten listas para mostrar. Puede generar un conjunto de nombres de textura nuevos mediante glGenTextures.

Cuando una textura está enlazada por primera vez, asume la dimensionalidad de su destino de textura; una textura enlazada a GL_TEXTURE_1D se convierte en unidimensional y una textura enlazada a GL_TEXTURE_2D se convierte en bidimensional. Las operaciones que se realizan en un destino de textura también afectan a una textura enlazada al destino. Cuando se consulta un destino de textura, el valor devuelto es el estado de la textura enlazada a él. Los destinos de textura se convierten en alias para las texturas enlazadas actualmente a ellas.

Al enlazar una textura con glBindTexture, el enlace permanece activo hasta que se enlaza una textura diferente al mismo destino o se elimina la textura enlazada con la función glDeleteTextures . Una vez creada una textura con nombre, puede enlazarla a un destino de textura que tenga la misma dimensionalidad con la misma frecuencia que sea necesario.

Normalmente es mucho más rápido usar glBindTexture para enlazar una textura con nombre existente a uno de los destinos de textura que es volver a cargar la imagen de textura mediante glTexImage1D o glTexImage2D. Para un control adicional del rendimiento de la texturización, use glPrioritizeTextures.

Puede incluir llamadas a glBindTexture en listas para mostrar.

Nota

La función glBindTexture solo está disponible en openGL versión 1.1 o posterior.

Las siguientes funciones recuperan información relacionada con glBindTexture:

• glGet con GL_TEXTURE_1D_BINDING de argumentos

glGet con GL_TEXTURE_2D_BINDING de argumentos

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glAreTexturesResident

glDeleteTextures

glGenTextures

glGet

glGetTexParameter

glIsTexture

glPrioritizeTextures

glTexImage1D

glTexImage2D

glTexParameter