Función glDrawArrays

La función glDrawArrays especifica varios primitivos que se van a representar.

Sintaxis

void WINAPI glDrawArrays(
   GLenum  mode,
   GLint   first,
   GLsizei count
);

Parámetros

mode

Tipo de primitivos que se van a representar. Las siguientes constantes especifican tipos aceptables 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 y GL_POLYGON.

first

Índice inicial de las matrices habilitadas.

count

Número de índices que se van a representar.

Valor devuelto

Esta función no devuelve ningún valor.

Códigos de error

La función glGetError puede recuperar los siguientes códigos de error.

Nombre	Significado
GL_INVALID_VALUE	count fue negativo.
GL_INVALID_ENUM	mode no era un valor aceptado.
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Observaciones

Con glDrawArrays, puede especificar varios primitivos geométricos que se van a representar. En lugar de llamar a funciones OpenGL independientes para pasar cada vértice individual, normal o color, puede especificar matrices independientes de vértices, normales y colores para definir una secuencia de primitivos (todo el mismo tipo) con una sola llamada a glDrawArrays.

Cuando se llama a glDrawArrays, se usan elementos secuenciales de recuento de cada matriz habilitada para construir una secuencia de primitivos geométricos, empezando por el primer elemento. El parámetro mode especifica qué tipo de primitivo construir y cómo usar los elementos de matriz para construir los primitivos.

Después de que glDrawArrays devuelva, los valores de los atributos de vértice modificados por glDrawArrays no están definidos. Por ejemplo, si GL_COLOR_ARRAY está habilitado, el valor del color actual no está definido después de que glDrawArrays devuelva. Los atributos no modificados por glDrawArrays permanecen definidos. Cuando GL_VERTEX_ARRAY no está habilitado, no se generan primitivos geométricos, pero se modifican los atributos correspondientes a las matrices habilitadas.

Puede incluir glDrawArrays en listas para mostrar. Cuando se incluye glDrawArrays en una lista para mostrar, los datos de matriz necesarios, determinados por los punteros de matriz y los habilitadores, se generan y escriben en la lista de visualización. Los valores de punteros de matriz y habilita se determinan durante la creación de listas de visualización.

Puede leer datos de matriz estática en cualquier momento. Si se modifican elementos de matriz estáticos y no se vuelve a especificar la matriz, los resultados de las llamadas posteriores a glDrawArrays no están definidos.

Aunque no se genera ningún error al especificar una matriz más de una vez dentro de pares glBegin y glend , los resultados no están definidos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Vea también

glArrayElement

glBegin

glColorPointer

glEdgeFlagPointer

glEnd

glGetPointerv

glGetString

glIndexPointer

glNormalPointer

glTexCoordPointer

glVertexPointer