funzione glBindTexture
La funzione glBindTexture consente la creazione di una trama denominata associata a una destinazione di trama.
Sintassi
void WINAPI glBindTexture(
GLenum target,
GLuint texture
);
Parametri
-
target
-
Destinazione a cui è associata la trama. Deve avere il valore GL_TEXTURE_1D o GL_TEXTURE_2D.
-
Texture
-
Nome di una trama; il nome della trama non può essere attualmente in uso.
Valore restituito
Questa funzione non restituisce un valore.
Codici di errore
I codici di errore seguenti possono essere recuperati dalla funzione glGetError .
| Nome | Significato |
|---|---|
|
La destinazione del parametro non è un valore accettato. |
|
La trama del parametro non ha la stessa dimensionalità di target oppure la funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd. |
Commenti
La funzione glBindTexture consente di creare una trama denominata. Chiamando glBindTexture con target impostato su GL_TEXTURE_1D o GL_TEXTURE_2D e la trama impostata sul nome della nuova trama creata associa il nome della trama alla destinazione della trama appropriata. Quando una trama è associata a una destinazione, l'associazione precedente per tale destinazione non è più attiva.
I nomi delle trame sono numeri interi senza segno con il valore zero riservato per rappresentare la trama predefinita per ogni destinazione della trama. I nomi delle trame e il contenuto della trama corrispondente sono locali per lo spazio dell'elenco di visualizzazione condiviso del contesto di rendering OpenGL corrente; due contesti di rendering condividono nomi di trama solo se condividono anche elenchi di visualizzazione. È possibile generare un set di nuovi nomi di trama usando glGenTextures.
Quando una trama viene associata per la prima volta, presuppone la dimensionalità della destinazione della trama; una trama associata a GL_TEXTURE_1D diventa unidimensionale e una trama associata a GL_TEXTURE_2D diventa bidimensionale. Le operazioni eseguite su una destinazione trama influiscono anche su una trama associata alla destinazione. Quando si esegue una query su una destinazione di trama, il valore restituito è lo stato della trama associata. Le destinazioni della trama diventano alias per le trame attualmente associate.
Quando si associa una trama con glBindTexture, l'associazione rimane attiva fino a quando una trama diversa non viene associata alla stessa destinazione o si elimina la trama associata con la funzione glDeleteTextures . Dopo aver creato una trama denominata, è possibile associarla a una destinazione di trama con la stessa dimensionalità, come spesso necessario.
In genere è molto più veloce usare glBindTexture per associare una trama denominata esistente a una delle destinazioni di trama rispetto a quella di ricaricare l'immagine della trama usando glTexImage1D o glTexImage2D. Per un controllo aggiuntivo delle prestazioni di texturing, usare glPrioritizeTextures.
È possibile includere chiamate a glBindTexture negli elenchi di visualizzazione.
Nota
La funzione glBindTexture è disponibile solo in OpenGL versione 1.1 o successiva.
Le funzioni seguenti recuperano informazioni correlate a glBindTexture:
- glGet con argomento GL_TEXTURE_1D_BINDING
glGet con argomento GL_TEXTURE_2D_BINDING
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|