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 |
---|---|
|
type não era um valor aceito. |
|
o tamanho não era 1, 2, 3 ou 4. |
|
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 |
|
Biblioteca |
|
DLL |
|