Función glDrawElements

La función glDrawElements representa primitivos de los datos de matriz.

Sintaxis

void WINAPI glDrawElements(
         GLenum  mode,
         GLsizei count,
         GLenum  type,
   const GLvoid  *indices
);

Parámetros

mode

Tipo de primitivos que se van a representar. Puede asumir uno de los siguientes valores simbólicos: 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.

count

Número de elementos que se van a representar.

type

Tipo de los valores en índices. Debe ser uno de GL_UNSIGNED_BYTE, GL_UNSIGNED_SHORT o GL_UNSIGNED_INT.

índices

Puntero a la ubicación donde se almacenan los índices.

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_ENUM	mode no era un valor aceptado.
GL_INVALID_VALUE	count era un valor negativo.
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Observaciones

La función glDrawElements permite especificar varios primitivos geométricos con muy pocas llamadas de función. En lugar de llamar a una función OpenGL para pasar cada vértice individual, normal o color, puede especificar matrices independientes de vértices, normales y colores de antemano y usarlas para definir una secuencia de primitivos (todo el mismo tipo) con una sola llamada a glDrawElements.

Cuando se llama a la función glDrawElements , se usan elementos secuenciales de recuento de índices para construir una secuencia de primitivos geométricos. El parámetro mode especifica qué tipo de primitivos se construyen y cómo se usan los elementos de matriz para construir estos primitivos. Si GL_VERTEX_ARRAY no está habilitado, no se generan primitivos geométricos.

Los atributos de vértice modificados por glDrawElements tienen un valor no especificado después de que glDrawElements devuelva. Por ejemplo, si GL_COLOR_ARRAY está habilitado, el valor del color actual no está definido después de que se ejecute glDrawElements . Los atributos que no se modifican permanecen sin cambios.

Puede incluir la función glDrawElements en las listas de visualización. Cuando glDrawElements se incluye en una lista de visualización, los datos de matriz necesarios (determinados por los punteros de matriz y los habilita) también se introducen en la lista de visualización. Dado que los punteros de matriz y los habilita son variables de estado del lado cliente, sus valores afectan a las listas de visualización cuando se crean las listas, no cuando se ejecutan las listas.

Nota

La función glDrawElements solo está disponible en OpenGL versión 1.1 o posterior.

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

glDrawArrays

glEdgeFlagPointer

glEnd

glGetPointerv

glIndexPointer

glNormalPointer

glTexCoordPointer

glVertexPointer