Função glArrayElement

A função glArrayElement especifica os elementos de matriz usados para renderizar um vértice.

Sintaxe

void WINAPI glArrayElement(
   GLint index
);

Parâmetros

index

Um índice nas matrizes habilitadas.

Retornar valor

Essa função não retorna um valor.

Comentários

Use a função glArrayElement nos pares glBegin e glEnd para especificar dados de vértice e atributo para primitivos de ponto, linha e polígono. A função glArrayElement especifica os dados de um único vértice usando dados de vértice e atributo localizados no índice das matrizes de vértice habilitadas.

Você pode usar glArrayElement para construir primitivos indexando dados de vértice, em vez de transmitir por meio de matrizes de dados na ordem da primeira para a última. Como glArrayElement especifica apenas um único vértice, você pode especificar explicitamente atributos para primitivos individuais. Por exemplo, você pode definir um único normal para cada triângulo individual.

Quando você inclui chamadas para glArrayElement em listas de exibição, os dados de matriz necessários, determinados pelos ponteiros da matriz e os valores de habilitação, também são inseridos na lista de exibição. Os valores de ponteiro e habilitação da matriz são determinados quando as listas de exibição são criadas, não quando as listas de exibição são executadas.

Você pode ler e armazenar em cache dados de matriz estática a qualquer momento com glArrayElement. Quando você modifica os elementos de uma matriz estática sem especificar a matriz novamente, os resultados de quaisquer chamadas subsequentes para glArrayElement são indefinidos.

Quando você chama glArrayElement sem chamar glEnableClientState(GL_VERTEX_ARRAY), nenhum desenho ocorre, mas os atributos correspondentes às matrizes habilitadas são modificados. Embora nenhum erro seja gerado quando você especifica uma matriz nos pares glBegin e glEnd , os resultados são indefinidos.

Observação

A função glArrayElement só está disponível no OpenGL versão 1.1 ou posterior.

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

glBegin

glColorPointer

glDrawArrays

glEdgeFlagPointer

glEnableClientState

glEnd

glGetPointerv

glGetString

glIndexPointer

glNormalPointer

glTexCoordPointer

glVertexPointer