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
GL_INVALID_ENUM	il tipo non è un valore accettato.
GL_INVALID_VALUE	dimensioni non 1, 2, 3 o 4.
GL_INVALID_VALUE	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	Gl.h
Libreria	Opengl32.lib
DLL	Opengl32.dll

Vedi anche

glArrayElement

glColorPointer

glDrawArrays

glDrawElements

glEdgeFlagPointer

glEnable

glGetPointerv

glGetString

glIndexPointer

glIsEnabled

glNormalPointer

glPopClientAttrib

glPushClientAttrib

glTexCoord

glVertexPointer