Função glTexCoordPointer

A função glTexCoordPointer define uma matriz de coordenadas de textura.

Sintaxe

void WINAPI glTexCoordPointer(
         GLint   size,
         GLenum  type,
         GLsizei stride,
   const GLvoid  *pointer
);

Parâmetros

size

O número de coordenadas por elemento de matriz. O valor do tamanho deve ser 1, 2, 3 ou 4.

tipo

O tipo de dados de cada coordenada de textura na matriz usando as seguintes constantes simbólicas: GL_SHORT, GL_INT, GL_FLOAT e GL_DOUBLE.

Passo

O deslocamento de bytes entre elementos de matriz consecutivos. Quando o passo é zero, os elementos da matriz são bem empacotados na matriz.

pointer

Um ponteiro para a primeira coordenada do primeiro elemento na matriz.

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
GL_INVALID_ENUM	type não era um valor aceito.
GL_INVALID_VALUE	o tamanho não era 1, 2, 3 ou 4.
GL_INVALID_VALUE	passo foi negativo.

Comentários

A função glTexCoordPointer especifica o local e os dados de uma matriz de coordenadas de textura a serem usadas ao renderizar. O parâmetro size especifica o número de coordenadas usadas para cada elemento da matriz. O parâmetro type especifica o tipo de dados de cada coordenada de textura. O parâmetro stride determina o deslocamento de bytes de um elemento de matriz para o próximo, permitindo o empacotamento de vértices e atributos em uma única matriz ou armazenamento em matrizes separadas. Em algumas implementações, armazenar os vértices e atributos em uma única matriz pode ser mais eficiente do que usar matrizes separadas. Para obter mais informações, consulte glInterleavedArrays. Quando uma matriz de coordenadas de textura é especificada, o tamanho, o tipo, o passo e o ponteiro são salvos no estado do lado do cliente.

Uma matriz de coordenadas de textura é habilitada quando você especifica a constante GL_TEXTURE_COORD_ARRAY com glEnableClientState. Quando habilitados, glDrawArrays, glDrawElements e glArrayElement usam a matriz de coordenadas de textura. Por padrão, a matriz de coordenadas de textura está desabilitada.

Você não pode incluir glTexCoordPointer em listas de exibição.

Quando você especifica uma matriz de coordenadas de textura usando glTexCoordPointer, os valores de todos os parâmetros de matriz de coordenadas de textura da função são salvos em um estado do lado do cliente e elementos de matriz estáticos podem ser armazenados em cache. Como os parâmetros da matriz de coordenadas de textura são estado do lado do cliente, seus valores não são salvos ou restaurados por glPushAttrib e glPopAttrib.

Embora nenhum erro seja gerado quando você chama glTexCoordPointer em pares glBegin e glEnd , os resultados são indefinidos.

As seguintes funções recuperam informações relacionadas ao glTexCoordPointer:

glIsEnabled com GL_TEXTURE_COORD_ARRAY de argumento

glGet com GL_TEXTURE_COORD_ARRAY_SIZE de argumento

glGet com GL_TEXTURE_COORD_ARRAY_STRIDE de argumento

glGet com GL_TEXTURE_COORD_ARRAY_COUNT de argumento

glGet com GL_TEXTURE_COORD_ARRAY_TYPE de argumento

glGetPointerv com GL_TEXTURE_COORD_ARRAY_POINTER 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	Gl.h
Biblioteca	Opengl32.lib
DLL	Opengl32.dll

Confira também

glArrayElement

glColorPointer

glDrawArrays

glDrawElements

glEdgeFlagPointer

glEnable

glGetPointerv

glGetString

glIndexPointer

glIsEnabled

glNormalPointer

glPopClientAttrib

glPushClientAttrib

glTexCoord

glVertexPointer