Função glDrawArrays
A função glDrawArrays especifica vários primitivos a serem renderizados.
Sintaxe
void WINAPI glDrawArrays(
GLenum mode,
GLint first,
GLsizei count
);
Parâmetros
-
mode
-
O tipo de primitivos a serem renderizados. As seguintes constantes especificam tipos aceitáveis de primitivos: GL_POINTS, GL_LINE_STRIP, GL_LINE_LOOP, GL_LINES, GL_TRIANGLE_STRIP, GL_TRIANGLE_FAN, GL_TRIANGLES, GL_QUAD_STRIP, GL_QUADS e GL_POLYGON.
-
first
-
O índice inicial nas matrizes habilitadas.
-
contagem
-
O número de índices a serem renderizados.
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 |
|---|---|
|
count foi negativo. |
|
mode não era um valor aceito. |
|
A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd. |
Comentários
Com glDrawArrays, você pode especificar vários primitivos geométricos a serem renderizados. Em vez de chamar funções OpenGL separadas para passar cada vértice individual, normal ou cor, você pode especificar matrizes separadas de vértices, normais e cores para definir uma sequência de primitivos (todos do mesmo tipo) com uma única chamada para glDrawArrays.
Quando você chama glDrawArrays, os elementos sequenciais de contagem de cada matriz habilitada são usados para construir uma sequência de primitivos geométricos, começando com o primeiro elemento. O parâmetro mode especifica que tipo de primitivo construir e como usar os elementos de matriz para construir os primitivos.
Após o retorno de glDrawArrays , os valores de atributos de vértice modificados por glDrawArrays são indefinidos. Por exemplo, se GL_COLOR_ARRAY estiver habilitado, o valor da cor atual será indefinido após o retorno de glDrawArrays . Atributos não modificados por glDrawArrays permanecem definidos . Quando GL_VERTEX_ARRAY não está habilitado, nenhum primitivo geométrico é gerado, mas os atributos correspondentes às matrizes habilitadas são modificados.
Você pode incluir glDrawArrays em listas de exibição. Quando você inclui glDrawArrays em uma lista de exibição, os dados de matriz necessários, determinados pelos ponteiros da matriz e pelas habilitações, são gerados e inseridos na lista de exibição. Os valores de ponteiros e habilitações da matriz são determinados durante a criação de listas de exibição.
Você pode ler dados de matriz estática a qualquer momento. Se algum elemento de matriz estática for modificado e a matriz não for especificada novamente, os resultados de quaisquer chamadas subsequentes para glDrawArrays serão indefinidos.
Embora nenhum erro seja gerado quando você especifica uma matriz mais de uma vez dentro de pares glBegin e glend , os resultados são indefinidos.
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 |
|