Função glBindTexture
A função glBindTexture permite a criação de uma textura nomeada associada a um destino de textura.
Sintaxe
void WINAPI glBindTexture(
GLenum target,
GLuint texture
);
Parâmetros
-
destino
-
O destino ao qual a textura está associada. Deve ter o valor GL_TEXTURE_1D ou GL_TEXTURE_2D.
-
Textura
-
O nome de uma textura; O nome da textura não pode estar em uso no momento.
Retornar valor
Essa função não retorna um valor.
Códigos de erro
Os códigos de erro a seguir podem ser recuperados pela função glGetError .
| Nome | Significado |
|---|---|
|
O destino do parâmetro não era um valor aceito. |
|
A textura do parâmetro não tinha a mesma dimensionalidade que o destino ou a função era chamada entre uma chamada para glBegin e a chamada correspondente para glEnd. |
Comentários
A função glBindTexture permite que você crie uma textura nomeada. Chamar glBindTexture com destino definido como GL_TEXTURE_1D ou GL_TEXTURE_2D, e a textura definida como o nome da nova textura que você criou associa o nome da textura ao destino de textura apropriado. Quando uma textura é associada a um destino, a associação anterior para esse destino não está mais em vigor.
Os nomes de textura são inteiros sem sinal com o valor zero reservado para representar a textura padrão para cada destino de textura. Os nomes de textura e o conteúdo de textura correspondente são locais para o espaço de lista de exibição compartilhado do contexto de renderização OpenGL atual; dois contextos de renderização compartilham nomes de textura somente se também compartilharem listas de exibição. Você pode gerar um conjunto de novos nomes de textura usando glGenTextures.
Quando uma textura é associada pela primeira vez, ela pressupõe a dimensionalidade de seu destino de textura; uma textura associada a GL_TEXTURE_1D torna-se unidimensional e uma textura associada a GL_TEXTURE_2D torna-se bidimensional. As operações executadas em um destino de textura também afetam uma textura associada ao destino. Quando você consulta um destino de textura, o valor retornado é o estado da textura associada a ele. Os destinos de textura se tornam aliases para texturas atualmente associadas a elas.
Quando você associa uma textura com glBindTexture, a associação permanece ativa até que uma textura diferente seja associada ao mesmo destino ou você exclua a textura associada com a função glDeleteTextures . Depois de criar uma textura nomeada, você poderá associá-la a um destino de textura que tenha a mesma dimensionalidade com a mesma frequência necessária.
Geralmente, é muito mais rápido usar glBindTexture para associar uma textura nomeada existente a um dos destinos de textura do que recarregar a imagem de textura usando glTexImage1D ou glTexImage2D. Para obter controle adicional de desempenho de texturização, use glPrioritizeTextures.
Você pode incluir chamadas para glBindTexture em listas de exibição.
Observação
A função glBindTexture só está disponível no OpenGL versão 1.1 ou posterior.
As seguintes funções recuperam informações relacionadas ao glBindTexture:
- glGet com GL_TEXTURE_1D_BINDING de argumento
glGet com GL_TEXTURE_2D_BINDING de argumento
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|