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 |
|---|---|
|
El destino del parámetro no era un valor aceptado. |
|
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 |
|
| Biblioteca |
|
| Archivo DLL |
|