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 |
|---|---|
|
count fue negativo. |
|
mode no era un valor aceptado. |
|
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 |
|
| Biblioteca |
|
| Archivo DLL |
|