funzione glTexCoordPointer
La funzione glTexCoordPointer definisce una matrice di coordinate di trama.
Sintassi
void WINAPI glTexCoordPointer(
GLint size,
GLenum type,
GLsizei stride,
const GLvoid *pointer
);
Parametri
-
size
-
Numero di coordinate per ogni elemento della matrice. Il valore di size deve essere 1, 2, 3 o 4.
-
type
-
Tipo di dati di ogni coordinata di trama nella matrice usando le costanti simboliche seguenti: GL_SHORT, GL_INT, GL_FLOAT e GL_DOUBLE.
-
Passo
-
Offset di byte tra gli elementi di matrice consecutivi. Quando stride è zero, gli elementi della matrice sono strettamente compressi nella matrice.
-
indicatore di misura
-
Puntatore alla prima coordinata del primo elemento nella matrice.
Valore restituito
Questa funzione non restituisce un valore.
Codici di errore
I codici di errore seguenti possono essere recuperati dalla funzione glGetError .
| Nome | Significato |
|---|---|
|
il tipo non è un valore accettato. |
|
dimensioni non 1, 2, 3 o 4. |
|
stride era negativo. |
Commenti
La funzione glTexCoordPointer specifica la posizione e i dati di una matrice di coordinate di trama da usare durante il rendering. Il parametro size consente di specificare il numero di coordinate utilizzate per ogni elemento della matrice. Il parametro di tipo specifica il tipo di dati di ogni coordinata della trama. Il parametro stride determina l'offset di byte da un elemento matrice al successivo, consentendo la compressione di vertici e attributi in una singola matrice o archiviazione in matrici separate. In alcune implementazioni, l'archiviazione dei vertici e degli attributi in una singola matrice può essere più efficiente rispetto all'uso di matrici separate. Per altre informazioni, vedere glInterleavedArrays. Quando viene specificata una matrice di coordinate della trama, le dimensioni, il tipo, lo stride e il puntatore vengono salvati sullo stato lato client.
Quando si specifica la costante GL_TEXTURE_COORD_ARRAY con glEnableClientState, viene abilitata una matrice di coordinate della trama. Se abilitata, glDrawArrays, glDrawElements e glArrayElement usano la matrice di coordinate della trama. Per impostazione predefinita, la matrice di coordinate della trama è disabilitata.
Non è possibile includere glTexCoordPointer negli elenchi di visualizzazione.
Quando si specifica una matrice di coordinate della trama usando glTexCoordPointer, i valori di tutti i parametri della matrice di coordinate della funzione vengono salvati in uno stato lato client e gli elementi della matrice statica possono essere memorizzati nella cache. Poiché i parametri della matrice di coordinate della trama sono stati lato client, i relativi valori non vengono salvati o ripristinati da glPushAttrib e glPopAttrib.
Sebbene non venga generato alcun errore quando si chiama glTexCoordPointer all'interno di coppie glBegin e glEnd , i risultati non sono definiti.
Le funzioni seguenti recuperano informazioni correlate a glTexCoordPointer:
glIsEnabled con argomento GL_TEXTURE_COORD_ARRAY
glGet con argomento GL_TEXTURE_COORD_ARRAY_SIZE
glGet con argomento GL_TEXTURE_COORD_ARRAY_STRIDE
glGet con argomento GL_TEXTURE_COORD_ARRAY_COUNT
glGet con argomento GL_TEXTURE_COORD_ARRAY_TYPE
glGetPointerv con argomento GL_TEXTURE_COORD_ARRAY_POINTER
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|